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のサードパーティCookie IDに永続化します。Microsoft Advertising Conversion APIコネクタを使用する場合に推奨されます。
- Ad Storage Consent:広告保存に対するデフォルトの同意を構成します。Data Mappingsセクションで
ad_storageパラメータをマッピングすることにより、この値を動的に更新できます。 - Automatically read from Tealium Consent Cookie:
trueに構成すると、Tealium同意管理に基づいて同意が構成されます。 - Generate Event ID:トラッキングイベントごとにイベントIDを自動生成します。Microsoft Advertising Conversion APIコネクタを使用する場合の重複除外に推奨されます。
Conversions API
この機能を使用するには、有効なTealium Collectタグが必要です。
Microsoft Advertising Conversion APIをサポートするには、Generate Event IDをtrueに構成します。Generate Event IDを有効にすると、このタグはトラッキング対象の各イベントに一意のイベントIDを生成し、Microsoft Advertising Conversion APIコネクタで使用するための属性としてイベントストリーミングに送信するとともに、event_idパラメータでMicrosoft Advertising UETタグに渡します。このイベントID属性をコネクタでマッピングすることで、Webベースのタグとサーバーサイド統合を同期できます。
タグは、以下の命名規則に従って生成されたイベント属性を使用してイベント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画面を使用して、Microsoft Advertising UETタグがTealium Collectタグより先に実行されるようにします。Tealium Collectタグは最後に実行することを推奨します。
これらのイベントID属性の使用方法については、Microsoft Advertising Conversion APIコネクタ:重複除外を参照してください。
読み込みルール
すべてのページでタグを読み込むか、タグを読み込む条件を構成します。詳細については、読み込みルールについてを参照してください。
同意モード
このタグに同意モードを実装する方法は2つあります。
- クライアントサイドの同意管理を使用し、Tealium同意Cookieを自動的に読み取ります。
- JavaScriptコード拡張機能を追加し、同意管理プラットフォーム(CMP)の同意選択とカテゴリマッピングをこのタグにマッピングします。
訪問が同意を選択すると、タグはファーストパーティCookieとサードパーティCookieに対して適切な処理を選択します。
- Granted:ファーストパーティCookieとサードパーティCookieの両方を読み書きできます。
- Denied:ファーストパーティCookieは読み書きされません。サードパーティCookieは広告目的ではなく、不正行為およびスパム対策の目的に限り、読み取り専用で使用されます。
クライアントサイドの同意管理
クライアントサイドの同意管理を使用してこのタグに同意モードを実装するには、タグ構成でAutomatically read from Tealium Consent Cookieをtrueに構成します。
JavaScriptコード拡張機能
エンドユーザーの同意選択をMicrosoftの同意モード構成にマッピングするには、JavaScriptコード拡張機能を使用します。拡張機能を以下のように構成します。
- Scopeを**After Load Rules (default)**に構成します。
- OccurrenceをRun Alwaysに構成します。
- 使用しているCMPのJavaScriptコードを入力します。以下のコードテンプレート内の
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 |
|
ベンダーのドキュメント
最終更新日 :: 2026年November月10日