打开测量 SDK Datazoom 免费播放器 SDK 英国皇家空军 TheoPlayer MediaTailor SDK

Client-side 广告跟踪集成

本节介绍各种客户端广告跟踪服务器 MediaTailor 之间的集成。

主题

打开测量 SDK
Datazoom 免费播放器 SDK
Roku 广告框架 (RAF)
TheoPlayer
MediaTailor SDK

打开测量 SDK

互动广告局 (IAB) 开放式监测 SDK (OM SDK) 便于第三方评估向网络视频和原生应用环境投放的广告的可见度和验证度。

对于较早的 VAST 版本 3 文档，验证码应使用扩展节点加载，扩展类型为AdVerifications。扩展节点的根是与 VAST 4.1 元素具有相同架构的AdVerifications节点。

为了便于更轻松地采用OM SDK， MediaTailor 已与Datazoom合作提供免费的玩家软件开发工具包，这些软件开发工具包已针对开放式测量进行了配置和验证。有关更多信息，请参阅 Datazoom 免费播放器 SDK。

注意

MediaTailor 目前仅支持 VAST 版本 3。

例: VAST 3 中的验证节点，版本低于 4.1


...
<Extensions>
    <Extension type="AdVerifications">
        <AdVerifications>
            <Verification vendor="company.com-omid">
                <JavaScriptResource apiFramework="omid" browserOptional="true">
                    <![CDATA[https://verification.com/omid_verification.js]]>
                </JavaScriptResource>
                <TrackingEvents>
                    <Tracking event="verificationNotExecuted">
                        <![CDATA[https://verification.com/trackingurl]]>
                    </Tracking>
                </TrackingEvents>
                <VerificationParameters>
                    <![CDATA[verification params key/value pairs]]>
                </VerificationParameters>
            </Verification>
        </AdVerifications>
    </Extension>
</Extensions>

MediaTailor 从<Extensions>节点提取AdVerifications数据并将其放入客户端跟踪adVerifications响应中的数组中。

例: 客户端跟踪响应中的 AdVerifications 数组


{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "3062770",
          "adParameters": "",
          "adProgramDateTime": "2023-08-23T16:25:40.914Z",
          "adSystem": "2.0",
          "adTitle": "AD-polarbear-15",
          "adVerifications": [
            {
              "executableResource": [],
              "javaScriptResource": [
                {
                  "apiFramework": "omid",
                  "browserOptional": "true",
                  "uri": "https://verification.com/omid_verification.js"
                }
              ],
              "trackingEvents": [
                {
                  "event": "verificationNotExecuted",
                  "uri": "https://verification.com/trackingurl"
                }
              ],
              "vendor": "company.com-omid",
              "verificationParameters": "verification params key value pairs"
            }
          ],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<AdVerifications>\n\t\t\t\t\t\t<Verification vendor=\"company.com-omid\">\n\t\t\t\t\t\t\t<JavaScriptResource apiFramework=\"omid\" browserOptional=\"true\"><![CDATA[https://verification.com/omid_verification.js;]]></JavaScriptResource>\n\t\t\t\t\t\t\t<TrackingEvents>\n\t\t\t\t\t\t\t\t<Tracking event=\"verificationNotExecuted\"><![CDATA[;https://verification.com/trackingurl;]]></Tracking>\n\t\t\t\t\t\t\t</TrackingEvents>\n\t\t\t\t\t\t\t<VerificationParameters><![CDATA[verification params key/value pairs;]]></VerificationParameters>\n\t\t\t\t\t\t</Verification>\n\t\t\t\t\t</AdVerifications>",
              "type": "AdVerifications"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT10.11S",
          "startTimeInSeconds": 10.11,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://n8ljfs0h09.execute-api.us-west-2.amazonaws.com/v1/impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "3062770",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT10.11S",
              "startTimeInSeconds": 10.11
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "3062770",
      "availProgramDateTime": "2023-08-23T16:25:40.914Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT10.11S",
      "startTimeInSeconds": 10.11
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMC4xMVNfMjAyMy0wOC0yM1QxNjoyNjoyNC4yNDYxMDIxOTBaXzE%3D",
  "nonLinearAvails": []
}

注意

与 IAB 技术实验室合作，确保每年对应用程序进行认证以确保合规性。

有关 OM SDK 的更多信息，请参阅 IAB 技术实验室网站上的 O pen Measurement SDK 。

Datazoom 免费播放器 SDK

为了便于玩家软件开发工具包的更容易采用， MediaTailor 已与Datazoom合作提供免费的玩家软件开发工具包，这些软件开发工具包均使用和IAB Tech进行了配置Client-side AWS Elemental MediaTailor 与谷歌广告管理器集成和测试。打开测量 SDK

Datazoom 播放器 SDK 支持以下功能：

直播和 VOD 播放列表
DASH 和 HLS 规格
播放器供应商支持 Bitmovin、exoplayer、安卓媒体播放器、苹果 AVPlayer、Brightcove、Chromecast Receiver、hls.js、JWPlayer、 Dash.js Shaka 播放器、THEO 播放器、Roku 等 Video.js
IAB Tech Lab 开放式测量认证，适用于特定设备
Click-through 事件处理
Ad-event 调度器，例如广告倒计时器、广告叠加和非线性事件、广告插播开始、广告插播结束
Client-side 广告信标
谷歌编程访问库 (PAL) SDK，作为可选配置设置

Datazoom 还提供玩家 SDK 支持的付费分析和遥测服务。客户可以从 Datazoom 管理控制台选择加入和控制播放器 SDK 遥测功能。要访问Datazoom播放器软件开发工具包并了解有关增值遥测和分析服务的更多信息，请使用Datazoom网站上的联系信息。https://www.datazoom.io/partner-aws

Roku 广告框架 (RAF)

Roku广告框架（RAF）在整个Roku平台上保持了一致的广告体验。所有频道，包括视频广告，都必须满足Roku对英国皇家空军的认证要求。值得注意的是，该应用程序必须始终使用通过 RAF 触发客户端事件。 MediaTailor作为服务器端广告插入 (SSAI) 提供商，支持客户端事件触发。RAFX SSAI 适配器为 SSAI 清单服务器（即拼接器）和 RAF 提供接口。这些接口包括：

解析masterURL响应和提取 playURLAdURL，以及广告元数据。
将 MediaTailor SSAI 广告元数据转换为 RAF-usable 广告元数据，并配置 RAF 以进行播放。
观察直播事件和定时元数据。
按时匹配直播事件、广告元数据和触发事件像素。
Pinging/polling 然后AdURL，按照 MediaTailor SSAI 清单服务器的要求，解析并重新配置 RAF。

有关适用于 RAF 的 SSAI 适配器的更多信息，请参阅 Roku 网站上的 “使用 Roku 适配器实现 Server-Side 广告插入”。

TheoPlayer

TheoPlayer 与的集成执行以下 MediaTailor 操作：

提供支持 VOD 和直播工作流程中 HLS 和 DASH 的 MediaTailor 客户端事件跟踪的功能。
仅支持为线性广告发送跟踪信标。
在广告期间禁用搜索。但是，当用户寻求突破广告时段时，播放广告的逻辑不成立。

要了解有关 SSAI 的更多信息 TheoPlayer，并查看其中的网络、安卓、iOS 和 tvOS 软件开发工具包 MediaTailor，请参阅网站MediaTailor上的内容。 TheoPlayer

MediaTailor SDK

AWS Elemental 维护 JavaScript-based 软件开发套件 (SDK)。 AWS Elemental 按原样提供 SDK，不含任何暗示担保。使用 SDK 作为参考演示，简化入门到使用 MediaTailor。该软件开发工具包展示了如何与 MediaTailor 客户端跟踪 API 进行交互。该软件开发工具包为玩家实现了客户端广告跟踪和报告。 HTML5-based SDK 初始化 MediaTailor 客户端报告会话，然后定期请求广告跟踪信息。在播放期间，当检测到新的广告事件时，SDK 会发出广告跟踪事件。

S MediaTailor DK 支持以下功能：

直播和 VOD 播放列表
DASH 和 HLS 规格
Click-through 事件处理
Ad-event 调度员
自定义事件挂钩
Client-side 广告信标。有关发送广告信标的更多信息，请参阅Client-side 信标。

注意

提交 AWS 支持请求以获得的示例 JavaScript SDK MediaTailor。您将收到该软件包及其文件的下载链接。

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

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

文档惯例

混合模式

叠加广告