翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# クライアント側の広告追跡統合
<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>

Interactive Advertising Bureau (IAB) Open Measurement SDK (OM SDK) は、ウェブビデオ環境とネイティブアプリケーション環境に配信される広告のサードパーティーの可視性と検証の測定を容易にします。

古い VAST バージョン 3 ドキュメントの場合、検証コードは拡張タイプ の拡張ノードでロードする必要があります`AdVerifications`。拡張ノードのルートは、VAST 4.1 要素と同じスキーマを持つ`AdVerifications`ノードです。

OM SDK の導入を容易にするために、MediaTailor は Datazoom と提携し、オープン測定用に設定および検証された無料プレイヤー SDKs を提供しています。詳細については、「[Datazoom フリープレイヤー SDKs](#ad-reporting-client-side-ad-tracking-integrations-dz)」を参照してください。

**注記**  
MediaTailor は現在、VAST バージョン 3 のみをサポートしています。

**Example : バージョン 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`配列に配置します。

**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 広告マネージャーとのクライアント側の 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 プレイヤー、THEO プレイヤー、Video.js、Roku などに対するプレイヤーベンダーのサポート
+ 選択したデバイスで利用可能な IAB Tech Lab Open Measurement 認定
+ クリックスルーイベント処理
+ 広告カウントダウンタイマー、広告オーバーレイ、非線形イベント、広告ブレーク開始、広告ブレーク終了などの広告イベントディスパッチャー
+ クライアント側の広告ビーコン
+ オプションの設定としての Google Programmatic Access Library (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 Adapter は、SSAI マニフェストサーバー、またはスティッカー、および RAF の両方にインターフェイスを提供します。これらのインターフェイスには以下が含まれます。
+ `masterURL` レスポンスを解析し`playURL`、、`AdURL`、および広告メタデータを抽出します。
+ MediaTailor SSAI 広告メタデータを RAF が使用可能な広告メタデータに変換し、再生用に RAF を設定します。
+ ストリームイベントと時間指定メタデータの監視。
+ ストリームイベント、広告メタデータ、射撃イベントのピクセルを時間どおりに一致させます。
+ MediaTailor SSAI マニフェストサーバーの要求に応じて `AdURL`に Ping/ポーリングし、RAF を解析して再設定します。

RAF 用の SSAI アダプターの詳細については、[Roku ウェブサイトの「Roku Adapters を使用したサーバー側の広告挿入の実装](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 のウェブ、Android、iOS、tvOS SDKs[MediaTailor](https://docs.theoplayer.com/how-to-guides/01-ads/12-mediatailor.md)」を参照してください。 TheoPlayer 

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

AWS Elemental は、JavaScript ベースのソフトウェア開発キット (SDK) を維持します。 AWS Elemental は SDK をそのまま提供しますが、黙示的な保証はありません。SDK をリファレンスデモとして使用して、MediaTailor を使用した へのオンボーディングを合理化します。SDK は、MediaTailor クライアント側の追跡 API を操作する方法を示しています。SDK は、HTML5-basedプレイヤーのクライアント側の広告追跡とレポートを実装します。SDK は MediaTailor クライアント側のレポートセッションを初期化し、定期的に広告追跡情報をリクエストします。再生中、SDK は新しい広告イベントが検出されたときに広告追跡イベントを出力します。

MediaTailor SDK は、以下の機能をサポートしています。
+ ライブプレイリストと VOD プレイリスト
+ DASH および HLS の仕様
+ クリックスルーイベント処理
+ 広告イベントディスパッチャ
+ カスタムイベントフック
+ クライアント側の広告ビーコン。広告ビーコンの送信の詳細については、「」を参照してください[クライアント側のビーコン](ad-reporting-client-side-beaconing.md)。

**注記**  
 AWS サポートチケットを送信して、サンプルの JavaScript SDK for MediaTailor を受け取ります。パッケージとそのファイルのダウンロードリンクを受け取ります。