Brightcove Player 向け Google Tag Manager プラグイン

概要

Google Tag Manager（GTM）を使用すると、ウェブサイト、動画コンテンツ、モバイルアプリの利用状況を追跡できます。まず、コンテナタグをアセットに追加します。次に、ウェブベースのユーザーインターフェイスを使用して、ビジネスルールに基づきコンテナタグに関連付けられた個々のタグをカスタマイズします。

タグの例をいくつか示します:

Google Analytics 4 トラッキングコード
Adwords リマーケティングおよび／またはコンバージョントラッキングコード
カスタム HTML スクリプト

GTM が初めての方は、Google の Tag Manager の概要ドキュメントをご確認ください。

すでに Google Analytics、Adwords、DoubleClick を使用している場合、それらのツールとうまく連携できる Google Tag Manager の利用もご検討ください。GTM は多数の変数およびトリガーオプションを提供します。

ワークフロー

GTM プラグインはまず eventsToTrack および trackerID の存在を確認したうえで GTM を初期化します。次に、analytics-beacons または analytics_request イベントをリッスンしてすべてのプレーヤーイベントを監視し、各プレーヤーイベントについてそのイベントが追跡対象イベントのリストに含まれているかを確認します。含まれている場合、プラグインはそのイベントに関連付けられたカスタムディメンション（paramsToTrack に含まれているもの）を取得します。GA プラグインで処理されるイベントおよび関連するカスタムディメンションの詳細については、イベント、ディメンション、変数の確認を参照してください。

主な実装手順

GTM を実装して使用するには、概要として以下の主要な手順に従う必要があります:

GTM アカウントを作成し、コンテナをセットアップする - これらは GTM の初期セットアップの一部です
ウェブページに実装する必要のあるコンテナスニペットをコピーして貼り付けます。Google は、このコードを <head> タグ内、または <body> 開始タグの直後に配置することを推奨しています
タグを作成する - Google Analytics または Brightcove Player 用
タグが動作することを確認する
タグを公開する

セットアップの詳細については、Google の Tag Manager のセットアップとインストールドキュメントを参照してください。

Brightcove Player との連携

Brightcove の GTM プラグインを使用すると、Google Analytics ダッシュボードで Brightcove Player のイベントを追跡できます。追跡可能なプレーヤーイベントは次のとおりです:

プレーヤーロード
動画インプレッション
動画ビュー
動画エンゲージメント
再生リクエスト
ad_mode_begin、ad_mode_complete などの高度なプレーヤーイベント
再生体験を妨げるエラー

タグ管理用語

Google Tag Manager（GTM）を使用する際によく出てくる用語をいくつか紹介します。

用語	説明
Container	タグ管理システムのアカウントには複数のコンテナ（プロファイル）を持たせることができ、それぞれが独自のタグおよび変数を持ちます。各コンテナには通常、開発、ステージング、本番用に複数の環境を設定できます。
Data layer	データレイヤーとは、ウェブページのコード内に存在するデータの集合体です。この JavaScript オブジェクトは、ウェブサイトからタグマネージャーコンテナへ情報を渡すために使用されます。タグ設定内で、この情報を使用して変数を入力したり、トリガーをアクティブ化したりできます。
Event	イベントは、レポーティングツールにデータを送信するために使用されるデータポイントです。これらは動画の読み込みおよび再生に関連しています。
Tag	タグは、ユーザーインタラクションのデータを収集するためにウェブページに配置されるコードスニペットです。タグ管理システムはサイトへのタグ追加プロセスを簡素化し、タグ ID およびタグイベントタイプを指定するだけで済むようにします。
Tag marketplace	タグマーケットプレイスのテンプレートは、タグをデプロイするためのコードスニペットを提供します。これにより必要なコード知識は減りますが、実装を成功させるには JavaScript および HTML に関する一定の知識が必要です。
Tracker	トラッカーは、データを収集・保存し、Google Tag Manager に送信するオブジェクトです。
Trigger	トリガーは、タグのコードをページに追加するタイミングを指示します。これらはユーザーが定義する条件です。

要件

GTM プラグインを使用するには、以下の要件が必要です:

Brightcove Player v6.46.0 以降。
Google Tag Manager プラグインでは、プレーヤーを公開する際に JavaScript（旧称: Advanced）埋め込みコードを使用する必要があります。このプラグインでは iframe 埋め込みコードを使用しないでください。詳細については、Brightcove との統合セクションを参照してください。

