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

メモ

Adobe Experience Platform Launch は、Adobe Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。 その結果、製品ドキュメント全体でいくつかの用語の変更がロールアウトされました。用語の変更点の一覧については、次のドキュメントを参照してください。

前提条件

Adobe Experience Platform Launch の各タグプロパティでは、次の拡張機能がインストールされ、拡張機能画面から設定されている必要があります。

  • Adobe Analytics
  • Experience Cloud 訪問者 ID サービス
  • Core 拡張機能

ビデオプレーヤーがレンダリングされる各 web ページの HTML にある Google 開発者ドキュメントから「<iframe> タグを使用してプレーヤーを埋め込む」コードスニペットを使用します。

この拡張機能バージョン 2.0.1 は、iframe script タグに一意の値を持つ id 属性を挿入し、src 属性値の末尾にまだ含まれていない場合は enablejsapi=1rel=0 を付加することで、単一の Web ページに 1 つ以上の YouTube 動画を埋め込むことができます。次に例を示します。

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

この拡張機能は、enablejsapi および rel のクエリ文字列パラメーターが存在するかどうか、およびそれらの期待値が正しいかどうかに関係なく、player1 などの一意の ID 属性値を動的に確認するようにも設計されています。その結果、YouTube スクリプトタグは、id 属性の有無および enablejsapirel のクエリ文字列パラメーターが含まれているかどうかに関わらず、web ページに追加できます。

メモ

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

この拡張機能は、iFrames を書き換えるために次のロジックに依存します。

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

したがって、ページが読み込まれると、わずかにちらつきが発生します。この動作は期待されたとおりです。

データ要素

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

  • 再生ヘッドの位置:​タグルール内で呼び出されたときの、ビデオタイムライン上の再生ヘッドの位置を秒単位で記録します。
  • ビデオ ID: ビデオに関連付けられている YouTube ID を指定します。
  • ビデオ名: ビデオのわかりやすい名前を指定します。
  • ビデオの URL: 現在読み込まれている/再生中のビデオの YouTube.com URL を返します。
  • ビデオの長さ: ビデオコンテンツの合計時間(秒)を記録します。
  • 拡張機能バージョン: このデータ要素は、例えば「Video Tracking_YouTube_2.0.0」などの YouTube トラッキング拡張機能バージョンを記録します。

イベント

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

  • ビデオ準備完了: ビデオがキューに入り、再生の準備ができたときにトリガーされます。
  • ビデオ開始: ビデオが最初に開始されたときとplayer.getCurrentTime() === 0 ときにトリガーされます
  • ビデオ再生: ビデオがキューに入ったときにトリガーされ、最初の開始の後に再生されます。このトリガーは、すべてのリプレイで実行されます。
  • ビデオ一時停止: ビデオが一時停止されたときにトリガーされます。
  • ビデオ再開: ビデオが再開されたとき、および player.getCurrentTime() !== 0 ときにトリガーされます
  • カスタムキュートラッキング: ビデオが指定されたビデオしきい値の割合に達した場合にトリガーされます。例えば、ビデオが 60 秒で、指定したキューポイントが 50%の場合、再生ヘッドの位置が 30 秒になるとイベントがトリガーされます。キューポイントトラッキングは、初期再生とリプレイの両方に適用されます。ユーザーがキューポイントを超えてシークした場合、イベントは実行されません。キューポイントイベントは、再生ヘッドがタイムライン上の計算されたキューポイントの場所を越え、ビデオプレーヤーが再生中の場合にのみ実行されます。
  • ビデオバッファ: プレーヤーが一定量のデータをダウンロードしてからビデオの再生を開始した場合にトリガーされます。
  • ビデオ終了: ビデオが完全に完了した場合にトリガーされます。

用途

各ビデオイベント(上記の 7 つのイベント)に対して 1 つのタグルールを設定できます。トラックする各イベントに対して、特定のタグルールを作成します。イベントを追跡しない場合は、単純にルールの作成を省きます。

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

  • 変数を設定: Adobe Analytics 変数を設定します(含まれるすべてのまたは一部のデータ要素にマップ)。
  • ビーコンを送信: Adobe Analytics ビーコンをカスタムリンクトラッキングコールとして送信し、「リンク名」の値を指定します。
  • 変数をクリア: Adobe Analytics 変数をクリアします。

「ビデオスタート」のタグルールの例

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

  • イベント:「ビデオスタート」(このイベントは、訪問者が YouTube ビデオの再生をスタートしたときにルールを起動します)。

  • 条件:なし

  • アクションAnalytics 拡張機能​を使用して「変数を設定」アクションを実行し、次のようにマッピングします。

    • ビデオ開始のイベント、
    • ビデオデュレーションデータ要素の prop/eVar
    • ビデオ ID データ要素の prop/eVar
    • ビデオ名データ要素の prop/eVar
    • ビデオ URL データ要素の prop/eVar

    次に、「ビーコンを送信」アクション(s.tl)をリンク名「ビデオスタート」と共に追加し、その後に「変数をクリア」アクションを続けます。

ヒント

各ビデオの要素に対して複数の eVar または prop を使用できない実装では、Platform 内でデータ要素の値を連結します。https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?lang=ja で説明されているように、分類ルールビルダーツールを使用して解析し、分類レポートを作成後、Analysis Workspace でセグメントとして適用できます。

ビデオ情報の値を連結するには、「Video Meta Data」という新しいデータ要素を作成し、プログラムしてすべてのビデオデータ要素(上記を参照)を取り込み、それらをまとめます。 次に例を示します。

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));

return r.join('|');

このページ