Adobe Heartbeat タグ構成ガイド

動作原理

Adobe Heartbeat タグを使用すると、訪問がサイトのビデオとどのように対話するかについての広範なデータを収集できます。ページ上でビデオが読み込まれると、Heartbeat はビデオの長さを通じて毎秒サーバーコールをトリガーし、再生位置、一時停止および再開アクション、広告表示、その他いくつかのビデオパフォーマンスパラメータをキャプチャします。さらに、実装が Nielsen DCR プラグインと統合されている場合、このタグでそれらのパラメータを一緒に構成できます。

前提条件

• jQuery
  サイトに jQuery がインストールされていることを確認してください。jQuery を使用していない場合は、Tealium iQ タグマーケットプレイスから新しい jQuery タグを追加して構成できます。
• Adobe Enterprise Cloud ID Service タグ
  Adobe Cloud Service は、サイトの訪問ごとに一意の ID を生成し、すべての Enterprise Cloud ソリューション間で ID を維持するため、重複カウントを防ぎます。まだ行っていない場合は、プロファイルにタグを追加して構成し、すべてのページの utag.js にバンドルできるようにバンドルフラグ構成を有効にしてください。
• AppMeasurement JavaScript タグ
  同じプロファイルでタグを追加して構成し、まだ行っていない場合はバンドルフラグを有効にしてください。これは JavaScript 実装に必要です。バンドルはタグバージョン 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 Service および AppMeasurement for JS が最初に読み込まれる必要があります。できればバンドルされていることが望ましいです。
• このタグは “utag.track(‘video’, data);” を介して発火され、ビデオイベントハンドラーで実装する必要があります。
• Adobe Heartbeat には jQuery が必要です。

タグの構成

まず、Tealium のタグマーケットプレイスにアクセスして Adobe Heartbeat タグを追加します（タグの追加方法についてはこちらを参照してください）。

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

フィールド名	フィールド値
タイトル	(必須) タグを識別するための一意の名前を入力してください。 このタグの複数のインスタンスを追加する場合は、この情報が重要です。
トラッキングサーバー	(必須) Adobe Heartbeat トラッキングサーバー。 すべてのハートビートトラッキングコールが送信されるサーバー URL を入力してください。 URLがわからない場合は、Adobe の担当者に連絡してください。 例：.hb.omtrdc.net
パブリッシャー	(必須) Adobe の担当者によって割り当てられたパブリッシャー名を入力してください。
SSL の使用	このフラグは、ハートビートコールを 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 統合用の Adobe Heartbeat との構成 SDK キー。
Nielsen コレクション環境	(Nielsen 用に必須) コレクション環境の場所。 Nielsen のコレクション環境の場所を入力してください 例：eu-cert または eu。
Nielsen プレーヤー ID	(Nielsen 用に必須) ビデオプレーヤーに割り当てられた一意の識別子を入力してください Nielsen によって提供されるプレーヤー/サイトの一意の ID。
Nielsen APN	(Nielsen 用に必須) プレーヤー/サイトの説明を入力してください プレーヤー/サイトを説明するためのユーザー定義の文字列値。
Nielsen クライアント ID	(Nielsen 用に必須) Nielsen クライアント識別子を入力してください VA Beacon 測定用の一意の ID。
Nielsen VCID	(Nielsen 用に必須) ビデオチャンネル識別子を入力してください。 VA Beacon 測定用の一意の ID。

読み込みルールの適用

読み込みルール は、サイト上でこのタグのインスタンスをいつ、どこで読み込むかを決定します。すべてのページで読み込むルールがデフォルトの読み込みルールです。このタグを特定のページで読み込むには、関連するルール条件を作成してタグに適用します。

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

データマッピング

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

次のセクションでは、利用可能な各カテゴリについて詳細な表を提供します。

標準

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

目的地名	説明
tracking_server	Adobe Heartbeat トラッキングサーバー。 すべてのハートビートトラッキングコールが送信されるサーバーのURL。
publisher	Adobe Heartbeat パブリッシャー。 Adobe担当者によって割り当てられたパブリッシャー名。
ssl	Adobe Heartbeat SSLフラグ。 ハートビートコールを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は、アクティブなログがパフォーマンスに影響を与えるため、プレイヤーの製品版でこのフラグを無効にすることを推奨します。

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

目的地名	説明
nielsen_config_key	Adobe Nielsen SDK構成キー。 Adobe Heartbeatと統合するためのNielsen構成キー。
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 オプトアウトフラグ。 現在の訪問のすべての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 オプトアウトステータス変更。 視聴者がオプトインからオプトアウト、またはその逆に切り替わったことを示します。

ビデオ

これらの目的地は、Adobe Video Measurement parametersに対応しています。

