Adobe Heartbeatタグの構成ガイド

動作原理

Adobe Heartbeatタグを使用すると、サイト上のビデオとの相互作用に関する詳細なデータを収集することができます。ビデオがページに読み込まれると、Heartbeatはビデオの長さにわたって毎秒サーバーコールをトリガーし、再生位置、一時停止と再開のアクション、広告の表示など、さまざまなビデオのパフォーマンスパラメータをキャプチャします。さらに、実装がNielsen DCRプラグインと統合されている場合、これらのパラメータをこのタグで一緒に構成することができます。

前提条件

• jQuery
  サイトにjQueryがインストールされていることを確認してください。jQueryを使用していない場合は、Tealium iQタグマーケットプレイスから新しいjQueryタグを追加および構成することができます。
• Adobe Enterprise Cloud IDサービスタグ
  Adobe Cloud Serviceは、サイト上のすべての訪問に対して一意のIDを生成し、すべてのEnterprise Cloud SolutionsでIDを永続化するため、重複カウントを防止します。プロファイルにタグを追加および構成し、タグのバンドルフラグ構成を有効にして、すべてのページでutag.jsにバンドルできるようにします。
• AppMeasurement JavaScriptタグ
  同じプロファイルにタグを追加および構成し、バンドルフラグを有効にします（まだ行っていない場合）。これはJavaScriptの実装に必要です。バンドルはTagバージョン1.6.3にのみ必要であり、以前のバージョンではEnterprise Cloud Serviceがデフォルトでバンドルされています。

タグタブで、バンドルされたEnterprise Cloud IDタグがバンドルされたAppMeasurementタグの上に配置されていることを確認してください。これにより、Enterprise Cloud IDタグが最初に読み込まれます。

サポートされているベンダーライブラリ

• Adobe Heartbeat v2.0.2（デフォルト）
• Adobe Heartbeat v1.6.7
• Adobe Heartbeat v1.6.7とNielsen v5.0の統合

タグのヒント

• Heartbeatは、Adobe Experience Cloud IDサービスとAppMeasurement for JSが最初にロードされていることが必要です。バンドルされていることが望ましいです。
• このタグは、「utag.track（‘video’、data）;」を使用して発火します。これは、ビデオのイベントハンドラに実装する必要があります。
• Adobe HeartbeatではjQueryが必要です。

タグの構成

まず、Tealiumのタグマーケットプレイスに移動し、Adobe Heartbeatタグを追加します（タグの追加方法について詳しくはこちら）。

タグを追加した後、次の構成を構成します：

フィールド名	フィールド値
タイトル	必須。 タグを識別するための一意の名前を入力します。 このタグの複数のインスタンスを追加する場合に重要です。
トラッキングサーバー	必須。 Adobe Heartbeatトラッキングサーバー。 Heartbeatトラッキングコールが送信されるサーバーのURLを入力します。 URLがない場合は、Adobeの担当者に連絡してください。 例：.hb.omtrdc.net
パブリッシャー	必須。 Adobe Heartbeatパブリッシャー。 Adobeの担当者によって割り当てられたパブリッシャー名を入力します。
SSLを使用する	このフラグは、HeartbeatコールをHTTPS経由で送信するかどうかを決定します。 デフォルト値は「False」で、SSLは無効になっています。 トラッキングコールを安全に送信する場合は、値を「True」に切り替えることができます。
S-Object名	必須。 独自のカスタムs-object変数名を構成します。 わからない場合は、デフォルト値のsを使用してください。
ビデオプラットフォーム名	オプション。 コンテンツが配信されるオンラインビデオプラットフォームの名前。
ビデオプレーヤーSDK	オプション。 ビデオプレーヤーアプリ/SDKのバージョン。
タグバージョン	このドロップダウンリストでは、Nielsen統合の有無を含むAdobe Heartbeatトラッキングを選択できます。 利用可能なオプションは次のとおりです： Adobe Heartbeat 2.0.2（デフォルト） Adobe Heartbeat 1.6.7 Adobe Heartbeat 1.6.7 with Nielsen 5.0

次のフィールドは、タグバージョンをAdobe Heartbeat 1.6.7 with Nielsen 5.0に構成した場合にのみ必要です。必要なNielsenの値がない場合は、NielsenまたはAdobeの担当者に連絡してください。

