用戶端廣告追蹤整合 - AWS Elemental MediaTailor

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

用戶端廣告追蹤整合

本節介紹了 MediaTailor 與各種客戶端廣告跟踪服務器之間的集成。

開放式量測軟體開發套件 (SDK)

互動式廣告局 (IAB) 開放測量 SDK (OM SDK) 可針對向網路影片和原生應用程式環境提供的廣告,促進第三方可見度和驗證度量。

對於較舊的 VAST 第 3 版文件,驗證碼應與擴充功能節點一起載入,並附有擴充功能類型AdVerifications。擴充節點的根目錄是與 VAST 4.1 元素具有相同結構描述的AdVerifications節點。

注意

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陣列中。

範例 : 用戶端追蹤回應中的副作用陣列
{ "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 廣告框架

Roku 廣告框架(RAF)在整個 Roku 平台上保持一致的廣告體驗。包括影片廣告在內的所有頻道都必須符合 Roku 對 RAF 的認證要求。值得注意的是,應用程序必須始終使用通過 RAF 的客戶端事件觸發。 MediaTailor,身為伺服器端廣告插入 (SSAI) 提供者,支援用戶端事件觸發。RAFX SSAI 介面卡提供兩個 SSAI 資訊清單伺服器或縫合器,以及 RAF 的介面。這些介面包括:

  • 剖析masterURL回應並擷取playURLAdURL、和廣告中繼資料。

  • 將 MediaTailor SSAI 廣告中繼資料轉換為 RAF 可用的廣告中繼資料,並設定 RAF 進行播放。

  • 觀察流事件和定時元數據。

  • 按時比對串流事件、廣告中繼資料和起始事件像素。

  • 偵測/輪詢 MediaTailor SSAI 資訊清單伺服器的要求,然後剖析並重新設定 RAF。AdURL

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

TheoPlayer

TheoPlayer 與整合可 MediaTailor 執行以下作業:

  • 提供支援用 MediaTailor 戶端事件追蹤的功能,適用於 VOD 和即時工作流程的 HLS 和 DASH。

  • 僅支援針對線性廣告傳送追蹤信標。

  • 停用廣告期間的搜尋功能。但是,當用戶搜索過廣告插播時,沒有任何邏輯可以播放廣告。

如需有關 SSAI 的詳細資訊 TheoPlayer,以及檢閱網頁、安卓系統、iOS 和 tvOS SDK 的詳細資訊 MediaTailor,請參閱網站MediaTailor上的。 TheoPlayer

MediaTailor 軟體開發套件 (SDK)

AWS元素維護了一個 JavaScript基於軟件開發工具包(SDK)。 AWS元素按原樣提供 SDK,沒有暗示的擔保。使用 SDK 作為參考演示,以簡化您的入職過程。 MediaTailorSDK 會示範如何與 MediaTailor 用戶端追蹤 API 進行互動。SDK 會針對以 HTML5 為基礎的播放器實作用戶端廣告追蹤和報告。SDK 會初始化 MediaTailor 用戶端報告工作階段,然後定期要求廣告追蹤資訊。在播放期間,SDK 會在偵測到新的廣告事件時發出廣告追蹤事件。

MediaTailor SDK 支援下列功能:

  • 直播和 VOD 播放清單

  • 短跑和 HLS 規格

  • 點擊連結事件處理

  • 廣告事件調度器

  • 自訂事件掛接

  • 用戶端廣告指標。如需有關傳送廣告信標的詳細資訊,請參閱用戶端指標

注意

提交 S AWS upport 票證以接收的 JavaScript SDK 範例 MediaTailor。您將收到軟件包及其文件的下載鏈接。