user の使用

このトピックでは、Analytics API を介してユニークユーザーに関するデータを取得する方法について学びます。

視聴者ID の送信 - Brightcove プレーヤー

必要条件

視聴者IDトラッキングには以下の要件が必要です:

  • Brightcove プレーヤー v7.18.0 またはそれ以降のバージョン

まず、ユーザーの視聴アクティビティを保存するために、ユーザー識別子を設定する必要があります。

Brightcove プレーヤー

Brightcove Player を使用している場合は、以下の手順に従ってください:

  1. 視聴者データは自動的に Brightcove アナリティクスに送信されますが、ユーザー識別子を設定する必要があります。 これを行うには、user() メソッドを使用します。 例えば:

    myPlayer.bcAnalytics.client.user('viewer id');

    Brightcove プレーヤー をホストする Web サイトでは、認証ゲートウェイまたは ID 管理ソリューションを使用して視聴者を追跡することができます。 この視聴者 ID を Brightcove アナリティクスに渡す視聴者 ID として使用します。

  2. プレーヤーにソースが設定される前に、視聴者ID を設定することが重要です。 これは、プレーヤーを初期化した直後に呼び出す必要があります。

    <video-js
          id="myPlayerID"
          data-account="1752604059001"
          data-player="hyQW6GByl"
          data-embed="default"
          controls=""
          data-video-id="6156696074001"
          data-playlist-id=""
          data-application-id=""
          width="640" height="360"></video-js>
        <script src="https://players.brightcove.net/1752604059001/hyQW6GByl_default/index.min.js"></script>
        
        <script>
          videojs.getPlayer('myPlayerID').ready(function() {
            var myPlayer = this;
        
            // Set the viewer id for Brightcove analytics
            myPlayer.bcAnalytics.client.user('viewer id');
          });
        </script>
  3. user() メソッドを使用すると、値はハッシュされず、後続のすべてのビーコンと一緒にクリアで送信されます。

    player_init イベントにはこの場合、user フィールドが含まれませんが、すべての video_* イベントには含まれることに注意してください。

カスタム ウェブ プレーヤー

Brightcove プレーヤー を使用しないカスタム実装を構築する場合は、データ収集 API リクエストに user パラメータを追加します。 詳細については、概要: Data Collection API v2 ドキュメントを参照して下さい。

プレーヤーをホストする Web サイトでは、認証ゲートウェイまたは ID 管理ソリューションを使用して視聴者をトラッキングすることができます。 この視聴者 ID を Brightcove アナリティクスに渡す視聴者 ID として使用します。

Brightcove に渡されたこの user パラメータは、次のセクションで XDR API から再生位置を取得するために使用できます。