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 統合用の構成 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.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`	チャプターカスタムメタデータ。チャプターに関連する追加のカスタム値。

デスティネーション名	説明
`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秒目に再生を開始したことを意味します。

Tealium docs index

Adobe Heartbeat タグ構成ガイド

動作原理

前提条件

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

タグのヒント

タグの構成

読み込みルールの適用

データマッピング

標準

ビデオイベント

ビデオ

チャプター

広告

ビデオメタデータ

広告メタデータ

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

検証

サンプル実装

ベンダードキュメント