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

前提条件

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

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

https://developers.google.com/youtube/player_parameters ごとに、ビデオプレーヤーがレンダリングされる各 Web ページの HTML に、「タグを使用してプレーヤーを埋め込む」コードスニペットを使用します。

この拡張機能バージョン 1.0.1 では、iframe タグに一意の値を持つ id 属性を挿入し、?enablejsapi=1 を src 属性値の末尾に追加することで、1 つの 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>

この拡張機能により、id フィールドと enablejsapi=1 クエリ文字列のパラメーターが iFrame に動的に追加されるので、iFrame に手動で追加する必要はありません。

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

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

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

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

データ要素

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

• 再生ヘッドの位置： Launch ルール内で呼び出されたときの、ビデオタイムライン上の再生ヘッドの位置を秒単位で記録します。
• ビデオ ID： ビデオに関連付けられている YouTube ID を指定します。
• ビデオ名： ビデオのわかりやすい名前を指定します。
• ビデオの URL： 現在読み込まれている／再生中のビデオの YouTube.com URL を返します。
• ビデオの長さ： ビデオコンテンツの合計時間（秒）を記録します。

イベント

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

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

用途

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

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

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

「ビデオ開始」の Platform Launch ルールの例

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

イベント:

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

条件：なし

アクション：Analytics 拡張機能を使用して、次のことができます。

「変数を設定」アクションで、マッピングします。

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

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

ビデオ情報の値を連結するには、「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'));

return r.join('|');