イベント、ディメンション、変数の確認

Brightcove Player から追跡したいイベントおよびディメンションを選択します。

Events

Brightcove Player の analytics-beacon イベントで使用される任意のイベント名を使用できますが、以下のイベントは GTM プラグイン内で特別に処理されます。

イベント	説明
`player_load`	プレーヤーがロードされ、操作可能になりました
`video_impression`	動画がプレーヤーにロードされ、再生可能な状態になりました
`video_view`	自動再生またはユーザー操作によって動画の再生が開始されました
`video_engagement`	ユーザーが動画タイムライン上の一定範囲の秒数を視聴します。このイベントは動画エンゲージメントを追跡するためのハートビートであり、ユーザー操作や動画の長さに応じて、再生中に何度も送信される可能性が高いです。
`play_request`	ユーザーが明示的に再生ボタンをクリックするか、自動再生シナリオでプラットフォームが再生をトリガーすることで、再生が開始されます
`ad_mode_begin`	再生プラットフォームから広告エージェントへ制御が引き渡されます
`ad_mode_complete`	広告エージェントから再生プラットフォームへ制御が戻されます
`error`	再生体験を妨げる致命的なエラーが発生しました
`video_complete`	動画の再生が終了します注: このイベントは Player 6 でのみ取得可能であり、Player 7 以降では使用できません。

Dimensions

以下のディメンションは、すべてのイベント（error を除く）で送信されます

パラメーター	説明
`bcvideo_account`	Video Cloud Studio アカウント ID
`bcvideo_destination`	再生場所
`bcvideo_platform_version`	Brightcove Player のバージョン
`bcvideo_player`	Brightcove Player ID
`bcvideo_player_name`	Brightcove Player 名
`bcvideo_session`	プレーヤーに関連付けられたセッション
`bcvideo_video`	動画 ID
`bcvideo_video_name`	動画名
`bcvideo_tags`	動画に関連付けられたタグの一覧

イベント固有のディメンション

これらのカスタムディメンションは特定のイベントで送信されます。

パラメーター	説明
`bcvideo_video_playhead`	`play_request` および `engagement` イベントで送信されます
`bcvideo_video_duration`	`engagement` イベントで送信されます
`bcvideo_range`	`engagement` イベントで送信されます
`bcvideo_video_percent_viewed`	`engagement` イベントで送信されます
`bcvideo_video_seconds_viewed`	`engagement` イベントで送信されます
`bcvideo_video_milestone`	`engagement` イベントで送信されます

GTM 変数

これらは GTM 変数として作成できる Brightcove のパラメーターです。

変数名	説明
`account`	Brightcove アカウント ID
`player`	プレーヤー ID
`player_name`	プレーヤー名
`platform_version`	プラットフォームのバージョン番号
`session`	セッション識別子
`video`	動画 ID
`video_name`	動画の名前
`range`	StartSecond..EndSecond の形式で視聴された秒数の範囲
`seconds_viewed`	視聴秒数のカウント
`duration`	動画の長さ（秒）
`percent_viewed`	動画の視聴割合
`error`	イベントに関連付けられたプラットフォーム固有のエラーコード
`milestone`	動画で完了したマイルストーン（25%、50%、75%、100%）
`playhead`	イベントが発生した動画内の時刻
`destination`	イベントが発生した URI

Google Tag Manager のセットアップ

Google Tag Manager をセットアップするには、次の手順に従います:

手順

Tag Manager でアカウントを作成するか、既存のアカウントを使用します。新しいアカウントを作成するには、Create Account ボタンをクリックします。

デフォルトでは、新規アカウントには新しいコンテナが作成されます。各アカウント内に追加のコンテナを作成できます。

Create account
アカウント名およびコンテナ名を含む新規アカウントページの値を入力し、対象プラットフォームを選択します。

New account information
Create ボタンをクリックします。
利用規約に同意します。

トリガー、変数、タグの作成

追跡したい Brightcove のイベントは、すべて Google Tag Manager（GTM）でイベントタグとして作成する必要があります。GTM のイベント ID は、その後 Players モジュール内で使用されます。これにより、Brightcove のイベントデータを GTM のイベントに渡すことができます。

