Microsoft Advertising ユニバーサルイベントトラッキング（UET）タグ構成ガイド

タグのヒント

マッピングを使用して：
- 標準構成値を上書きします。
- Eコマース拡張値を上書きします。
- カスタムパラメーターを渡します。
- イベントトリガーを構成します。
Standard タブで Custom Property/Parameter にパラメーターをマッピングすると、そのパラメーターはすべてのイベントに送信されます。特定のイベントにのみデータを送信するには、Event Parameters タブを使用します。
次のEコマース拡張値をサポートしています：
- 注文ID。
- 注文小計。
- 注文送料。
- 注文税金。
- 注文通貨。
- 注文クーポン/プロモーションコード。
- 商品IDのリスト。
- 名前のリスト。
- ブランドのリスト。
- カテゴリのリスト。
- 数量のリスト。
- 価格のリスト。

タグの構成

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

タグを追加する際には、以下の構成を構成します：

Tag ID: あなたのMicrosoft Advertisingタグ識別子。
Ad Storage Consent: 広告保存のデフォルト同意を構成します。Data Mappings セクションで ad_storage パラメーターをマッピングすることにより、この値を動的に更新します。
Automatically read from Tealium Consent Cookie: trueに構成すると、Tealium consent managerに基づいて同意が構成されます。

ロードルール

すべてのページでタグをロードするか、タグがロードされる条件を構成します。詳細については、ロードルールについてを参照してください。

同意モード

このタグの同意モードを実装するには、次の2つのオプションがあります：

クライアントサイド同意管理を使用し、Tealium同意クッキーを自動的に読み取ります。
JavaScript Code extensionを追加して、あなたの同意管理プラットフォーム（CMP）からこのタグへの同意選択とカテゴリマッピングをマップします。

訪問が同意選択を行うと、タグは第一者および第三者クッキーに対して適切なアプローチを選択します：

Granted: 第一者および第三者クッキーの読み書きが可能です。
Denied: 第一者クッキーは読み書きされず、第三者クッキーは詐欺およびスパム目的でのみ読み取り可能で、広告目的ではありません。

クライアントサイド同意管理

このタグの同意モードをクライアントサイド同意管理を使用して実装するには、タグ構成で Automatically read from Tealium Consent Cookie を true に構成します。

JavaScript Code extension

エンドユーザーの同意選択をMicrosoft同意モード構成にマッピングするには、JavaScript Code extensionを使用します。拡張機能を次のように構成します：

Scope を After Load Rules (default) に構成
Occurrence を Run Always に構成
あなたのCMPのためのロジックで CUSTOM_LOGIC を置き換えることにより、CMP用の次のJavaScriptコードテンプレートをカスタマイズできます。

b.consent_decision = (tealiumConsentRegister && tealiumConsentRegister.currentDecision) || [];
b.microsoft_ad_storage_consent = CUSTOM_LOGIC ? 'granted' : 'denied';

例えば、以下のコードはOneTrust用です。

// After Load Rules - Run Always
b.consent_decision = (tealiumConsentRegister && tealiumConsentRegister.currentDecision) || [];
b.microsoft_ad_storage_consent = b.consent_decision.indexOf('C0004') !== -1  ? 'granted' : 'denied';

これらの正確な変数名を使用する場合、追加のマッピングは必要ありません。タグの最新バージョンはデフォルトでこれらの変数を使用します。 ad_storage パラメーターをあなたの特定のケースの属性にマッピングすることにより、これらの変数を上書きします。

データマッピング

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

利用可能なカテゴリは次のとおりです：

標準

