開啟測量 SDK Datazoom 免費播放器 SDKs RAF TheoPlayer MediaTailor SDK

用戶端廣告追蹤整合

本節說明 MediaTailor 與各種用戶端廣告追蹤伺服器之間的整合。

主題

開啟測量 SDK
Datazoom 免費播放器 SDKs
Roku 廣告架構 (RAF)
TheoPlayer
MediaTailor SDK

開啟測量 SDK

互動式廣告局 (IAB) 開放式測量 SDK (OM SDK) 可促進提供給 Web 影片和原生應用程式環境之廣告的第三方可視性和驗證測量。

對於較舊的 VAST 第 3 版文件，驗證碼應載入延伸節點，延伸類型為 AdVerifications。延伸節點的根AdVerifications節點與 VAST 4.1 元素具有相同的結構描述。

為了簡化 OM 開發套件的採用，MediaTailor 已與 Datazoom 合作，提供免費玩家SDKs，這些開發套件已針對 Open Measurement 進行設定和驗證。如需詳細資訊，請參閱Datazoom 免費播放器 SDKs。

注意

MediaTailor 目前僅支援 VAST 第 3 版。

範例：VATS 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 Tech Lab 互動，確保應用程式每年都經過認證，以確保合規。

如需 OM SDK 的詳細資訊，請參閱 IAB Tech Lab 網站上的 Open Measurement SDK。

Datazoom 免費播放器 SDKs

為了簡化玩家SDKs的採用，MediaTailor 已與 Datazoom 合作，提供使用和與 Google Ad Manager 的用戶端 AWS Elemental MediaTailor 整合 IAB Tech 設定和測試的免費玩家SDKs開啟測量 SDK。

Datazoom 播放器 SDK 支援下列功能：

即時和 VOD 播放清單
DASH 和 HLS 規格
玩家廠商支援 Bitmovin、exoplayer、Android 媒體播放器、Apple AVPlayer、Brightcove、Chromecast Receiver、Dash.js、hls.js、JWPlayer、Shaka player、 THEO player、Video.js、Roku 等
IAB Tech Lab Open Measurement 認證，在所選裝置上提供
點擊式事件處理
廣告事件發送器，例如廣告倒數計時器、廣告浮水印和非線性事件、廣告休息時間開始、廣告休息時間結束
用戶端廣告信標
Google 程式設計存取程式庫 (PAL) SDK，做為選用的組態設定

Datazoom 也提供玩家 SDKs 支援的付費分析和遙測服務。客戶可以從 Datazoom 管理主控台選擇加入和控制玩家 SDK 遙測。若要存取 Datazoom 播放器 SDKs，以及進一步了解附加價值遙測和分析服務，請使用 Datazoom 網站上的聯絡資訊。

Roku 廣告架構 (RAF)

Roku Ad Framework (RAF) 會在整個 Roku 平台中維持一致的廣告體驗。所有頻道，包括影片廣告，必須符合 Roku 的 RAF 認證要求。值得注意的是，應用程式必須一律使用透過 RAF 觸發的用戶端事件。MediaTailor 作為伺服器端廣告插入 (SSAI) 供應商，支援用戶端事件觸發。RAFX SSAI 轉接器提供 SSAI 資訊清單伺服器或接合器和 RAF 的介面。這些界面包括：

剖析masterURL回應並擷取 playURL、 AdURL和廣告中繼資料。
將 MediaTailor SSAI 廣告中繼資料轉換為可使用 RAF 的廣告中繼資料，並設定 RAF 進行播放。
觀察串流事件和定時中繼資料。
準時比對串流事件、廣告中繼資料和射擊事件像素。
AdURL依 MediaTailor SSAI 資訊清單伺服器的需求，對進行 Ping/polling 分析，然後剖析並重新設定 RAF。

如需 RAF SSAI 轉接器的詳細資訊，請參閱 Roku 網站上的使用 Roku 轉接器實作伺服器端廣告插入。

TheoPlayer

TheoPlayer 與 MediaTailor 整合會執行下列動作：

為 VOD 和即時工作流程提供支援 HLS 和 DASH 的 MediaTailor 用戶端事件追蹤功能。
僅支援線性廣告傳送追蹤信標。
在廣告期間停用搜尋。不過，當使用者在廣告休息時間後尋找時，沒有用於播放廣告的邏輯。

如需 TheoPlayer 中 SSAI 的詳細資訊，以及檢閱 MediaTailor 的 Web、Android、iOS 和 tvOS SDKs，請參閱 TheoPlayer 網站上的 MediaTailor。

MediaTailor SDK

AWS Elemental 維護以 JavaScript 為基礎的軟體開發套件 (SDK)。 AWS Elemental 提供 SDK，沒有隱含保證。使用 SDK 做為參考示範，以簡化使用 MediaTailor 的入門。軟體開發套件示範如何與 MediaTailor 用戶端追蹤 API 互動。SDK 實作 HTML5-based玩家的用戶端廣告追蹤和報告。軟體開發套件會初始化 MediaTailor 用戶端報告工作階段，然後定期請求廣告追蹤資訊。在播放期間，軟體開發套件會在偵測到新的廣告事件時發出廣告追蹤事件。

MediaTailor SDK 支援下列功能：

即時和 VOD 播放清單
DASH 和 HLS 規格
點擊式事件處理
廣告事件發送器
自訂事件掛鉤
用戶端廣告信標。如需傳送廣告信標的詳細資訊，請參閱用戶端信標。

注意

提交 AWS 支援票證，以取得 MediaTailor 的 JavaScript 開發套件範例。您將收到套件及其檔案的下載連結。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

混合模式

Overlay 廣告