客户端跟踪

使用AWS Elemental MediaTailor客户端跟踪 API，您可以在直播工作流程中加入广告时段的播放器控件。在客户端跟踪中，玩家或客户端向广告决策服务器 (ADS) 和其他广告验证实体发送跟踪事件，例如展示次数和四分位数广告信标。有关展示次数和四分位数广告信标的更多信息，请参阅。客户端信标有关 ADS 和其他广告验证实体的更多信息，请参阅。客户端广告跟踪集成

客户端跟踪支持以下功能：

• 广告时段倒计时器-有关更多信息，请参阅。广告倒计时器

• 广告点击量-有关更多信息，请参阅。广告点击

• 展示随播广告-有关更多信息，请参阅配套广告。

• 可跳过的广告-有关更多信息，请参阅。可跳过的广告

• 显示 VAST 图标以实现隐私合规性-有关更多信息，请参阅Google 的图标为什么是这个广告 (WTA)。

• 控制广告期间玩家的擦洗-有关更多信息，请参阅擦洗。

使用 MediaTailor 客户端跟踪 API，除了客户端跟踪之外，您还可以将元数据发送到启用其他功能的播放设备：

主题

• 启用客户端跟踪
• 广告服务器参数
• 源站交互查询参数
• 会话配置的功能
• 客户端跟踪的最佳实践
• 客户端广告跟踪架构
• 广告追踪活动时机
• 玩家控制和功能
• 客户端信标
• 带有服务器端广告信标的混合模式
• 客户端广告跟踪集成

启用客户端跟踪

您可以为每个会话启用客户端跟踪。玩家POST向 MediaTailor 配置的会话初始化前缀端点创建 HTTP。或者，玩家可以发送其他元数据， MediaTailor 以便在进行广告调用、调用 Origin 获取清单以及在会话级别调用或禁用 MediaTailor功能时使用。

以下示例显示了 JSON 元数据的结构：

{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

使用 MediaTailor 控制台或 API 配置 ADS 请求模板网址以引用这些参数。在以下示例中，player_params.param1是的玩家参数param1，player_params.param2是的玩家参数param2。

https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

广告服务器参数

JSON 结构的最顶层是一个 JS adsParams ON 对象。该对象内部有键/值对， MediaTailor 可以在所有会话请求中读取并发送到广告服务器。 MediaTailor 支持以下广告服务器：

• 谷歌广告管理器

• SpringServe

• FreeWheel

• Publica

源站交互查询参数

JSON 结构最顶层中的任何保留键/值对（例如adParamsavailSuppressionoverlayAvails、和）都不会以查询参数的形式添加到源请求网址中。向源发出的 MediaTailor 每个会话清单请求都包含这些查询参数。Origin 会忽略多余的查询参数。例如， MediaTailor 可以使用键/值对将访问令牌发送到源。

会话配置的功能

使用会话初始化 JSON 结构启用、禁用或覆盖诸如overlayAvailsavailSuppression、和之类的 MediaTailor功能。adSignaling会话初始化期间传递的任何功能配置都会覆盖 MediaTailor 配置级别的设置。

注意

MediaTailor 在会话初始化时提交的元数据是不可变的，并且在会话期间无法添加其他元数据。使用 SCTE-35 标记携带会话期间发生变化的数据。有关更多信息，请参阅使用会话变量：

例 : 为 HLS 执行客户端广告跟踪

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }

例 : 对 DASH 执行客户端广告跟踪

POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

成功的响应是200带有响应正文的 HTTP。正文包含一个带有manifestUrl和trackingUrl密钥的 JSON 对象。这些值是玩家可用于播放和广告事件跟踪目的的相对网址。

{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

有关客户端跟踪架构的更多信息，请参阅客户端广告跟踪架构。

客户端跟踪的最佳实践

本节概述了直播和 VOD MediaTailor 工作流程中客户端跟踪的最佳实践。

实时工作流程

按照与 HLS 的每个目标持续时间或 DASH 的最短更新周期相匹配的时间间隔对跟踪端点进行轮询，以便始终获得最新的广告跟踪元数据。在广告素材可能包含交互式或叠加组件的工作流程中，匹配此间隔尤其重要。

注意

有些玩家支持事件监听器，这可以用作投票的替代方案。例如，需要为每个会话启用 MediaTailor 广告 ID 装饰功能。有关更多信息，请参阅广告 ID 装饰：使用此功能可以在每个广告上添加日期范围 (HLS) 或事件元素 (DASH) 标识符。玩家可以使用这些清单标签作为提示，为会话调用 MediaTailor 跟踪端点。

VOD 工作流程

成功初始化会话后，在 MediaTailor收到第一个包含媒体的清单后，您只需调用一次跟踪端点即可。