View a markdown version of this page

收益优化快速入门指南 - AWS Elemental MediaTailor
先决条件第 1 步：在控制台中启用收益优化第 2 步：配置 OpenRTB 模板步骤 3：启动会话并验证第 2 步（备选）：使用 API 进行配置后续步骤

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

收益优化快速入门指南

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

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

先决条件

  • 带有直播内容源的现有 MediaTailor 播放配置。

  • APS 发布商 ID。与 APS 集成看看你有没有一个。

第 1 步：在控制台中启用收益优化

  1. 打开 MediaTailor 控制台。

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

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

  4. 选择编辑。

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

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

  7. 填写以下字段：

    • APS 发布商 ID：与您的发布商账户关联的 APS 发布商 ID（例如，8caf35b3-402b-4d75-bab2-f2aef63a66d3）。与 APS 集成有关如何获得此信息，请参见。

    • 最短未填充持续时间：收益优化尝试填补的最小未填充持续时间（以秒为单位）。将此设置为 15 或更高。低于 15 秒的值不会返回广告，因为 APS 广告素材通常为 15 秒或更长。

    • 亚马逊广告区域：将出价请求发送到的亚马逊广告区域。Asia Pacific根据您的主要受众选择AmericasEurope、或之一。这映射到 YieldOptimizationConfiguration API 模型中的Region字段，区域名称对应于中描述的 APS 区域与 APS 集成。

    • OpenRTB 模板配置：您的 JSON 模板。示例 模板有关起点，请参见。控制台验证 JSON 语法并内联显示错误和警告。默认模板预先填充控制台的入门模板。请参阅投标构造和模板制作。

  8. 选择保存。

第 2 步：配置 OpenRTB 模板

该控制台为 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：启动会话并验证

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

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

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

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

第 2 步（备选）：使用 API 进行配置

使用带有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}]}"
  }'

后续步骤