客户端广告跟踪集成

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

开放式测量软件开发套件 (SDK)

互动广告局 (IAB) Open Measurement SDK (OMSDK) 为投放到网络视频和原生应用环境的广告的第三方可见度和验证度提供了便利。

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

注意

MediaTailor 目前仅支持VAST版本 3。

例 : 4.1 之前的版本 VAST 3 中的验证节点

...
<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技术实验室网站SDK上的开放测量。

Roku 广告框架 () RAF

Roku 广告框架 (RAF) 在 Roku 平台上保持一致的广告体验。所有频道，包括视频广告，都必须符合Roku的认证要求。RAF值得注意的是，应用程序必须始终使用客户端事件触发。RAF MediaTailor，作为服务器端广告插入 (SSAI) 提供商，支持客户端事件触发。RAFXSSAI适配器为SSAI清单服务器或拼接器提供接口，以及。RAF这些接口包括：

• 解析masterURL响应并提取playURLAdURL、和广告元数据。

• 将 MediaTailor SSAI广告元数据转换为RAF可用的广告元数据，并RAF进行播放配置。

• 观察直播事件和定时元数据。

• 按时匹配直播事件、广告元数据和触发事件像素。

• 根据 MediaTailor SSAI清单服务器的AdURL要求执行 Ping/轮询，然后进行解析和重新配置。RAF

有关SSAI适配器的更多信息RAF，请参阅 Roku 网站上的使用 Roku 适配器实现服务器端广告插入。

TheoPlayer

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

• 提供支持 MediaTailor 客户端事件跟踪的功能，支持两者HLSVOD以及实时工作流程DASH的客户端事件跟踪。

• 仅支持为线性广告发送跟踪信标。

• 禁止在广告期间进行搜索。但是，当用户越过广告时段时，播放广告的逻辑并不合理。

如需了解SSAI更多信息以及查看网页 TheoPlayer、Android、iOS 和 tvOS SDKs 的相关信息 MediaTailor，请MediaTailor TheoPlayer 访问网站。

MediaTailor 软件开发套件 (SDK)

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

MediaTailor SDK支持以下功能：

• 直播和VOD播放列表

• DASH和HLS规格

• 点击事件处理

• 广告活动调度员

• 自定义事件挂钩

• 客户端广告信标。有关发送广告信标的更多信息，请参阅客户端信标。

注意

提交 AWS 获取样本 JavaScript SDK的 Support 票 MediaTailor。您将收到软件包及其文件的下载链接。