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

# 用戶端廣告追蹤整合
<a name="ad-reporting-client-side-ad-tracking-integrations"></a>

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

**Topics**
+ [開啟測量 SDK](#ad-reporting-client-side-ad-tracking-integrations-open-measurement-sdk)
+ [Datazoom 免費播放器 SDKs](#ad-reporting-client-side-ad-tracking-integrations-dz)
+ [Roku 廣告架構 (RAF)](#ad-reporting-client-side-ad-tracking-integrations-raf)
+ [TheoPlayer](#ad-reporting-client-side-ad-tracking-integrations-theoplayer)
+ [MediaTailor SDK](#ad-reporting-client-side-ad-tracking-integrations-mediatailor-sdk)

## 開啟測量 SDK
<a name="ad-reporting-client-side-ad-tracking-integrations-open-measurement-sdk"></a>

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

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

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

**注意**  
MediaTailor 目前僅支援 VAST 第 3 版。

**Example ：VATT 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`陣列。

**Example ：用戶端追蹤回應中的 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](https://iabtechlab.com/standards/open-measurement-sdk/)。

## Datazoom 免費播放器 SDKs
<a name="ad-reporting-client-side-ad-tracking-integrations-dz"></a>

為了更容易採用玩家SDKs，MediaTailor 已與 Datazoom 合作，提供使用 和 [與 Google Ad Manager 的用戶端 AWS Elemental MediaTailor 整合](gam-integration-pal.md) IAB Tech 設定和測試的免費玩家SDKs[開啟測量 SDK](#ad-reporting-client-side-ad-tracking-integrations-open-measurement-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 網站上的](https://www.datazoom.io/partner-aws)聯絡資訊。

## Roku 廣告架構 (RAF)
<a name="ad-reporting-client-side-ad-tracking-integrations-raf"></a>

Roku 廣告架構 (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 轉接器實作伺服器端廣告插入](https://developer.roku.com/docs/developer-program/advertising/ssai-adapters.md)。

## TheoPlayer
<a name="ad-reporting-client-side-ad-tracking-integrations-theoplayer"></a>

與 MediaTailor 的 TheoPlayer 整合會執行下列動作：
+ 為 VOD 和即時工作流程提供支援 HLS 和 DASH 的 MediaTailor 用戶端事件追蹤功能。
+ 僅支援線性廣告傳送追蹤信標。
+ 停用廣告期間的搜尋。不過，當使用者尋求超過廣告休息時間時，沒有用於播放廣告的邏輯。

如需 TheoPlayer 中 SSAI 的詳細資訊，以及檢閱適用於 MediaTailor 的 Web、Android、iOS 和 tvOS SDKs，請參閱 TheoPlayer 網站上的 [MediaTailor](https://docs.theoplayer.com/how-to-guides/01-ads/12-mediatailor.md)。

## MediaTailor SDK
<a name="ad-reporting-client-side-ad-tracking-integrations-mediatailor-sdk"></a>

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

MediaTailor SDK 支援下列功能：
+ 即時和 VOD 播放清單
+ DASH 和 HLS 規格
+ 點擊式事件處理
+ 廣告事件發送器
+ 自訂事件掛鉤
+ 用戶端廣告信標。如需傳送廣告信標的詳細資訊，請參閱 [用戶端信標](ad-reporting-client-side-beaconing.md)。

**注意**  
提交 AWS 支援票證以接收 MediaTailor 的 JavaScript 開發套件範例。您會收到套件及其檔案的下載連結。