変数	説明
`tagid`	タグID。 Microsoft Advertisingによって提供されるあなたのタグ識別子。
`event_category`	イベントカテゴリ。追跡されている要素またはオブジェクトに関する情報を送信します。例：`Button`。
`event_action`	イベントアクション。ユーザーアクションを送信します。例：`click`, `mousedown`。
`event_label`	イベントラベル。イベント目標に関する情報ラベルまたは詳細を送信します。例：`Product demo`。
`event_value`	イベント値。イベント目標の数値を送信します。
`description`	エラー説明。ユーザーが経験したエラーの説明。
`fatal`	エラー致命的。ユーザーが経験したエラーが致命的かどうか。
`method`	方法。ユーザーのアクションに関連する方法。
`screen_name`	スクリーン名。ユーザーが現在表示しているスクリーンの名前。
`search_term`	検索用語。ユーザーの検索で使用される用語。
`content_type`	コンテンツタイプ。ユーザーが選択したコンテンツのタイプ。
`content_id`	コンテンツID。ユーザーが選択したコンテンツのID。
`promotion_creative_name`	プロモーションクリエイティブ名のリスト。プロモーションで使用されるクリエイティブ名の配列。
`promotion_creative_slot`	プロモーションクリエイティブスロットのリスト。プロモーションで使用されるクリエイティブスロット名の配列。
`promotion_id`	プロモーションIDのリスト。プロモーションで使用されるプロモーションIDの配列。
`promotion_name`	プロモーション名のリスト。プロモーションで使用されるプロモーション名の配列。
`enableAutoSpaTracking`	自動SPAトラッキングを有効にします。
`id_sync_beacon`	ID同期ビーコン。
`customer_id`	Microsoftの顧客ID。
`visitor_id`	訪問ID。
`user_id`	ユーザーID。
`custom.myvar`	カスタムプロパティ/パラメーター。あなたのイベントのためのカスタムプロパティ。すべてのイベントで送信されますが、特定のイベントのプロパティを構成するにはイベントパラメーターを使用します。 `myvar`をあなたのプロパティの名前に置き換えてください。

Eコマース

変数	説明
`checkout_step`	チェックアウトステップ。ユーザーが現在どのチェックアウトプロセスのステップにいるか。
`checkout_option`	チェックアウトオプション。ユーザーが選択した現在のチェックアウトオプション。
`order_id`	注文ID。デフォルトのeコマース値 `_corder` を上書きするために使用。
`order_subtotal`	小計。デフォルトのeコマース値 `_csubtotal` を上書きするために使用。
`order_shipping`	送料。デフォルトのeコマース値 `_cship` を上書きするために使用。
`order_tax`	税金。デフォルトのeコマース値 `_ctax` を上書きするために使用。
`order_currency`	通貨。デフォルトのeコマース値 `_ccurrency` を上書きするために使用。
`order_coupon_code`	プロモーションコード。デフォルトのeコマース値 `_cpromo` を上書きするために使用。
`product_id`	配列商品IDのリスト。デフォルトのeコマース値 `_cprod` を上書きするために使用。
`product_name`	配列商品名のリスト。デフォルトのeコマース値 `_cprodname` を上書きするために使用。
`product_brand`	配列ブランドのリスト。デフォルトのeコマース値 `_cbrand` を上書きするために使用。
`product_category`	配列カテゴリのリスト。デフォルトのeコマース値 `_ccat` を上書きするために使用。
`product_quantity`	配列数量のリスト。デフォルトのeコマース値 `_cquan` を上書きするために使用。
`product_unit_price`	配列価格のリスト。デフォルトのeコマース値 `_cprice` を上書きするために使用。
商品クリエイティブ名のリスト	配列商品に使用されるクリエイティブ名の配列。
商品クリエイティブスロットのリスト	配列商品に使用されるクリエイティブスロットの配列。
商品ロケーションIDのリスト	配列商品に使用されるロケーションIDの配列。

イベントとエンゲージメント

特定のイベントをページでトリガーするためにこれらの目的地にマッピングします。

イベントをトリガーするために以下のステップを使用します：

ドロップダウンリストからイベントを選択します。事前定義されたリストから選択するか、カスタムイベントを作成します。
- カスタムイベントの場合、それを識別する名前を入力します。
トリガー フィールドにマッピングされる変数の値を入力します。
より多くのイベントをマッピングするには、プラス記号 (+) をクリックしてステップ1と2を繰り返します。
適用をクリックします。提供された値がデータレイヤーで見つかったときにイベントがトリガーされます。