フィールド名	フィールド値
Adobe Nielsen SDK構成キー	Nielsenのために必要です。 Nielsen統合に使用するNielsen構成キーを入力します。
Nielsenコレクション環境	Nielsenのために必要です。 コレクション環境の場所。 Nielsenのコレクション環境の場所を入力します。 例：eu-certまたはeu。
NielsenプレーヤーID	Nielsenのために必要です。 ビデオプレーヤーに割り当てられた一意の識別子を入力します。 Nielsenによって提供されるプレーヤー/サイトに割り当てられた一意のIDです。
Nielsen APN	Nielsenのために必要です。 プレーヤー/サイトの説明を入力します。 プレーヤー/サイトを説明するためのユーザー定義の文字列値です。
NielsenクライアントID	Nielsenのために必要です。 Nielsenクライアント識別子を入力します。 VA Beacon Measurementの一意のIDです。
Nielsen VCID	Nielsenのために必要です。 ビデオチャンネル識別子を入力します。 VA Beacon Measurementの一意のIDです。

ロードルールの適用

ロードルールは、サイト上の特定のページでこのタグのインスタンスをいつ、どこにロードするかを決定します。ロードルールは、デフォルトのロードルールである「すべてのページでロード」ルールです。特定のページでこのタグをロードするには、タグに適用するための関連するルール条件を作成します。

ベストプラクティス：ビデオが利用可能なすべてのページでこのタグをロードするために、カスタムルールを作成して適用します。

データマッピング

マッピングは、データレイヤ変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。変数をタグの宛先にマッピングする方法についての手順については、データマッピングを参照してください。

次のセクションでは、各利用可能なカテゴリに対する詳細なテーブルを提供します。

標準

標準カテゴリは、タグの構成フィールドに対応します。必要に応じて、これらの宛先にマップすることができます。空白のままになっているタグフィールドの値に対して動的に値を送信するか、現在の値を上書きします。

宛先名	説明
tracking_server	Adobe Heartbeatトラッキングサーバー。 すべてのHeartbeatトラッキングコールが送信されるサーバーのURL。
publisher	Adobe Heartbeatパブリッシャー。 Adobeの担当者によって割り当てられたパブリッシャー名。
ssl	Adobe Heartbeat SSLフラグ。 HeartbeatコールをHTTPS経由で送信するかどうかを決定するブールフラグ。 マッピングする変数がブール値（trueまたはfalse）であることを確認してください。 マッピングは現在のドロップダウンの選択を上書きします。
syndication_channel	Adobe Heartbeatチャンネル。 チャンネルのシンジケーション名。
online_video_platform_name	Adobe Heartbeatビデオプラットフォーム名。 ビデオコンテンツをレンダリングしているオンラインプラットフォームの名前。
player_sdk	Adobe HeartbeatプレーヤーSDK。 ビデオプレーヤーアプリ/SDKのバージョン。
debug_logging	Adobe Heartbeatデバッグログフラグ。 Heartbeatプラグイン内の各コンポーネントのログ記録を有効または無効にするブールフラグ。 アクティブなログ記録はパフォーマンスに影響するため、本番バージョンのプレーヤーではこのフラグを無効にすることをお勧めします。

次のフィールドは、タグバージョンをAdobe Heartbeat 1.6.7 with Nielsen 5.0に構成した場合にのみ必要です。必要なNielsenの値がない場合は、NielsenまたはAdobeの担当者に連絡してください。

宛先名	説明
nielsen_config_key	Adobe Nielsen SDK構成キー。 Adobe HeartbeatとのNielsen統合に使用するNielsen構成SDKキー。
nielsen_client_id	NielsenクライアントID。 Nielsenクライアント識別子。
nielsen_vcid	Nielsen VCID。 ビデオチャンネル識別子。
nielsen_collection_environment	Nielsenコレクション環境。 Nielsenのコレクション環境の場所。
nielsen_player_id	NielsenプレーヤーID。 ビデオプレーヤーの一意の識別子。
nielsen_apn	Nielsen APN。 プレーヤー/サイトの説明。 プレーヤー/サイトを説明するためのユーザー定義の文字列値。
nielsen_device_id	NielsenデバイスID。 ビデオを追跡するモバイル/タブレットの一意の識別子。
nielsen_sdk_debug	Nielsen SDKデバッグフラグ。 Nielsen統合のログ記録を有効または無効にするブールフラグ。
nielsen_opt_out	Nielsen Opt Outフラグ。 現在の訪問のすべてのNielsenトラッキングを無効にします。 opt-outイベントをトリガする必要があります。

ビデオイベント

ビデオイベントの宛先は、ビデオプレーヤーで特定のアクションや変更が発生したときにトリガーされるイベントリスナーです。イベントをトリガーするには、変数をツールボックスの所定のイベントにマッピングし、変数の値をトリガーとして構成する必要があります。マッピングされたイベントは、データレイヤで指定されたトリガー値がデータレイヤ内で見つかったときに発火します。

次のテーブルに、利用可能なイベント宛先の一覧を示します：