各イベントタグについて、Google Analytics へイベントを送信するための GTM トリガーを作成する必要があります。次に、GTM の Variables タブで、各イベントに関連付けられたカスタムパラメーターを作成します。

前提条件

まず、Google Analytics: GA4 Event 型のタグを追加するために、Google Tag タイプのタグを 1 つ追加する必要があります。手順は次のとおりです:

Tag Type で Google Tag を追加します。

google-tag

Google tag found in this container というメッセージが表示されることを確認します。この手順を忘れると、ネガティブなメッセージが表示されます。

google-tag-success

GTM へのトリガーの追加

追跡したいイベントを決定したら、Google Tag Manager でトリガーを作成します。

Google Tag Manager でトリガーを作成するには、次の手順に従います:

Google Tag Manager アカウントにログインします
左側のナビゲーションで Triggers をクリックし、New ボタンをクリックします

Create a new trigger
Trigger Configuration ボックスをクリックします

Trigger Configuration
Trigger Type として Custom Event を選択します。

Trigger configuration
Event name を入力します。イベント名は以下の画像のようになります。

Trigger configuration name
追跡したい各イベントに対してトリガーを作成します。
GTM 上のトリガーは次のように表示されます:

Triggers in GTM

GTM への変数の追加

Brightcove のパラメーターは追加のデータを保持し、イベントとともに渡されます。記録される Brightcove のパラメーターは、すべて Google Tag Manager の変数として作成する必要があります。パラメーター名はプレーヤー内で使用され、Brightcove のパラメーターを Google Tag Manager の変数に渡せるようになります。

Google Tag Manager で変数を作成するには、次の手順に従います

Google Tag Manager アカウントにログインします
左側のナビゲーションで Variables をクリックします。
User-Defined Variables セクションで New ボタンをクリックします

Data Layer Variable
Variable Configuration ボックスをクリックします

Variable Configuration
variable type には Data Layer Variable を選択します。

Data Layer Variable
設定の詳細は次のとおりです:
- Data Layer Variable Name - 変数の名前
- Data Layer Version - Version 2
次に、Brightcove のパラメーターを反映する変数を作成します。この場合、Data Layer Variable の名前は、GTM 変数の customDimensions 配下の paramsToTrack としてプレーヤーの JSON 設定に記述されている値と一致する必要があります。GTM 変数として作成できる Brightcove パラメーターの一覧については、こちらを参照してください。以下に例を示します:

Account variable
GTM 上のユーザー定義変数は次のように表示されます:

User-defined variables

GTM へのタグの追加

追跡したい各イベントについて、Google Tag Manager でタグを作成する必要があります。

Google Tag Manager でタグを作成するには、次の手順に従います

Google Tag Manager アカウントにログインします
左側のナビゲーションで Tags をクリックし、New ボタンをクリックしてから Tag Configuration をクリックします。

Create a new tag
Tag Configuration ボックスをクリックします

Tag Configuration
Google Analytics を選択します。

Tag configuration
Tag Type として Google Analytics: GA4 Event を選択します。

Tag configuration
タグの詳細を入力します:
- Measurement ID - 「G-」の ID を入力するか、変数を選択します。
- Event Name - イベントの名前を指定します。
- ウェブサイトに対してユーザーが提供するデータからより多くのインサイトを取得したい場合は、user-provided data オプションをオンのままにします。
オプション設定:
- Parameters - Fields to Set で設定するパラメーターを追加します。
- Custom properties - User Properties で設定するカスタムユーザープロパティを追加します。
以下に例を示します:

Tag configuration
次に、Triggering ボックスをクリックします

Triggering
タグを発火させるための対応するトリガーを選択します。

Trigger
GTM 上のタグは次のように表示されます:

Tags in GTM

Brightcove との統合

GTM を Brightcove Player と統合するには、Google Tag Manager プラグインをプレーヤーに追加します。

Studio の使用

以下の手順では、Video Cloud Studio を使用してプラグインをロードする方法を詳しく説明します。

Video Cloud Studio で PLAYERS モジュールを開き、新しいプレーヤーを作成するか、プラグインを追加したいプレーヤーを見つけます。
そのプレーヤーへのリンクをクリックして、プレーヤーのプロパティを開きます。
Overview タブの Plugins セクションを展開します。
次に、Add Plugin ボタンをクリックして、Brightcove Plugin を選択します。