変数	説明
`add_payment_info`	支払情報の追加。ユーザーが取引に新しい支払情報を追加しました。
`add_to_cart`	カートに追加。ユーザーが一つ以上のアイテムをショッピングカートに追加しました。
`add_to_wishlist`	ウィッシュリストに追加。ユーザーが一つ以上のアイテムをウィッシュリストに追加しました。
`begin_checkout`	チェックアウトの開始。ユーザーがチェックアウトプロセスを開始しました。
`checkout_progress`	チェックアウトの進行。ユーザーがチェックアウトの進行でステップを交換しました。
`exception`	例外。ユーザーが例外に遭遇しました。
`generate_lead`	リードの生成。ユーザーのアクションがリードを生成しました。
`login`	ログイン。ユーザーがログインしました。
`page_view`	ページビュー。ユーザーがページを閲覧しました。
`purchase`	購入。ユーザーが一つ以上の商品の購入を完了しました。
`refund`	払い戻し。ユーザーが一つ以上の商品について払い戻しを要求しました。
`remove_from_cart`	カートから削除。ユーザーがショッピングカートから一つ以上のアイテムを削除しました。
`screen_view`	スクリーンビュー。ユーザーがスクリーンを閲覧しました。
`search`	検索。ユーザーが検索しました。
`select_content`	コンテンツの選択。ユーザーが一つ以上のコンテンツアイテムを選択しました。
`set_checkout_option`	チェックアウトオプションの構成。ユーザーが現在のチェックアウトステップのためにチェックアウトオプションを選択しました。
`share`	共有ユーザーがコンテンツを共有しました。
`sign_up`	サインアップ。ユーザーがサインアップしました。
`timing_complete`	タイミング完了。ユーザーのページロードのタイミング情報。
`view_item`	アイテム表示。ユーザーが単一のアイテム、通常は詳細ページを閲覧しました。
`view_item_list`	アイテムリスト表示。ユーザーが一つ以上のアイテムが含まれるリストページを閲覧しました。
`view_promotion`	プロモーション表示。ユーザーがプロモーションをクリックしました。
`view_search_results`	検索結果表示。ユーザーが検索の結果を閲覧しました。
`update_consent`	同意の更新。
`custom`	カスタムイベント。ユーザーがカスタムイベントに関連するアクションを開始しました。

商品オーディエンスイベント

特定のイベントをページでトリガーするためにこれらの目的地にマッピングします。

イベントをトリガーするために以下のステップを使用します：

ドロップダウンリストからイベントを選択します。事前定義されたリストから選択するか、カスタムイベントを作成します。
- カスタムイベントの場合、それを識別する名前を入力します。
トリガー フィールドにマッピングされる変数の値を入力します。
より多くのイベントをマッピングするには、プラス記号 (+) をクリックしてステップ1と2を繰り返します。
適用をクリックします。提供された値がデータレイヤーで見つかったときにイベントがトリガーされます。

変数	説明
`retail`	小売。小売ベースのマーケティングのためにデータを送信します。
`travel`	旅行。旅行ベースのマーケティングのためにデータを送信します。
`hotel`	ホテル。ホテルベースのマーケティングのためにデータを送信します。

エンリッチメントされた変換データ

変数	タイプ/値	説明
`em`	`String`	メール。
`ph`	`String`	電話。

同意管理

変数	説明
`ad_storage`	広告保存。

イベントパラメータ

これらの目的地にマップすると、以前にマップされたイベントに追加データを渡すことができます。

パラメータは事前定義されたイベントでのみ使用されます。カスタムイベントでパラメータを渡す方法を学ぶには、カスタムイベント仕様の作成を参照してください。

事前定義されたイベントでパラメータを渡すには、以下の手順に従ってください：

ドロップダウンリストからイベントを選択します。
ドロップダウンリストからパラメータを選択します。カスタムパラメータを使用する場合は、それを識別する名前を入力します。
追加をクリックします。