宛先名	説明
video_load	ビデオの読み込み。 ビデオが再生可能な状態になったことを示します。
video_start	ビデオの開始。 ビデオが再生を開始したことを示します。次の3つのシナリオのいずれかの後に再生が開始される可能性があります： 初期読み込み バッファリング 広告の表示
video_playing	ビデオの再生中。 ビデオが現在再生中であることを示します。 QoSデータを更新するために使用します。 広告が再生されている場合は呼び出さないでください。
video_pause	ビデオの一時停止。 ビデオが一時停止されたことを示します。
video_play	ビデオの再生。 ビデオが再生中であることを示します。バッファリングやシークが完了した後に再生される場合があります。
video_stop	ビデオの停止。 ビデオが手動で停止されたことを示します。
video_resume	ビデオの再開。 閲覧者がビデオを再開するために一時停止を解除したことを示します。
video_complete	ビデオの完了。 ビデオが終了したことを示します。
video_seek	ビデオのシーク。 閲覧者がビデオをシークし始めたことを示します。
video_buffer	ビデオのバッファリング。 ビデオがバッファリングを開始したことを示します。
video_skip	ビデオのスキップ。 閲覧者がビデオまたは広告をスキップしたことを示します。
video_error	ビデオのエラー。 ビデオがエラーに遭遇したことを示します。
nielsen_opt_out_status_changed	Nielsen Opt Outステータスの変更。 閲覧者がオプトインからオプトアウトまたはその逆に切り替えたことを示します。

ビデオ

これらの宛先は、Adobeビデオ測定パラメータに対応します。

宛先名	説明
video.id	ビデオID。 ビデオの一意の識別子。
video.title	ビデオタイトル。 トラッキングされているビデオの名前。
video.length	ビデオの長さ。 ビデオアセットの長さ（秒単位）。
video.current_playhead	ビデオの現在の再生位置。 広告コンテンツを除くビデオのプレーヤーの現在の位置（秒単位）。
video.stream_type	ビデオストリームタイプ。 ビデオアセットのタイプ。
video.is_full_episode	ビデオがフルエピソードであるかどうか。 ビデオコンテンツがフルエピソードであるかどうかを示すブールフラグ。 フルエピソードの場合はY。 部分的なクリップの場合はN。
video.original_air_date_nielsen	Nielsenのためのビデオのオリジナル放送日。 エピソードのオリジナル放送日、形式。 例：YYYYMMDDHH24:MI:SS
video.channel_name	ビデオチャンネル名。 送信されるプログラムまたはフィードの名前。
video.series_name	ビデオシリーズ名。 表示されているプログラム（シリーズ名）の名前。
video.player_name	ビデオプレーヤー名。 コンテンツを再生しているビデオプレーヤーの名前。
video.is_ad	ビデオが広告であるかどうか。 ビデオが広告であるかどうかを示すブール値。
video.fps	ビデオFPS。 メディアのフレームレート（FPS）。
video.bit_rate	ビデオビットレート。 ビデオコンテンツのビットレート（秒単位）。
video.startup.time	ビデオの起動時間。 ビデオコンテンツの開始時間（秒単位）。
video.dropped_frames	ビデオのドロップフレーム。 再生セッション中にドロップされたすべてのフレームの合計。
video.error_id	ビデオエラーID。 再生中にエラーが発生した際のエラーのID。
video.error_is_fatal	ビデオエラーが致命的かどうか。 エラーが再生を続行するのを妨げるかどうかを示すブール値。

チャプター

これらの宛先は、Adobeビデオチャプターパラメータに対応します。

宛先名	説明
chapter.name	チャプター名。 個々のチャプターの名前。
chapter.length	チャプターの長さ。 チャプターの合計時間（秒単位）。
chapter.position	チャプターの位置。 ビデオコンテンツ内のチャプターの位置。
chapter.start_time	チャプターの開始時間。 チャプターが開始されるメインコンテンツ内のオフセット。
chapter_meta_data.custom	チャプターカスタムメタデータ。 チャプターに関連する追加のカスタム値。

広告

これらの宛先は、Adobeビデオ広告パラメータに対応します。

宛先名	説明
adbreak.name	広告ブレイク名。 個々の広告ブレイクの名前。
adbreak.position	広告ブレイクの位置。 ビデオコンテンツ内の広告ブレイクの位置（インデックス）。 video.is_adフラグがTrueに構成されている場合は必須です。
dbreak.start_time	広告ブレイクの開始時間。 広告ブレイクが開始されるメインコンテンツ内のオフセット。
ad.id	広告ID。 表示されている広告の一意の識別子。
ad.title	広告タイトル。 広告の名前。
ad.type	広告タイプ。 広告のタイプまたはカテゴリ。
ad.length	広告の長さ。 広告の合計時間（秒単位）。
ad.position	広告の位置。 ビデオコンテンツ内の広告の位置（インデックス）。 video.is_adフラグがTrueに構成されている場合は必須です。

