Google アナリティクスの自己設定

このトピックでは、Brightcoveにこの処理を許可できない、またはさせない場合に、Brightcove Player の Google アナリティクスプラグインを設定する方法について説明します。

以下の 重要な 項目に注意して下さい:

Brightcove Player Google アナリティクスプラグインの最新バージョンであるバージョン 2.1.x 以降は、Google アナリティクス 4（「新バージョン」）をサポートします。
このプラグインを使用するには、Brightcove Player バージョン 7.x およびそれ以降のバージョンを使用する必要があります。
Googleユニバーサルアナリティクス（以下、旧バージョン）は、2023年7月1日にサービス終了となります。
このドキュメントでは、ユニバーサルアナリティクスの設定に焦点を当てます。
Googleアナリティクス 4 またはGoogleアナリティクス 4 とユニバーサルアナリティクスの両方を設定する場合は, Google アナリティクスプラグインのドキュメントを参照して下さい。

はじめに

設定作業は、以下の作業で構成されています:

Brightcove Playerでサポートされているイベントの中からトラッキングしたいものを選択します。
Google アナリティクスプラグインでサポートされているカスタムディメンションから、使用したいものを選択します。
In Google アナリティクスで、選択したカスタムディメンションを作成します。
Video Cloud Studio で, Google アナリティクスプラグイン用の設定情報を追加します。プレーヤーのJSONエディタを使用してこれを実行します。

イベントの選択

JSONの設定では、トラッキングしたいイベントをリストアップします。次のうち、どれをトラックングするかを決めます:

player_load
video_engagement
video_impression
play_request
ad_start
ad_end
error
video_view
video_complete

カスタムディメンションを選択

Google アナリティクスのデータで使用するカスタムディメンションは8種類あり、その中から選択する事ができます。次のうちどれを使用するかを決めて下さい:

bcvideo_account
bcvideo_platform_version
bcvideo_player
bcvideo_range
bcvideo_session
bcvideo_tags
bcvideo_video_duration
bcvideo_video_seconds_viewed

カスタムディメンションの作成

使用するカスタムディメンションをそれぞれ作成する必要があります。Googleが提供するドキュメントの手順で、このプロセスを説明します: カスタムディメンションとカスタム指標の設定と編集.

各カスタムディメンションの作成時に、Scope を選択するように求められます。これらのカスタムディメンションでは、Hit という値を使用します。また、各カスタムディメンジョンを作成すると、このスクリーンショットに示すように、インデックス（シーケンス）番号がそれに関連付けられます:

JSON 設定にインデックス番号が必要なため、作成したカスタムディメンションのテーブルを利用できるようにしておく必要があります。

ディメンジョンを作成する際に、より親しみやすい名前を選択することができます。例えば、次のように考えてください:

bcvideo_video_duration のカスタムディメンションを作成する際に、レポートに分かりやすい名前を使用したい為、単に Duration と名付ける事ができます。
作成時、Duration に関連するインデックスは 7です。
JSON 設定では、次のように割り当てています:
```
"bcvideo_video_duration": "dimension7"
```
インデックス番号は、分かりやすい名前とプラグインの内部名称を関連付けています。

プレーヤーに JSON 設定を追加する

使用するイベント、使用するカスタムディメンションについて決定し、後者を作成しました。これで、プレーヤーの設定に含めるJSONを構成する準備が整いました。

以下の例で、各論理的なコード群を説明する表を示します。このガイドに従って、独自のJSONを構成することができます。

ライン	詳細
1,19	プラグイン設定に関する全ての情報のためのJSONバウンダリ
2-3	プラグインとバージョンの定義
4,18	プラグインの `options` 定義のためのJSONバウンダリ
5,11	カスタム定義のJSONバウンダリ
6-10	作成したカスタムディメンションを定義します。ディメンション名、コロン、 dimension という文字列の後に、カスタム定義の作成時に割り当てられたインデックス番号を使用します。
12,16	トラッキングすると選択したイベントのJSONバウンダリ
13-15	上記のイベントの選択セクションから、トラッキングすると選択したすべてのイベント
17	Googleアナリティクスがユーザーに割り当てるトラッカーID

{
  "registry_id": "@brightcove/videojs-bc-ga",
  "version": "1.x",
  "options": {
    "paramsToTrack": {
      "bcvideo_video_seconds_viewed": "dimension1",
      "bcvideo_range": "dimension2",
      "bcvideo_video_duration": "dimension3",
      "bcvideo_player": "dimension4",
      "bcvideo_session": "dimension5"
    },
    "eventsToTrack": {
      "video_impression": "Video Impression",
      "play_request": "Play Request",
      "video_engagement": "Video Engagement"
    },
    "tracker": "UA-123456-1"
  }
}

JSON 設定が完成したら、次の手順で Brightcove Player の設定に貼り付けます:

Video Cloud Studioにログインします。
PLAYERS モジュールに移動し、新しい設定を追加するプレーヤーをクリックします。
左のナビゲーションからJSON エディター をクリックします。

すでにプレーヤー用のプラグインが設定されている場合は、そのセクションにコードを貼り付けることができます。そうでない場合は、プラグイン用のJSONをいくつか追加する必要があります。いずれの場合も、記述した結果は以下のようになります。プレーヤー情報とJSONはユーザー独自のものを使用します（プラグイン用のJSON設定は黄色でハイライトされています）:

{
  "compatibility": true,
  "video_cloud": {
  "policy_key":
     "BCpkADawqM2w1K7269Ic17hjK0O2-ibj221pVcELpF1l5nZuiL-123456789123456789"
  },
  "player": {
    "template": {
      "name": "single-video-template",
      "version": "6.48.5"
    }
  },
  "plugins": [
    {
      "registry_id": "@brightcove/videojs-bc-ga",
      "version": "1.x",
      "options": {
        "paramsToTrack": {
          "bcvideo_video_seconds_viewed": "dimension1",
          "bcvideo_range": "dimension2",
          "bcvideo_video_duration": "dimension3",
          "bcvideo_player": "dimension4",
          "bcvideo_session": "dimension5"
        },
        "eventsToTrack": {
          "video_impression": "Video Impression",
          "play_request": "Play Request",
          "video_engagement": "Video Engagement"
        },
        "tracker": "UA-123456-1"
      }
    }
  ]
}

変更を保存してプレーヤーを公開すれば、Google アナリティクスプラグインの準備完了です。

ページコンテンツ