変数	説明
`event_category`	イベントカテゴリ。現在のイベントのカテゴリ。クリックされたボタンなど、要素やオブジェクトに関する情報を送信します。
`event_action`	イベントアクション。現在のイベントのアクション名。クリックやマウスダウンなどのユーザーアクションを送信します。
`event_label`	イベントラベル。現在のイベントのラベル。製品デモなど、製品目標に関する情報ラベルや詳細を送信します。
`event_value`	イベント値。現在のイベントの目標値を数値で送信します。
`custom`	カスタムプロパティ/パラメータ。現在のイベントに関連するカスタムプロパティ。
`description`	エラー説明。ユーザーが経験したエラーの説明。
`fatal`	エラー致命的。ユーザーが経験したエラーが致命的かどうか。
`method`	方法。ユーザーのアクションに関連する方法。
`screen_name`	スクリーン名。ユーザーが閲覧している現在のスクリーンの名前。
`search_term`	検索用語。ユーザーの検索で使用される用語。
`content_type`	コンテンツタイプ。ユーザーが選択したコンテンツのタイプ。
`content_id`	コンテンツID。ユーザーが選択したコンテンツのID。
`checkout_step`	チェックアウトステップ。ユーザーが現在進行中のチェックアウトプロセスのステップ。
`checkout_option`	チェックアウトオプション。ユーザーが選択した現在のチェックアウトオプション。
`order_id`	注文ID。デフォルトのeコマース値 `_corder` を上書きするために使用します。
`order_total`	注文合計。デフォルトのeコマース値 `_ctotal` を上書きするために使用します。
`order_subtotal`	小計。デフォルトのeコマース値 `_csubtotal` を上書きするために使用します。
`order_shipping`	送料。デフォルトのeコマース値 `_cship` を上書きするために使用します。
`order_tax`	税金。デフォルトのeコマース値 `_ctax` を上書きするために使用します。
`order_currency`	通貨。デフォルトのeコマース値 `_ccurrency` を上書きするために使用します。
`order_coupon_code`	プロモーションコード。デフォルトのeコマース値 `_cpromo` を上書きするために使用します。
`product_id`	製品IDのリスト。デフォルトのeコマース値 `_cprod` を上書きするために使用します。
`product_name`	名前のリスト。デフォルトのeコマース値 `_cprodname` を上書きするために使用します。
`product_brand`	ブランドのリスト。デフォルトのeコマース値 `_cbrand` を上書きするために使用します。
`product_category`	カテゴリのリスト。デフォルトのeコマース値 `_ccat` を上書きするために使用します。
`product_quantity`	数量のリスト。デフォルトのeコマース値 `_cquan` を上書きするために使用します。
`product_unit_price`	価格のリスト。デフォルトのeコマース値 `_cprice` を上書きするために使用します。
`product_creative_name`	配列製品クリエイティブ名のリスト。製品に使用されるクリエイティブ名の配列。
`product_creative_slot`	配列製品クリエイティブスロットのリスト。製品に使用されるクリエイティブスロットの配列。
`promotion_creative_name`	配列プロモーションクリエイティブ名のリスト。プロモーションで使用されるクリエイティブ名の配列。
`promotion_creative_slot`	配列プロモーションクリエイティブスロットのリスト。プロモーションで使用されるクリエイティブスロット名の配列。
`promotion_id`	配列プロモーションIDのリスト。プロモーションで使用されるプロモーションIDの配列。
`promotion_name`	配列プロモーション名。プロモーションで使用されるプロモーション名の配列。

製品オーディエンスパラメータ

これらの目的地にマップすると、以前にマップされたイベントに追加データを渡すことができます。

事前定義されたイベントでパラメータを渡すには、以下の手順に従ってください：

ドロップダウンリストからイベントを選択します。
ドロップダウンリストからパラメータを選択します。カスタムパラメータを使用する場合は、それを識別する名前を入力します。
追加をクリックします。

