オープン測定 SDK RAF TheoPlayer MediaTailor SDK

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

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

トピック

オープン測定ソフトウェア開発キット (SDK）
Rku 葬祭フレームワーク (RAF）
TheoPlayer
MediaTailor ソフトウェア開発キット (SDK）

オープン測定ソフトウェア開発キット (SDK）

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

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

注記

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 array


{
  "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」を参照してください。

Rku 葬祭フレームワーク (RAF）

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

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

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

TheoPlayer

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

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

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

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 を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ハイブリッドモード

動的広告変数の使用