Microsoft Advertising ユニバーサルイベントトラッキング(UET)タグ構成ガイド
この記事では、Microsoft Advertising ユニバーサルイベントトラッキング(UET)タグの構成方法について説明します。
タグのヒント
- マッピングを使用して:
- 標準構成値を上書きします。
- Eコマース拡張値を上書きします。
- カスタムパラメーターを渡します。
- イベントトリガーを構成します。
- Standard タブで Custom Property/Parameter にパラメーターをマッピングすると、そのパラメーターはすべてのイベントに送信されます。特定のイベントにのみデータを送信するには、Event Parameters タブを使用します。
- 次のEコマース拡張値をサポートします:
- 注文ID。
- 注文小計。
- 注文送料。
- 注文税金。
- 注文通貨。
- 注文クーポン/プロモーションコード。
- 製品IDのリスト。
- 名前のリスト。
- ブランドのリスト。
- カテゴリのリスト。
- 数量のリスト。
- 価格のリスト。
タグの構成
タグマーケットプレイスにアクセスして新しいタグを追加します。詳細については、タグについてを参照してください。
タグを追加する際には、以下の構成を構成します:
- Tag ID: あなたのMicrosoft Advertisingタグ識別子。
- ID Sync Beacon: 内部ユーザーIDをMicrosoftのサードパーティクッキーIDに持続させます。Microsoft UET Conversion APIコネクタを使用する場合に推奨されます。
- Ad Storage Consent: 広告保存のデフォルト同意を構成します。
ad_storageパラメーターをData Mappingsセクションでマッピングすることにより、この値を動的に更新します。 - Automatically read from Tealium Consent Cookie:
trueに構成すると、Tealium consent managerに基づいて同意が構成されます。 - Generate Event ID: すべてのトラッキングイベントに対して自動的にイベントIDを生成します。Microsoft UET Conversion APIコネクタを使用する際の重複排除に推奨されます。
Conversions API
この機能にはアクティブなTealium Collect tagが必要です。
Microsoft UET Conversion APIをサポートするには、Generate Event IDをtrueに構成します。Generate Event IDが有効になっている場合、このタグは追跡される各イベントに対して一意のイベントIDを生成し、それをTealium EventStreamの属性として送信し、Microsoft UET Conversion APIコネクタで使用し、event_idパラメーターでMicrosoft Advertising UETタグに渡します。このイベントID属性は、コネクタでマッピングされ、ウェブベースのタグとサーバーサイドの統合を同期させることができます。
タグは、以下の命名規則を使用してイベントIDを生成したイベント属性を送信します:
microsoft_event_id_{EVENT_TYPE}_{TAG_UID}
例えば、タグ#88からの購入イベントは、以下の属性と値を送信します:
{
"microsoft_event_id_purchase_88": "028b2ade7478..."
}
同じタグからのページロードイベントは、以下の属性と値を送信します:
{
"microsoft_event_id_pageload_88": "084b1cda7461..."
}
重複排除
適切なイベント重複排除を確保するために、Microsoft Advertising UETタグからのイベントIDをTealium Collectタグによって送信されるペイロードに含める必要があります。これを行うには、次の手順を使用します:
- Tag TimingドロップダウンからPrioritizedを選択します。
- Bundle Flagトグルを
Onに構成します。 - Load Order Manager screenを使用して、Tealium Collectタグの前にMicrosoft Advertising UETタグを発火させます。Tealium Collectタグは最後に発火させることをお勧めします。 これらのイベントID属性の使用についての情報は、Microsoft UET Conversion APIコネクタ:重複排除を参照してください。
ロードルール
すべてのページでタグをロードするか、タグがロードされる条件を構成します。詳細については、ロードルールについてを参照してください。
同意モード
このタグの同意モードを実装するには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用の次のコードテンプレートをカスタマイズします。
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 |
自動SPAトラッキングを有効にする。 |
id_sync_beacon |
ID同期ビーコン。 |
customer_id |
Microsoftの顧客ID。 |
visitor_id |
訪問ID。 |
user_id |
ユーザーID。 |
custom.myvar |
|
generate_event_id |
Boolean |
event_id |
String |
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 |
|
product_unit_price |
|
| 製品クリエイティブ名のリスト |
|
| 製品クリエイティブスロットのリスト |
|
| 製品ロケーション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_name |
|
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年December月3日