Chromecast のセットアップ

FAQ

Chromecast JavaScript SDK または標準の JavaScript SDK のどちらを使用すべきでしょうか。

正解は「Chromecast」です。理由は以下のとおりです。

  • Standard JS SDK の AppMeasurement ライブラリと VisitorAPI ライブラリは、OTT プラットフォームでの使用は認定されていません。Chromecast JS SDK では、ビデオハートビートライブラリ(VHL)、Analytics および VisitorAPI が Chromecast 向けに認定された 1 つの統合 SDK に組み込まれています。
  • Chromecast SDK は、標準の JS SDK よりもはるかに軽量です。これは、OTT プラットフォームが使用するロワーエンドハードウェアにとって非常に重要な点です。

前提条件

  • ハートビート用の有効な設定パラメーターを取得 これらのパラメーターは、Media Analytics アカウントの設定後、アドビの担当者から取得できます。
  • メディアプレーヤーで以下の機能を設定します。
    • プレーヤーイベントをサブスクライブするための API - メディア SDK では、プレーヤーでイベントが発生する際に、シンプルな API のセットを呼び出す必要があります。
    • プレーヤー情報を提供する API - メディア名や再生ヘッドなどの情報がこれに該当します。

Adobe Mobile Services は、モバイルアプリケーション用のモバイルマーケティング機能を Adobe Experience Cloud 上で統合する新しい UI を提供します。今回は、Adobe Analytics および Adobe Target ソリューションのアプリ分析およびターゲティング機能とのシームレスな統合を提供します。詳しくは、Adobe Mobile Services のドキュメントを参照してください。

Experience Cloud ソリューション用 Chromecast SDK 2.x を使用すると、JavaScript で記述された Chromecast アプリケーションを測定したり、Audience Management を使用してオーディエンスデータを利用および収集したり、ビデオハートビートを使用してビデオエンゲージメントを測定したりできます。

SDK の実装

  1. ダウンロードした Chromecast ライブラリをプロジェクトに追加します。

    1. AdobeMobileLibrary-Chromecast-[version].zip ファイルには、次のソフトウェアコンポーネントが含まれています。

      • を使用しますadbmobile-chromecast.min.js

        このライブラリファイルは、Chromecast アプリのソースフォルダーに含まれています。

      • ADBMobileConfig config

        アプリ用にカスタマイズされた SDK 設定ファイル。この SDK には、サンプルの ADBMobileConfig 実装が用意されています(samples/ / 内)。アドビの担当者から、適切な設定を入手してください。

    2. このライブラリファイルを index.html ファイルに追加し、以下のように ADBMobileConfig グローバル変数を設定します(Adobe Mobile for Heartbeats の設定に使用するこのグローバル変数には、mediaHeartbeat という排他的なキーが存在します)。

      <script>
          var ADBMobileConfig = {
            "marketingCloud": {
              "org": "972C898555E9F7BC7F000101@AdobeOrg"
            },
            "target": {
              "clientCode": "",
              "timeout": 5
            },
            "audienceManager": {
              "server": "obumobile5.demdex.net"
            },
            "analytics": {
              "rsids": "mobile5vhl.sample.player",
              "server": "obumobile5.sc.omtrdc.net",
              "ssl": true,
              "offlineEnabled": false,
              "charset": "UTF-8",
              "lifecycleTimeout": 300,
              "privacyDefault": "optedin",
              "batchLimit": 0,
              "timezone": "MDT",
              "timezoneOffset": -360,
              "referrerTimeout": 0,
              "poi": []
            },
            "mediaHeartbeat": {
              "server": "obumobile5.hb.omtrdc.net",
              "publisher": "972C898555E9F7BC7F000101@AdobeOrg",
              "channel": "test-channel-chromecast",
              "ssl": true,
              "ovp": "chromecast-player",
              "sdkVersion": "chromecast-sdk",
              "playerName": "Chromecast"
            }
          };
        </script>
      <script type="text/javascript" src="script/lib/adbmobile-chromecast.min.js"></script>
      
      重要

      mediaHeartbeat を誤って設定した場合、メディアモジュール(VHL)がエラー状態になり、トラッキングコールの送信が中止されます。

      mediaHeartbeat キーの ADBMobile 設定パラメーター:
      | 設定パラメーター | 説明     |
      | — | — |
      | server | バックエンドのトラッキングエンドポイントの URL を表す文字列。 |
      | publisher | コンテンツパブリッシャーの一意の ID を表す文字列。 |
      | channel | コンテンツ配信チャネルの名前を表す文字列。 |
      | ssl | SSL をトラッキングコールに使用するかどうかを示すブール値。 |
      | ovp | ビデオプレーヤープロバイダーの名前を表す文字列。 |
      | sdkversion | 現在のアプリケーションまたは SDK のバージョンを表す文字列。 |
      | playerName | プレーヤーの名前を表す文字列。 |

  2. Experience Cloud 訪問者 ID を設定します。

    Experience Cloud 訪問者 ID サービスは、Experience Cloud ソリューション全体に汎用の訪問者 ID を提供します。訪問者 ID サービスは、ビデオハートビートおよびその他の Experience Cloud 統合に必要です。

    ADBMobileConfig 設定ファイルに marketingCloud 組織 ID が含まれていることを確認します。

    "marketingCloud": {
        "org": YOUR-MCORG-ID"
    }
    

    Experience Cloud 組織 ID は、Adobe Experience Cloud 内の各クライアント企業を一意に識別するもので、016D5C175213CCA80A490D05@AdobeOrg のようになります。

    重要

    @AdobeOrg」が含まれている必要があります。

    設定が完了すると、Experience Cloud 訪問者 ID が生成され、すべてのヒットに含まれます。customautomatically-generated などの他の訪問者 ID は、引き続きヒットごとに送信されます。

    Experience Cloud 訪問者 ID サービスメソッド

    ヒント

    Experience Cloud 訪問者 ID メソッドのプレフィックスは visitor です。

    メソッド 説明
    getMarketingCloudID() 訪問者 ID サービスから Experience Cloud 訪問者 ID を取得します。

    ADBMobile.visitor.getMarketingCloudID();
    syncIdentifiers() Experience Cloud 訪問者 ID を使用して、各訪問者に関連付けることのできる追加の顧客 ID を設定できます。訪問者 API は、同じ訪問者に対して複数の顧客 ID と、異なる顧客 ID の範囲を区別するための顧客タイプ識別子を受け取ります。このメソッドは、JavaScript ライブラリの setCustomerIDs() に相当します。例:

    var identifiers = {};

    identifiers["idType"] = "idValue";

    ADBMobile.visitor.syncIdentifiers(identifiers);
  3. メディアをトラッキングするには、MediaDelegate プロトコルを実装します。

     var delegate = {
       // Replace <currentPlaybackTime> with the video player current playback time
       getCurrentPlaybackTime = function() {
         return <currentPlaybackTime>;
       },
       // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> with the current playback QoS values.
       getQoSObject = function() {
          return ADBMobile.media.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>);
       }
     }
    
     ADBMobile.media.setDelegate(delegate);
    }
    

このページ