ドキュメントExperience Platformタグ

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

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

前提条件

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

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

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

この拡張機能バージョン 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 ページに追加できます。

NOTE
ページに複数のビデオが含まれる場合、各ビデオで、そのページで実行されるタグルールに設定されたものと同じ設定が使用されることに注意してください。例えば、ビデオが 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 変数をクリアします。

「Video Start」のタグルールの例

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

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

  • 条件：なし

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

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

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

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

ビデオ情報の値を連結するには、「ビデオメタデータ」という新しいデータ要素を作成し、（上記の）すべてのビデオデータ要素を取り込み、組み立てるようにプログラミングします。 例：

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 内でデータ要素を効果的に作成および活用する方法について詳しくは、 データ要素ドキュメントを参照してください。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743