Adobe Heartbeatタグ構成ガイド

仕組み

Adobe Heartbeatタグを使用すると、サイト訪問が動画をどのように操作したかについて、広範なデータを収集できます。ページ上で動画が読み込まれると、Heartbeatは動画の再生中に1秒ごとにサーバー呼び出しをトリガーし、再生ヘッドの位置、一時停止と再開の操作、広告の視聴、およびその他の複数の動画パフォーマンスパラメータを取得します。また、実装がNielsen DCRプラグインと統合されている場合は、このタグでそれらのパラメータをまとめて構成できます。

前提条件

jQuery
サイトにjQueryがインストールされていることを確認してください。jQueryを使用していない場合は、タグ管理のタグマーケットプレイスから新しいjQueryタグを追加して構成できます。
Adobe Enterprise Cloud ID Serviceタグ
Adobe Cloud Serviceは、サイトの各訪問に一意のIDを生成し、そのIDをすべてのEnterprise Cloudソリューションで保持することで、重複カウントを防止します。まだ行っていない場合は、プロファイルにタグを追加して構成し、すべてのページでutag.jsにバンドルできるように、タグのバンドルフラグ構成を有効にします。
AppMeasurement JavaScriptタグ
まだ行っていない場合は、同じプロファイルにタグを追加して構成し、バンドルフラグを有効にします。これはJavaScript実装に必要です。以前のバージョンではEnterprise Cloud Serviceがデフォルトでバンドルされているため、バンドルが必要なのはタグバージョン1.6.3のみです。

「タグ」タブで、バンドルされた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が必要です。

タグの構成

タグマーケットプレイスに移動し、新しいタグを追加します。詳細については、タグについてを参照してください。

タグを追加する際は、次の構成を行います。

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

次のフィールドは、タグバージョンを**Adobe Heartbeat 1.6.7（Nielsen 5.0対応）**に構成した場合にのみ必要です。必要なNielsen値が不明な場合は、NielsenまたはAdobeの担当者にお問い合わせください。

フィールド名	フィールド値
Adobe Nielsen SDK構成キー	（Nielsenでは必須）Nielsen構成キーを入力します Adobe HeartbeatとNielsenを統合するための構成SDKキー。
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 Player 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 のパラメーターに対応します。

宛先名	説明
`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。メディアのフレームレート（1 秒あたりのフレーム数（FPS））。
`video.bit_rate`	ビデオのビットレート。ビデオコンテンツの 1 秒あたりのビット数を示す属性。
`video.startup.time`	ビデオの開始時間。ビデオコンテンツの開始時間（秒単位）。
`video.dropped_frames`	ビデオのドロップフレーム。 1 回の再生セッション中にドロップしたすべてのフレームの合計。
`video.error_id`	ビデオエラー ID。再生中に発生したエラーの ID。
`video.error_is_fatal`	ビデオエラーが致命的かどうか。エラーによって再生を続行できなくなるかどうかを示すブール値。

チャプター

これらの送信先は、Adobe 動画チャプターパラメーターに対応しています。

送信先名	説明
`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 標準メタデータパラメーターに対応しています。

送信先名	説明
`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。

組み込みの動画データレイヤー変数

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

組み込み変数	Toolbox の送信先変数	説明
`event_name`	動画イベントの送信先	`event_name` 変数で以下のいずれかの値を使用する場合、Toolbox で再度マッピングする必要はありません。 `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。メディアのフレームレート（1 秒あたりのフレーム数、FPS）。
`video_bitrate`	`video.bit_rate`	動画のビットレート。動画コンテンツの 1 秒あたりのビット数を示す属性。
`video_dropped_frames`	`video.dropped_frames`	動画のドロップフレーム数。再生セッション中にドロップした全フレームの合計。
`video_is_ad`	`video.is_ad`	動画が広告であるかどうか。動画が広告であるかどうかを示すブール値。
`video_ad_position` - または - `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`	Nielsen 用の動画の初回放送日時。エピソードの初回放送日時。形式は `YYYYMMDDHH24:MI:SS` です。

検証

Heartbeat タグはイベントベースであり、他の utag 呼び出しと区別するために utag.track("video", data) 呼び出しを利用します。このため、Data Mapping Toolbox で動画イベントトリガーを適切に構成することが重要です。

構成後、動画データを最新の状態に保つため、タグは 1 秒ごとに継続して発火します。これは、動画プレーヤーの「playing」イベントハンドラー内で「playing」イベントを発火させることで実現します。その他の動画イベントも、対応する Adobe Heartbeat イベントを通じて発火させる必要があります。イベントの変更に関するものを含め、ネットワーク呼び出しは集約され、10 秒ごとに Adobe に送信されます。

Heartbeat と Nielsen の両方のデバッグフラグを簡単に構成するには、動画ページの URL にクエリ文字列パラメータを追加します。たとえば、adobe_debug=1&Nielsen=1 のように指定します。
その後、Tag Management のデータレイヤーにクエリパラメータ変数を追加し、適切にマッピングできます。
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タグ構成ガイド

仕組み

前提条件

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

タグに関するヒント

タグの構成

読み込みルールの適用

データマッピング

標準

ビデオイベント

ビデオ

チャプター

広告

動画メタデータ

広告メタデータ

組み込みの動画データレイヤー変数

検証

実装例

ベンダーのドキュメント