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

投标构造和模板制作

本页介绍如何根据您的模板 MediaTailor 构建 OpenRTB 出价请求、变量插值的工作原理以及自动设置的值。 MediaTailor

配置字段

当您在播放配置上启用产量优化时，需要提供四个字段：

出价请求是如何构造的

当广告插播时段剩余时间未填充时，按以下步骤 MediaTailor 构造出价请求：

控制台默认模板

当您在 MediaTailor 控制台中启用收益优化时，将提供以下预先填写的模板作为起点。你应该为你的应用程序自定义值：

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field 解释：

模板插值（胡子模板）

您的 ORTB 模板使用 Mustache 模板语法进行动态值替换。占位符使用双大括号。{{ }}

可用的模板变量

您的 ORTB 模板可以使用与 ADS 网址模板中相同的动态变量。其中包括会话变量（例如，，{{session.client_ip}}）{{session.user_agent}}、玩家参数（{{player_params.*}}）、资产元数据（{{asset.*}}）、可用上下文（{{avail.*}}）和 SCTE 信号数据（{{scte.*}}）。

有关可用变量的完整列表及其描述，请参见MediaTailor ADS 请求的动态广告变量。有关在将 MediaTailor URL-decodes玩家参数替换到模板之前的值，请参阅本页编码和解码行为后面的内容。

ORTB 模板中最常用的变量是：

如何传递玩家参数

在会话初始化期间，有两种方法可以传递玩家参数。

方法 1：带有 JSON 正文的 POST 请求（推荐）

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

这种方法是首选，因为它避免了用户代理字符串等复杂值 URL-encoding 的问题。

方法 2：网址查询参数

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

使用此方法，值必须为 URL-encoded。 MediaTailor URL-decodes 它们在插值之前。

编码和解码行为

MediaTailor 在将玩家参数值插入模板之前，对它们执行一级 URL 解码。无论如何传递参数（POST 正文或 URL 查询参数），这都适用。

解码值的示例：

要点：

变量丢失时会发生什么

如果玩家未发送模板中引用的参数（例如，{{player_params.app_name}}但玩家参数app_name中没有发送参数），则占位符将解析为空字符串。 ""

影响：如果空字符串位于必填字段（例如app.bundle）中，则出价请求将失败BidRequestConfigurationError。如果它位于可选字段中，APS 会收到一个空值，这可能会导致无出价 (HTTP 204) 响应。

什么会自动 MediaTailor 设置

以下字段始终 MediaTailor 使用您的控制台配置和当前 Avail上下文中的值来设置。如果您在模板中包含这些值，则您的值将被覆盖：

后续步骤