本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 收益优化快速入门指南
<a name="yield-optimization-quickstart"></a>

本指南引导您在播放配置上启用收益优化并验证其是否有效。

**目标：**在本指南结束时，您将拥有一个播放配置，该配置会自动使用来自APS的程序化广告填充未填充的广告清单。

## 先决条件
<a name="yield-optimization-quickstart-prereqs"></a>
+ 带有直播内容源的现有 MediaTailor 播放配置。
+ APS 发布商 ID。[与 APS 集成](yield-optimization-integrating-aps.md)看看你有没有一个。

## 第 1 步：在控制台中启用收益优化
<a name="yield-optimization-quickstart-step1"></a>

1. 打开 [MediaTailor 控制台](https://console.aws.amazon.com/mediatailor/home)。

1. 在左侧导航窗格中，选择**配置**。

1. 选择要更新的播放配置。

1. 选择**编辑**。

1. 展开 “**收益优化设置” ** 部分（启动时标有**新**徽章）。该部分的描述写道：“配置收益优化设置，包括发布商 ID、广告时长限制和区域定位。”

1. 将 “启用” 下拉列表设置为 “**启用**”。

1. 填写以下字段：
   + **APS 发布商 ID**：与您的发布商账户关联的 APS 发布商 ID（例如，`8caf35b3-402b-4d75-bab2-f2aef63a66d3`）。[与 APS 集成](yield-optimization-integrating-aps.md)有关如何获得此信息，请参见。
   + **最短未填充持续时间**：收益优化尝试填补的最小未填充持续时间（以秒为单位）。将此设置为 ** 15 ** 或更高。低于 15 秒的值不会返回广告，因为 APS 广告素材通常为 15 秒或更长。
   + **亚马逊广告区域**：将出价请求发送到的亚马逊广告区域。`Asia Pacific`根据您的主要受众选择`Americas``Europe`、或之一。这映射到 `YieldOptimizationConfiguration` API 模型中的`Region`字段，区域名称对应于中描述的 APS 区域[与 APS 集成](yield-optimization-integrating-aps.md)。
   + **OpenRTB 模板配置**：您的 JSON 模板。[示例 模板](yield-optimization-examples.md)有关起点，请参见。控制台验证 JSON 语法并内联显示错误和警告。默认模板预先填充控制台的入门模板。请参阅[投标构造和模板制作](yield-optimization-bid-construction.md)。

1. 选择**保存**。

## 第 2 步：配置 OpenRTB 模板
<a name="yield-optimization-quickstart-step2"></a>

该控制台为 OpenRTB 模板提供了一个 JSON 编辑器。您的模板至少必须包括：

```
{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}
```

如果缺少必填字段，控制台将警告您。

## 步骤 3：启动会话并验证
<a name="yield-optimization-quickstart-step3"></a>

1. 启动包含您的播放器参数（用户代理、IP 地址等）的播放会话。

1. 等待时长未填充的广告插播时间。

1. 检查`YieldOptimization.BidRequest`和的 CloudWatch 指标`YieldOptimization.AdsInserted`。

如果`BidRequest`正在发出但`AdsInserted`为 0，请检查中的`RAW_BID_REQUEST`事件`ads_interaction_log`以验证您的模板正在生成有效的出价请求。

## 第 2 步（备选）：使用 API 进行配置
<a name="yield-optimization-quickstart-step2-api"></a>

使用带有`YieldOptimizationConfiguration`参数`PutPlaybackConfiguration`的 API：

```
aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'
```

## 后续步骤
<a name="yield-optimization-quickstart-next-steps"></a>
+ 要在 APS 注册并获取您的发布商 ID，请参阅[与 APS 集成](yield-optimization-integrating-aps.md)。
+ 要了解如何 MediaTailor 决定何时提出出价请求，请参阅[收益优化的工作原理](yield-optimization-how-it-works.md)。
+ 要查看完整的模板示例，请参阅[示例 模板](yield-optimization-examples.md)。