ビデオメタデータ

これらの宛先は、Adobe標準メタデータパラメータに対応します。

宛先名	説明
meta_data.custom	ビデオカスタムメタデータ。 ビデオに関連する追加のカスタム値。
meta_data.show	ビデオメタデータショー。 ショーの名前。
meta_data.season	ビデオメタデータシーズン。 シーズン番号。
meta_data.episode	ビデオメタデータエピソード。 エピソード番号。
meta_data.asset	ビデオメタデータアセット。 ビデオアセット識別子、またはTMS ID（Tribune Media Service）とも呼ばれます。
meta_data.genre	ビデオメタデータジャンル。 ビデオコンテンツのジャンル。
meta_data.airDate	ビデオメタデータ放送日。 アセットが最初にテレビで放送された日付。
meta_data.digitalDate	ビデオメタデータデジタル放送日。 アセットが最初にデジタルで利用可能になった日付。
meta_data.rating	ビデオメタデータレーティング。 ビデオコンテンツの利用可能なレーティング。
meta_data.originator	ビデオメタデータオリジネータ。 ビデオのオリジネータの名前。
meta_data.network	ビデオメタデータネットワーク。 番組に関連するネットワークの名前。
meta_data.type	ビデオメタデータタイプ。 番組のタイプ。
meta_data.adLoad	ビデオメタデータ広告ロード。 広告ロードのメタデータ。
meta_data.dayPart	ビデオメタデータデイパート。 広告表示がスケジュールされているデイパート。
meta_data.feed	ビデオメタデータフィード。 プログラミングフィードのタイプ。
meta_data.format	ビデオメタデータフォーマット。 ビデオのストリーム形式。

広告メタデータ

これらの宛先は、Adobe標準広告メタデータパラメータに対応します。

宛先名	説明
ad_meta_data.custom	広告カスタムメタデータ。 表示されている広告に関連する追加のカスタム値。
ad_meta_data.advertiser	広告メタデータ広告主。 広告を表示している会社/ブランドの名前。
ad_meta_data.campaign	広告メタデータキャンペーン。 広告キャンペーンの識別子。
ad_meta_data.creative	広告メタデータクリエイティブ。 広告のレンダリングに使用されるクリエイティブアセット。
ad_meta_data.placement	広告メタデータプレースメント。 ビデオ内の広告の位置に関連するメタデータ。
ad_meta_data.site	広告メタデータサイト。 広告に関連するサイト。
ad_meta_data.creativeURL	広告メタデータクリエイティブURL。 表示されている広告のURL。

バリデーション

Heartbeatタグはイベントベースであり、utag.track（"video"、data）コールを使用して他のutagコールと区別します。そのため、データマッピングツールボックスのビデオイベントトリガーを正しく構成することが重要です。

構成が完了すると、タグはビデオデータを常に最新の状態に保つために毎秒連続して発火します。これは、ビデオプレーヤーの「再生」イベントハンドラ内で「再生」イベントを発火することによって実現されます。他のビデオイベントも、それに対応するAdobe Heartbeatイベントを介して発火する必要があります。ネットワークコールは10秒ごとに集約され、Adobeに報告されます。

HeartbeatおよびNielsenのデバッグフラグを構成する簡単な方法は、ビデオページのURLにクエリストリングパラメータを追加することです。たとえば、adobe_debug=1&Nielsen=1
次に、Tealium iQのデータレイヤにクエリパラメータ変数を追加し、それに応じてマッピングします。
HeartbeatおよびNielsenのデバッグフラグのマッピング先は、標準カテゴリの下にあります。 「Adobe Heartbeat Debug Logging Flag」と「Nielsen SDK Debug Flag」を参照してください。
完了したら、ブラウザのコンソールで次のTealiumデバッグコマンドを実行できます。
document.cookie = "utagdb=true";

サンプルの実装

以下の例は、サンプルのHeartbeat実装のネットワークコールを示しています。注目すべき主なパラメータは、s:event:typeおよびs:asset:typeです。これらのパラメータは、それぞれビデオイベントのタイプと、どのビデオコンポーネントに関連するかを示します。例では、広告表示前のメインビデオの開始部分を示しています。また、表示されている広告の開始時間を示すl:event:playheadも表示されています。

s:asset:typeの値はadで、l:event:playheadの値は8です。これは、広告がビデオの8秒目から再生されたことを意味します。

ベンダードキュメント

• AdobeビデオHeartbeatについて
• ビデオHeartbeatライブラリの構成
• Nielsen appinfoパラメータ
• [ビデオ測定パラメータ](https://marketing.adobe.com/resources/help/en_US