変数	説明
`ecomm_prodid`	製品ID。ユーザーに現在表示されている、または選択された1つ以上のID。
`ecomm_pagetype`	ページタイプ。ユーザーに表示されている現在のページタイプ。
`ecomm_totalvalue`	総価値。ユーザーに関連する現在の総価値。
`ecomm_category`	カテゴリ。ユーザーに表示されている現在のカテゴリ。
`travel_destid`	目的地ID。ユーザーが選択した目的地のID。
`travel_originid`	出発地ID。ユーザーの出発地のID。
`travel_startdate`	開始日。ユーザーが旅行を開始したい日付。
`travel_enddate`	終了日。ユーザーが旅行を終了したい日付。
`travel_totalvalue`	総価値。ユーザーが開始したい旅行の総価値。
`hct_bpr`	ホテル基本価格。ユーザーが予約したいホテルの基本価格。
`hct_tpr`	ホテル総価格。税金や割引を含む、ユーザーが予約したいホテルの総価格。
`hct_bid`	ホテル予約ID。ユーザーの予約のID。
`hct_cid`	ホテルチェックイン日。ユーザーの滞在のチェックイン日。
`hct_cod`	ホテルチェックアウト日。ユーザーの滞在のチェックアウト日。
`hct_los`	ホテル滞在期間。ユーザーの滞在の総期間。
`hct_pid`	ホテルパートナーID。ユーザーが予約したいホテルのパートナーID。
`hct_pagetype`	ホテルページタイプ。ユーザーに表示されている現在のページタイプ。

製品オーディエンス - 小売

変数	説明
`ecomm_prodid`	製品ID。ユーザーに現在表示されている、または選択された1つ以上のID。
`ecomm_pagetype`	ページタイプ。ユーザーに表示されている現在のページタイプ。 `home`, `searchresults`, `category`, `product`, `cart`, `purchase`, `other`のいずれか。
`ecomm_totalvalue`	総価値。ユーザーに関連する現在の総価値。
`ecomm_category`	カテゴリ。ユーザーに表示されている現在のカテゴリ。

製品オーディエンス - 旅行

変数	説明
`travel_destid`	目的地ID。ユーザーが選択した目的地のID。
`travel_originid`	出発地ID。ユーザーの出発地のID。
`travel_pagetype`	ページタイプ。ユーザーに表示される現在のページタイプ。 `home`, `searchresults`, `offerdetail`, `conversionintent`, `conversion`, `cancel`, `other`のいずれか。
`travel_startdate`	開始日。ユーザーが旅行を開始したい日付。日付形式は`YYYY-MM-DD`。
`travel_enddate`	終了日。ユーザーが旅行を終了したい日付。日付形式は`YYYY-MM-DD`。
`travel_totalvalue`	総価値。ユーザーが開始したい旅行の総価値。

製品オーディエンス - ホテル

変数	説明
`hct_base_price`	ホテル基本価格。ユーザーが予約したいホテルの基本価格。
`hct_total_price`	ホテル総価格。税金や割引を含む、ユーザーが予約したいホテルの総価格。
`hct_checkin_date`	ホテルチェックイン日。ユーザーの滞在のチェックイン日。日付形式は`YYYY-MM-DD`。
`hct_checkout_date`	ホテルチェックアウト日。ユーザーの滞在のチェックアウト日。日付形式は`YYYY-MM-DD`。
`hct_length_of_stay`	ホテル滞在期間。ユーザーの滞在の総期間。
`hct_partner_hotel_id`	ホテルパートナーID。ユーザーが予約したいホテルのパートナーID。
`hct_booking_ref`	予約参照番号を難読化。
`hct_pagetype`	ホテルページタイプ。ユーザーに表示される現在のページタイプ。 `home`, `searchresults`, `property`, `cart`, `purchase`, `cancel`, `other`のいずれか。

タグのヒント

タグの構成

ロードルール

同意モード

クライアントサイド同意管理

JavaScript Code extension

データマッピング

標準

Eコマース

イベントとエンゲージメント

商品オーディエンスイベント

エンリッチメントされた変換データ

同意管理

イベントパラメータ

製品オーディエンスパラメータ

製品オーディエンス - 小売

製品オーディエンス - 旅行

製品オーディエンス - ホテル

ベンダー文書