BrightCove ビデオトラッキング拡張機能の概要

前提条件

各 Adobe Experience Platform Launch プロパティには、拡張機能画面でインストールおよび設定された次の拡張機能が必要です。

• Adobe Analytics
• Experience Cloud 訪問者 ID サービス
• コア拡張機能のインストール

https://ja.studio.support.brightcove.com/publish/choosing-correct-embed-code.html に従い、ビデオプレーヤーがレンダリングされる各 web ページの HTML で「ページ内埋め込みコード（詳細）」コードスニペットを使用します。関連項目：https://ja.studio.support.brightcove.com/players/generating-player-embed-code.html

この拡張機能バージョン 1.1.0 では、1 つの Web ページへの複数の BrightCove ビデオの埋め込みがサポートされていますが、高度な埋め込みタグ内の id プロパティが存在する場合は、player1、player2 のように異なる値を持つようにしてください。

ページに複数のビデオが含まれる場合、各ビデオで、そのページで実行される Platform Launch ルールに設定されたのと同じ設定が使用されることに注意してください。例えば、ビデオが 50％完了したときにイベントをトリガーするルールを作成した場合、ページ上の各ビデオで、50％のキューポイントに到達するとルールがトリガーされます。

この拡張機能と共に使用する予定の Web ページで、Platform Launch タグが完全に読み込まれる前にビデオを操作する可能性がある場合は、Platform Launch ライブラリを同期的に読み込み、ページに埋め込まれたビデオの前に <script type="text/javascript">\_satellite.pageBottom();\</script\> タグを配置して、タイミングの問題を軽減します。この拡張機能で使用される BrightCove API について詳しくは、https://docs.brightcove.com/brightcove-player/1.x/Player.html#vjsplayer を参照してください。

データ要素

拡張機能内には 7 つのデータ要素がありますが、いずれも設定は不要です。

• Playhead Position：​このデータ要素は、Platform Launch ルール内で呼び出されたときの、ビデオタイムライン上の再生ヘッドの位置を秒単位で記録します。
• Video Account ID：​このデータ要素は、ビデオを公開した Brightcove アカウントの ID を記録します。
• Video Duration：​このデータ要素は、ビデオコンテンツの合計時間（秒）を記録します。また、Analytics 内で計算指標を作成して、秒単位、分単位、時間単位で数値を変換できます。
• Video Ad Support：​このデータ要素は、広告がビデオ内でサポートされるかどうかを指定します。
• Video ID：​このデータ要素は、ビデオに関連付けられている BrightCove ID を指定します。
• Video Name：​このデータ要素は、ビデオのわかりやすい名前を指定します。
• Video Tags：​このデータ要素は、ビデオに関連付けられているタグを指定します。

イベント

拡張機能内では 7 つのイベントを使用できます。カスタムキューポイントトラッキングのみが設定を必要とします。

• Custom Cue Point Tracking：​このイベントは、ビデオが指定されたビデオしきい値の割合に達した場合にトリガーされます。例えば、60 秒のビデオで、指定したキューポイントが 50％の場合、イベントは 30 秒のマークでトリガーされます。このイベントは、このキューポイントに到達するたびにトリガーされることにご注意ください。例えば、ユーザーが 50％マークに到達し、50％マークより前のビデオを探してから、再び 50％マークに到達すると、もう一度トリガーされます。
• Video Completed：​このイベントは、ビデオが完全に完了したときにトリガーされます。
• Video Loaded Meta Data：​このイベントは、プレーヤーが初期時間とディメンション情報を受け取ったときに発生します。
• Video Pause：​このイベントは、ビデオが一時停止されたときにトリガーされます。
• Video Resume：​このイベントは、一時停止イベントの後にビデオコンテンツが再開された場合にトリガーされます。
• Video Screen Change：​イベントは、ビデオがフルスクリーンモードに切り替わったり、フルスクリーンモードから切り替えられたりしたときにトリガーされます。
• Video Start：​このイベントは、ビデオコンテンツの開始を初めて発生したときにトリガーされます。

用途

各ビデオイベント（上記の 7 つのイベント）に対して 1 つの Platform Launch ルールが存在します。トラックする各イベントに対して、特定の Platform Launch ルールを作成します。つまり、ビデオの一時停止を追跡しない場合、ビデオの一時停止に対するルールは作成しません。

ルールには次の 3 つのアクションがあります。

1. Adobe Analytics 変数を設定する（前述のデータ要素のすべてまたは一部に対するデータ要素を作成する）
2. Adobe Analytics ビーコンを送信する
3. Adobe Analytics 変数をクリアする

「Video Start」の Platform Launch ルールの例

次のビデオ拡張機能オブジェクトが含まれます。

イベント:

1. 「Video Start」（このイベントは、訪問者が BrightCove ビデオの再生を開始したときにルールを起動します）。

条件：

なし

アクション：

1. Analytics の「Set Variables」アクションで、次のように設定します。

   • Video Start のイベント（例：イベント 17）
   • ビデオ名データ要素​の prop／eVar（例：eVar10）
   • ビデオ期間データ要素​の prop／eVar（例：eVar11）
   • 現在のビデオ配置​データ要素の prop／eVar（例：eVar12）

2. Analytics の「Send Beacon」アクション（s.tl）

3. Analytics の「Clear Variables」アクション

var r = [];

r.push( \_satellite.getVar( 'Video ID' ) );

r.push( \_satellite.getVar( 'Video Name' ) );

r.push( \_satellite.getVar( 'Video Duraction' ) );


return r.join('|');