YouTube ビデオトラッキング拡張機能の概要
前提条件
各 Adobe Experience Platform タグプロパティでは、次の拡張機能がインストールされ、拡張機能画面から設定されている必要があります。
- Adobe Analytics
- Experience Cloud 訪問者 ID サービス
- Core 拡張機能
の使用 「を使用したプレーヤーの埋め込み<iframe> tag" ビデオプレーヤーがレンダリングされる各 web ページのHTMLにあるGoogle開発者ドキュメントのコードスニペット。
この拡張機能バージョン 2.0.1 は、iframe script タグに一意の値を持つ id
属性を挿入し、src
属性値の末尾にまだ含まれていない場合は enablejsapi=1
と rel=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
属性の有無および enablejsapi
と rel
のクエリ文字列パラメーターが含まれているかどうかに関わらず、web ページに追加できます。
この拡張機能は、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 変数をクリアします。
「Video Start」のタグルールの例
次のビデオ拡張機能オブジェクトが含まれます。
-
イベント:「ビデオスタート」(このイベントは、訪問者がYouTube ビデオの再生を開始したときにルールを起動します)。
-
条件:なし
-
アクション:を使用します Analytics 拡張機能 「変数を設定」アクションをマッピングするには:
- ビデオ開始のイベント、
- ビデオデュレーションデータ要素の prop/eVar
- ビデオ ID データ要素の prop/eVar
- ビデオ名データ要素の prop/eVar
- ビデオ URL データ要素の prop/eVar
次に、「ビーコンを送信」アクション (
s.tl
)を選択し、リンク名「ビデオ開始」を選択して、その後に「変数をクリア」アクションを選択します。
ビデオ情報の値を連結するには、「ビデオメタデータ」という新しいデータ要素を作成し、(上記の)すべてのビデオデータ要素を取り込み、組み立てるようにプログラミングします。 例:
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('|');
Platform 内でデータ要素を効果的に作成および活用する方法について詳しくは、以下を参照してください データ要素 ドキュメント。