本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
本節說明 MediaTailor 與各種用戶端廣告追蹤伺服器之間的整合。
開啟測量 SDK
互動式廣告局 (IAB) 開放式測量 SDK(OMSDK) 可促進提供給 Web 影片和原生應用程式環境之廣告的第三方可視性和驗證測量。
對於較舊的 第 3 VAST版文件,驗證碼應載入副檔名節點,副檔名類型為 AdVerifications
。延伸節點的根目錄是與 4.1 VAST 元素具有相同結構描述的AdVerifications
節點。
為了簡化 OM 的採用SDK, MediaTailor 已與 Datazoom 合作,提供針對 Open Measurement SDKs 設定和驗證的免費玩家。如需詳細資訊,請參閱Datazoom 免費播放器 SDKs。
注意
MediaTailor 目前僅支援第 3 VAST版。
範例 :第 3 VAST 版中的驗證節點,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 網站上的開啟測量SDK
Datazoom 免費播放器 SDKs
為了簡化玩家 的採用SDKs, MediaTailor 已與 Datazoom 合作,提供使用 SDKs 和 與 Google Ad Manager 的用戶端 AWS Elemental MediaTailor 整合 IAB 技術 設定和測試的免費玩家開啟測量 SDK。
Datazoom 播放器SDK支援下列功能:
即時和VOD播放清單
-
DASH 和 HLS 規格
-
玩家廠商支援 Bitmovin、exoplayer、Android 媒體播放器、Apple AVPlayer、Brightcove、Chromecast Receiver、Dash.js、hls.js、JWPlayer、Shaka player、THEO播放器、Video.js、Roku 等
-
IAB 技術實驗室開放式測量認證,在所選裝置上提供
-
點擊式事件處理
-
廣告事件發送器,例如廣告倒數計時器、廣告浮水印和非線性事件、廣告休息時間開始、廣告休息時間結束
-
用戶端廣告信標
-
Google 程式設計存取程式庫 (PAL) SDK,作為選用的組態設定
Datazoom 也提供玩家SDKs支援的付費分析和遙測服務。客戶可以從 Datazoom 管理主控台選擇加入和控制玩家SDK遙測。若要存取 Datazoom 播放器,SDKs並進一步了解附加價值遙測和分析服務,請使用 Datazoom 網站上的
Roku 廣告架構 (RAF)
Roku 廣告架構 (RAF) 會在整個 Roku 平台上維持一致的廣告體驗。所有頻道,包括影片廣告,必須符合 Roku 的 認證要求RAF。值得注意的是,應用程式必須一律透過 使用用戶端事件觸發RAF。 MediaTailor作為伺服器端廣告插入 (SSAI) 供應商,支援用戶端事件觸發。RAFX SSAI 轉接器提供SSAI資訊清單伺服器或接合器和 的介面RAF。這些界面包括:
-
剖析
masterURL
回應並擷取playURL
、AdURL
和廣告中繼資料。 -
將 MediaTailor SSAI廣告中繼資料轉換為可使用RAF的廣告中繼資料,並設定RAF播放。
-
觀察串流事件和定時中繼資料。
-
準時比對串流事件、廣告中繼資料和射擊事件像素。
-
AdURL
依資訊清單伺服器的需求 MediaTailor SSAI Ping/輪詢 ,然後剖析並重新設定 RAF。
如需 SSAI轉接器的詳細資訊RAF,請參閱 Roku 網站上的使用 Roku 轉接器實作伺服器端廣告插入
TheoPlayer
TheoPlayer 與 整合會 MediaTailor 執行下列動作:
-
為 HLS和 DASH 的VOD即時工作流程提供支援 MediaTailor 用戶端事件追蹤的功能。
-
僅支援線性廣告傳送追蹤信標。
-
在廣告期間停用搜尋。不過,當使用者在廣告休息時間後尋找 時,沒有播放廣告的邏輯。
如需 SSAI 中的詳細資訊 TheoPlayer,以及檢閱 SDKs 的 Web、Android、iOS 和 tvOS MediaTailor,請參閱 MediaTailor
MediaTailor SDK
AWS Elemental 維護以軟體開發套件 JavaScript為基礎的套件 (SDK)。 AWS Elemental SDK 提供原樣,沒有暗示的保證。使用 SDK做為參考示範,以簡化 的加入 MediaTailor。SDK 顯示如何與 MediaTailor 用戶端追蹤 互動API。為 HTML5型玩家SDK實作用戶端廣告追蹤和報告。會SDK初始化 MediaTailor 用戶端報告工作階段,然後定期請求廣告追蹤資訊。在播放期間,當偵測到新的廣告事件時SDK, 會發出廣告追蹤事件。
MediaTailor SDK 支援這些功能:
-
即時和VOD播放清單
-
DASH 和 HLS 規格
-
點擊式事件處理
-
廣告事件發送器
-
自訂事件掛鉤
-
用戶端廣告信標。如需傳送廣告信標的詳細資訊,請參閱用戶端指標。
注意
提交 AWS 支援票證以接收 的範例 JavaScript SDK MediaTailor。您將收到套件及其檔案的下載連結。