Show Menu
トピック×

ビデオカスタムキュートラッカー:BrightCove 拡張機能ドキュメント

前提条件

各 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 のように異なる値を持つようにしてください。
ページに複数のビデオが含まれる場合、各ビデオで、そのページで実行される Launch ルールで設定された同じ設定が使用されることに注意してください。例えば、ビデオが 50%完了したときにイベントをトリガーするルールを作成した場合、ページ上の各ビデオで、50%のキューポイントに到達するとルールがトリガーされます。
この拡張機能と共に使用する予定の web ページで、Launch タグが完全に読み込まれる前にビデオを操作する可能性がある場合は、Launch ライブラリを同期的に読み込み、ページに埋め込まれたビデオの前に <script type="text/javascript">\_satellite.pageBottom();\</script\> タグを配置して、タイミングの問題を軽減します。ご参考までに、この拡張機能で使用される BrightCove API へのリンクは https://docs.brightcove.com/brightcove-player/1.x/Player.html#vjsplayer です。

データ要素

拡張機能内には 7 つのデータ要素がありますが、いずれもも設定は不要です。
  • Playhead Position: ​このデータ要素は、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 つの Launch ルールが存在します。トラックする各イベントに対して、特定の Launch ルールを作成します。つまり、ビデオの一時停止を追跡しない場合、ビデオの一時停止に対するルールは作成しません。
ルールには次の 3 つのアクションがあります。
  1. Adobe Analytics 変数を設定する(前述のデータ要素のすべてまたは一部に対するデータ要素を作成する)
  2. Adobe Analytics ビーコンを送信する
  3. Adobe Analytics 変数をクリアする
「Video Start」の Launch ルールの例
次のビデオ拡張機能オブジェクトが含まれます。
イベント :
  1. 「Video Start」(このイベントは、訪問者が BrightCove ビデオの再生を開始したときにルールを起動します)。
条件
None
アクション
  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」アクション
各ビデオ要素に対して複数の eVars や props をプロビジョニングしたくない場合は、Launch 内でデータ要素の値を連結し、分類ルールビルダー( https://docs.adobe.com/content/help/ja-JP/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html )で解析して分類レポートを作成し、Analysis Workspace でセグメントとして適用します。
これをおこなうには、「ビデオメタデータ」などの新しいデータ要素を作成し、プログラミングを使用してすべてのビデオデータ要素(上記)を取り込み、連結します。
var r = [];

r.push( \_satellite.getVar( &#39;Video ID&#39; ) );

r.push( \_satellite.getVar( &#39;Video Name&#39; ) );

r.push( \_satellite.getVar( &#39;Video Duraction&#39; ) );


return r.join(&#39;|&#39;);