Microsoft Advertising ユニバーサルイベントトラッキング(UET)タグ構成ガイド
この記事では、Microsoft Advertising ユニバーサルイベントトラッキング(UET)タグの構成方法について説明します。
タグのヒント
-
マッピングを使用して:
- 標準構成値を上書きします。
- E-コマース拡張値を上書きします。
- カスタムパラメータを渡します。
- イベントトリガーを構成します。
-
Standard タブで Custom Property/Parameter にパラメータをマッピングすると、そのパラメータはすべてのイベントに送信されます。特定のイベントにのみデータを送信するには、Event Parameters タブを使用します。
-
次の E-コマース拡張値をサポートします:
- 注文ID。
- 注文小計。
- 注文送料。
- 注文税金。
- 注文通貨。
- 注文クーポン/プロモーションコード。
- 製品IDのリスト。
- 名前のリスト。
- ブランドのリスト。
- カテゴリのリスト。
- 数量のリスト。
- 価格のリスト。
タグの構成
まず、Tealiumのタグマーケットプレイスにアクセスし、Microsoft Advertising ユニバーサルイベントトラッキング(UET)タグを追加します。詳細については、タグの管理を参照してください。
タグを追加した後、次の構成を構成します:
- Tag ID: あなたのMicrosoft Advertisingタグ識別子。
- Ad Storage Consent: 広告保存のデフォルト同意を構成します。Data Mappings セクションで
ad_storage
パラメータをマッピングすることにより、この値を動的に更新します。 - Automatically read from Tealium Consent Cookie:
true
に構成すると、Tealium Consent Managerに基づいて同意が構成されます。
同意モード
このタグの同意モードを実装するには、次の2つのオプションがあります:
- Tealium Consent Managementを使用し、Tealium Consent Cookieを自動的に読み取ります。
- JavaScript Code extensionを追加して、あなたの同意管理プラットフォーム(CMP)からこのタグへの同意選択とカテゴリマッピングをマップします。
訪問が同意選択を行うと、タグは第一者および第三者のクッキーに対して適切なアプローチを選択します:
- Granted: 第一者および第三者のクッキーが読み書き可能です。
- Denied: 第一者のクッキーは読み書きされず、第三者のクッキーは広告目的ではなく、詐欺やスパム目的のみで読み取り可能です。
Tealium Consent Management
このタグの同意モードをTealium Consent Managementを使用して実装するには、タグ構成で 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 |
|
event_category |
|
event_action |
|
event_label |
|
event_value |
|
description |
|
fatal |
|
method |
|
screen_name |
|
search_term |
|
content_type |
|
content_id |
|
promotion_creative_name |
|
promotion_creative_slot |
|
promotion_id |
|
promotion_name |
|
enableAutoSpaTracking |
Boolean |
custom.myvar |
|
E-コマース
変数 | 説明 |
---|---|
checkout_step |
|
checkout_option |
|
order_id |
|
order_subtotal |
|
order_shipping |
|
order_tax |
|
order_currency |
|
order_coupon_code |
|
product_id |
|
product_name |
|
product_brand |
|
product_category |
|
product_quantity |
|
商品クリエイティブ名のリスト |
|
商品クリエイティブスロットのリスト |
|
商品ロケーション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 |
|
checkout_step |
|
checkout_option |
|
order_id |
|
order_total |
|
order_subtotal |
|
order_shipping |
|
order_tax |
|
order_currency |
|
order_coupon_code |
|
product_id |
|
product_brand |
|
product_category |
|
product_quantity |
|
product_unit_price |
|
product_creative_name |
|
product_creative_slot |
|
promotion_creative_name |
|
promotion_creative_slot |
|
promotion_id |
|
promotion_name |
|
商品オーディエンスパラメータ
これらの目的地にマップして、以前にマップされたイベントに追加データを渡すことができます。
パラメータは定義済みイベントでのみ使用されます。カスタムイベントでパラメータを渡す方法を学ぶには、カスタムイベント仕様の作成を参照してください。
定義済みイベントでパラメータを渡すには、次の手順に従います:
- ドロップダウンリストからイベントを選択します。
- ドロップダウンリストからパラメータを選択します。 カスタムパラメータを使用する場合は、それを識別する名前を入力します。
- 追加をクリックします。
変数 | 説明 |
---|---|
ecomm_prodid |
|
ecomm_pagetype |
|
ecomm_totalvalue |
|
ecomm_category |
|
travel_destid |
|
travel_originid |
|
travel_startdate |
|
travel_enddate |
|
travel_totalvalue |
|
hct_bpr |
|
hct_tpr |
|
hct_bid |
|
hct_cid |
|
hct_cod |
|
hct_los |
|
hct_pid |
|
hct_pagetype |
|
商品オーディエンス - 小売
変数 | 説明 |
---|---|
ecomm_prodid |
|
ecomm_pagetype |
|
ecomm_totalvalue |
|
ecomm_category |
|
商品オーディエンス - 旅行
変数 | 説明 |
---|---|
travel_destid |
|
travel_originid |
|
travel_pagetype |
|
travel_startdate |
|
travel_enddate |
|
travel_totalvalue |
|
商品オーディエンス - ホテル
変数 | 説明 |
---|---|
hct_base_price |
|
hct_total_price |
|
hct_checkin_date |
|
hct_checkout_date |
|
hct_length_of_stay |
|
hct_partner_hotel_id |
|
hct_booking_ref |
|
hct_pagetype |
|
ベンダー文書
最終更新日 :: 2025年March月14日