オープン測定 SDK Datazoom フリープレイヤー SDKs RAF TheoPlayer MediaTailor SDK

クライアント側の広告追跡統合

このセクションでは、 MediaTailor とさまざまなクライアント側の広告追跡サーバーの統合について説明します。

トピック

オープン測定 SDK
Datazoom フリープレイヤー SDKs
Rku 広告フレームワーク (RAF）
TheoPlayer
MediaTailor SDK

オープン測定 SDK

インタラクティブ広告局 (IAB) のオープン計測 SDK (OM SDK) は、ウェブビデオ環境やネイティブアプリ環境に配信される広告のサードパーティーのビューアビリティと検証の測定を容易にします。

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

OM の導入を容易にするためにSDK、 MediaTailor は Datazoom と提携し、オープン測定用に設定および認証SDKsされた無料プレイヤーを提供しています。詳細については、「Datazoom フリープレイヤー SDKs」を参照してください。

注記

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

例 : バージョン 4VAST.1 より前の 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配列に配置します。

例 : クライアント側の追跡レスポンスの 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 Tech Lab ウェブサイトの「オープン測定SDK」を参照してください。

Datazoom フリープレイヤー SDKs

プレイヤーの採用を容易にするためにSDKs、 MediaTailor は Datazoom と提携し、 Google 広告マネージャーとのクライアント側の AWS Elemental MediaTailor 統合および IAB Tech で設定およびテストSDKsされた無料のプレイヤーを提供していますオープン測定 SDK。

Datazoom プレイヤーは、以下の機能SDKをサポートしています。

ライブリストとVODプレイリスト
DASH および HSL仕様
Bitmovin、exoplayer、Android メディアプレイヤー、Apple AVPlayer、Brightcove、Chromecast Receiver、Dash.js、hls.js、JWPlayer、Shaka プレイヤー、THEOプレイヤー、Video.js、Rku などのプレイヤーベンダーのサポート
IAB 選択したデバイスで利用可能な Tech Lab Open Measurement 認定
クリックスルーイベント処理
広告カウントダウンタイマー、広告オーバーレイ、非線形イベント、広告ブレーク開始、広告ブレーク終了などの広告イベントディスパッチャー
クライアント側の広告ビーコン
Google Programmatic Access Library (PAL）SDK、オプションの設定として

Datazoom は、プレイヤーがSDKsサポートする有料の分析およびテレメトリサービスも提供します。お客様は Datazoom マネジメントコンソールからプレイヤーSDKテレメトリをオプトインおよび制御できます。Datazoom プレイヤーにアクセスしSDKs、付加価値テレメトリおよびアナリストサービスの詳細については、Datazoom サイトの連絡先情報を参照してください。

Rku 広告フレームワーク (RAF）

Rku Ad Framework (RAF) は、Rku プラットフォーム全体で一貫した広告エクスペリエンスを維持します。ビデオ広告を含むすべてのチャネルは、に関する Rku の認定要件を満たしている必要がありますRAF。特に、アプリは常にを通じてクライアント側のイベント射撃を使用する必要がありますRAF。は MediaTailor、サーバー側の広告挿入 (SSAI) プロバイダーとして、クライアント側のイベント射撃をサポートします。RAFX SSAI Adapters は、SSAIマニフェストサーバー、またはスティッカー、およびの両方にインターフェイスを提供しますRAF。これらのインターフェイスには以下が含まれます。

masterURL レスポンスを解析しplayURL、、AdURL、および広告メタデータを抽出します。
広告メタデータを MediaTailor SSAIRAF使用可能な広告メタデータに変換し、再生RAF用にを設定します。
ストリームイベントと時間指定メタデータの監視。
ストリームイベント、広告メタデータ、および射撃イベントのピクセルを時間どおりにマッチングします。
マニフェストサーバーの要求AdURLに応じてに Ping/ポーリングし、を MediaTailor SSAI解析して再設定しますRAF。

のSSAIアダプターの詳細についてはRAF、Rku ウェブサイトの「Rku Adapters を使用したサーバー側の広告挿入の実装」を参照してください。

TheoPlayer

TheoPlayer との統合 MediaTailor では、次のことを行います。

HLS との両方のVODライブワークフローDASHで MediaTailor 、クライアント側のイベント追跡をサポートする機能を提供します。
リニア広告のみの追跡ビーコンの送信をサポートします。
広告中のシークを無効にします。ただし、ユーザーが広告時間枠を過ぎようとしたときに広告を再生するロジックはありません。

SSAI でのの詳細 TheoPlayer、およびのウェブ、Android、iOS、tvOS を確認するには MediaTailor、 TheoPlayer ウェブサイトMediaTailorのSDKs「」を参照してください。

MediaTailor SDK

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

は MediaTailor SDK、以下の機能をサポートしています。

ライブリストとVODプレイリスト
DASH および HLS仕様
クリックスルーイベント処理
広告イベントディスパッチャ
カスタムイベントフック
クライアント側の広告ビーコン。広告ビーコンの送信の詳細については、「」を参照してくださいクライアント側ビーコン。

注記

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

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ハイブリッドモード

オーバーレイ広告