目的地名	説明
video.id	ビデオID。 ビデオの一意の識別子。
video.title	ビデオタイトル。 追跡されているビデオの名前。
video.length	ビデオの長さ。 ビデオアセットの期間（秒単位）。
video.current_playhead	ビデオ現在の再生位置。 広告コンテンツを除く、ビデオのプレイヤーの現在の位置（秒単位）。
video.stream_type	ビデオストリームタイプ。 ビデオアセットのタイプ。
video.is_full_episode	ビデオはフルエピソードですか。 ビデオコンテンツがフルエピソードであるかどうかを示すブールフラグ。 Y はフルエピソード。 N は部分的なクリップ。
video.original_air_date_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 Video Chapter Parameters に対応しています。

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

広告

これらの目的地は Adobe Video Ad Parameters に対応しています。

目的地名	説明
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 Standard Metadata Parameters に対応しています。

目的地名	説明
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 Standard Ad Metadata Parameters に対応しています。

目的地名	説明
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。

ビルトイン動画データレイヤー変数

データレイヤーがすでにこれらの値を使用している場合、マッピングは必要ありません。Tealiumは通常、データを対応するタグの宛先に送信します。データレイヤーがこの表に記載されている変数名と異なる場合は、手動でマップする必要があります。

ビルトイン変数	ツールボックス宛先変数	説明
event_name	動画イベント宛先	event_name変数で以下の値を使用している場合、ツールボックスで再度マップする必要はありません。 load は video_load にマップされます start は video_start にマップされます playing は video_playing にマップされます pause は video_pause にマップされます play は video_play にマップされます stop は video_stop にマップされます resume は video_resume にマップされます complete は video_complete にマップされます seek は video_seek にマップされます buffer は video_buffer にマップされます optstatus は Nielsen_opt_out_status_changed にマップされます
video_id	–	動画のユニーク識別子。
video_name	video.title	動画タイトル。 追跡されている動画の名前。
video_length	video.length	動画の長さ。 動画アセットの持続時間（秒単位）。
video_player_name	video.player_name	動画プレーヤー名。 コンテンツを再生している動画プレーヤーの名前。
video_current_playhead	video.current_playhead	動画の現在の再生位置。 広告コンテンツを除く、プレーヤーの動画内での現在位置（秒単位）。
video_stream_type	video.stream_type	動画ストリームタイプ。 動画アセットのタイプ。
video_fps	video.fps	動画FPS。 メディアのフレームレート、フレーム毎秒（FPS）。
video_bitrate	video.bit_rate	動画ビットレート。 動画コンテンツのビットレート。
video_dropped_frames	video.dropped_frames	動画ドロップフレーム。 再生セッション中にドロップされた全フレームの合計。
video_is_ad	video.is_ad	動画が広告かどうか。 動画が広告であるかどうかを示すブール値。
video_ad_position - OR - video_ad_pod_position	ad.position	広告位置。 動画コンテンツ内の広告の位置（インデックス）。 video.is_adフラグがtrueに構成されている場合に必要です。
video_chapter_name	chapter.name	チャプター名。 個々のチャプターの名前。
video_chapter_length	chapter.length	チャプターの長さ。 チャプターの総持続時間（秒単位）。
video_chapter_position	chapter.position	チャプター位置。 動画コンテンツ内のチャプターの位置。
video_chapter_start_time	chapter.start_time	チャプター開始時間。 メインコンテンツ内でチャプターが始まるオフセット。
video_ad_pod_name	ad.id	広告ID。 表示されている広告のユニーク識別子。
program	video.series_name	動画シリーズ名。 視聴されているプログラム（シリーズ名）の名前。
is_full_episode	video.is_full_episode	動画がフルエピソードかどうか。 動画コンテンツがフルエピソードであるかを示すブールフラグ。 Y はフルエピソード N は部分的なクリップ
original_air_date	video.original_air_date_nielsen	ニールセン用の動画のオリジナル放送日。 エピソードのオリジナル放送日、次の形式で: YYYYMMDDHH24:MI:SS

検証

Heartbeatタグはイベントベースであり、他のutagコールと区別するためにutag.track("video", data)コールを利用します。このため、データマッピングツールボックス内の動画イベントトリガーを適切に構成することが重要です。

構成後、タグは毎秒連続して発火し、動画データを最新の状態に保ちます。これは、動画プレーヤーの"playing"イベントハンドラ内で"playing"イベントを発火することで実現されます。他の動画イベントもそれに対応するAdobe heartbeatイベントを通じて発火されるべきです。ネットワークコールは集約され、イベント変更を含む10秒ごとにAdobeに報告されます。

HeartbeatとNielsenのデバッグフラグを構成する簡単な方法は、動画ページのURLにクエリ文字列パラメータを追加することです。例えば、adobe_debug=1&Nielsen=1
次に、Tealium iQのデータレイヤーにクエリパラメータ変数を追加し、それに応じてマッピングします。
HeartbeatとNielsenのデバッグフラグのマッピング先はStandardカテゴリの下にあります。“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 Video Heartbeatについて
• Video Heartbeatライブラリ構成
• Nielsen appinfoパラメータ
• 動画測定パラメータ
• メタデータパラメータ
• 動画プレーヤーイベント