在中使用动态广告变量 AWS Elemental MediaTailor

对广告决策服务器 (ADS) 的 AWS Elemental MediaTailor 请求包含了有关当前查看会话的信息，从而有助于 ADS 选择在其响应中提供的最佳广告。在配置中 MediaTailor 配置 ADS 模板时，可以包括动态变量，也称为宏。动态变量是可替换的字符串。

动态变量可以采用以下形式：

静态值-从一个会话到下一个会话不变的值。例如， MediaTailor 期望从 ADS 获得的响应类型。
域变量 — 可用于 URL 域的动态变量，例如 URL http://my-ads-server.co m 的 my-ads-server .com部分。有关详细信息，请参阅使用域变量。
会话数据- MediaTailor 为每个会话提供的动态值，例如会话 ID。有关详细信息，请参阅使用会话变量。
玩家数据-玩家为每个会话提供的动态值。它们描述了内容查看器，并帮助广告确定哪些广告 MediaTailor 应该拼接到直播中。有关详细信息，请参阅使用玩家变量。

有关使用动态域、会话和玩家变量的更多信息，请选择适用的主题。

主题

向 ADS 传递参数

将会话和播放器信息传递到 ADS

使用 ADS 确定其响应来自 AWS Elemental MediaTailor 的广告查询所需的信息。
在中创建使用满足 ADS MediaTailor 要求的模板 ADS 请求网址的配置。在 URL 中，包含静态参数和用于动态参数的占位符。在配置的 Ad decision server (广告决策服务器) 字段中输入您的模板 URL。

在以下示例模板 URL 中，correlation 提供会话数据，deviceType 提供播放器数据：
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
在播放器上，为 AWS Elemental MediaTailor 配置会话发起请求以便为播放器数据提供参数。在会话发起请求中包含您的参数，并在后续会话请求中省略它们。

玩家为初始化会话而进行的调用类型决定了玩家（客户端）还是 MediaTailor （服务器）是否为会话提供广告跟踪报告。有关这两个选项的信息，请参阅报告广告跟踪数据。

根据您是需要服务器端还是客户端广告跟踪报告来进行以下类型的呼叫之一。在两个示例调用中，userID 适用于 ADS，auth_token 适用于源：
- （选项）要求服务器端广告跟踪报告 — 在要发送 MediaTailor 到 ADS 的参数前面加上前缀。ads为您希望 MediaTailor 将其发送到源服务器的参数消除前缀：
  
  以下示例显示了 HLS 和 DASH 的传入请求。AWS Elemental MediaTailor MediaTailor deviceType在向 ADS 发出的请求中使用，auth_token在对源服务器的请求中使用。
  
  HLS 示例：
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
  DASH 示例：
```
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
- （选项）调用客户端广告跟踪报告 — 为对象内的广告提供参数。adsParams
  
  HLS 示例：
```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```
  DASH 示例：
```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```

当播放器发起会话时，AWS Elemental MediaTailor 会将模板 ADS 请求 URL 中的变量替换为会话数据和播放器的 ads 参数。它将剩余参数从播放器传递到源服务器。

以下示例显示了来自 AWS Elemental MediaTailor 的针对 ADS 和源服务器的调用（对应于上述播放器的会话初始化调用示例）。

MediaTailor 使用会话数据和玩家的设备类型调用 ADS：


https://my.ads.server.com/path?correlation=896976764&deviceType=ipad

MediaTailor 使用玩家的授权令牌调用源服务器。

HLS 示例：


https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

DASH 示例：


https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

以下各节提供了用于配置会话和播放器数据的详细信息。

高级用法

您可以通过播放器和会话数据以多种方式自定义 ADS 请求。唯一的要求是包含 ADS 主机名。

以下示例显示了一些可用来自定义请求的方法：

连接播放器参数和会话参数以创建新参数。示例：
```
https://my.ads.com?key1=[player_params.value1][session.id]
```
使用播放器参数作为路径元素的一部分。示例：
```
https://my.ads.com/[player_params.path]?key=value
```
使用播放器参数传递路径元素和键本身，而不仅仅是值。示例：
```
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
```

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

广告跟踪集成

使用域变量