Add Plugin button
Brightcove Plugin ドロップダウンを展開し、Google Tag Manager を選択します。

Google Tag Manager plugin
追跡したいイベントとカスタムディメンションをプレーヤーに伝えるには、Options(JSON) テキストボックスに貼り付ける JSON オブジェクトを作成します。

フィールドの説明:
- tracker - Google Tag Manager のトラッキング ID（GTM-XXXXXXX）
- eventsToTrack - 追跡したいイベント
- paramsToTrack - 追跡したいカスタムディメンション
- milestones - デフォルトの 25、50、75、100% からマイルストーンを変更するための整数の配列。これは bcvideo_video_milestone が追跡されている場合にのみ適用されます。
イベントおよびディメンションの完全なリストについては、イベントとディメンションの確認セクションを参照してください。

以下に例を示します:
```
 {
  "tracker":"your Google Tag Manager id",
  "eventsToTrack": {
    "ad_mode_complete": "Ad Mode Complete",
    "ad_mode_begin": "Ad Mode Begin",
    "error": "Error",
    "play_request": "Play Request",
    "player_load": "Player Load",
    "video_complete": "Video Complete",
    "video_engagement": "Video Engagement",
    "video_impression": "Video Impression",
    "video_view": "Video View"
  },
  "paramsToTrack": {
    "bcvideo_video_duration": "duration",
    "bcvideo_error_code": "error",
    "bcvideo_account": "account",
    "bcvideo_session": "session",
    "bcvideo_video_milestone": "milestone",
    "bcvideo_video_name": "video_name",
    "bcvideo_range": "range",
    "bcvideo_video_seconds_viewed": "seconds_viewed",
    "bcvideo_player_name": "player_name",
    "bcvideo_video_percent_viewed": "percent_viewed",
    "bcvideo_destination": "destination",
    "bcvideo_video_playhead": "playhead"
  }
 }
```
JSON オブジェクト内のカスタムディメンションが、Google Analytics 内の名前およびインデックスと一致していることを確認してください。
これで、Google Tag Manager プラグインがプレーヤーのプラグイン一覧に表示されます。
プレーヤーを公開するには、 Publish Changes を選択します。
ダイアログを閉じるには、Close をクリックします。
MEDIA モジュールに戻り、Google Tag Manager 用に更新したばかりのプレーヤーを使用して動画またはプレイリストを公開します。プレーヤーを公開するには JavaScript 埋め込みコードを選択します。

Google Tag Manager プラグインでは、プレーヤーを公開する際に JavaScript 埋め込みコードを使用する必要があります。このプラグインでは iframe 埋め込みコードを使用しないでください。

JavaScript embed code
プレーヤーがロードされ、ユーザーがプレーヤーを操作すると、指定したイベントおよびパラメーターが追跡されます。

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

カスタムディメンションは、Google Analytics で自分自身が作成する指標です。Google Analytics の UI でカスタムディメンションを作成するには、次の手順に従います:

Google Analytics アカウントにログインします。
GA ページで:
1. UI 左下の Admin（歯車アイコン）をクリックします。
2. Property 列で Custom Definitions をクリックします。
Create custom dimension をクリックします。
必要な情報をフィールドに入力します:
- Dimension name: パラメーターのわかりやすい名前。
- Scope: Brightcove GA プラグインでは常に Event です。
- Description: 適切な説明を追加します。
- Event parameter: 上記のパラメーターのうちいずれかを選択します。

Google Analytics UI の使用に関する詳細については、以下を参照してください:

次世代の Analytics、Google Analytics 4 のご紹介
ウェブサイトおよび／またはアプリの Analytics をセットアップする
Google Analytics 4 プロパティを追加する（既に Analytics を使用しているサイトに対して）
[GA4] カスタムディメンションと指標: イベントパラメーターおよびユーザープロパティからディメンションと指標を作成して、レポートおよび探索でデータに簡単にアクセスできるようにします

カスタムディメンションの表示

Google Analytics でカスタムディメンションを表示するには、次の手順に従います:

Google Analytics にログインします。
Admin をクリックします

Analytics admin
Custom Definitions をクリックします

Custom dimensions
カスタムディメンションが表示されるはずです。

Dimensions