Microsoft Advertising Universal Event Tracking (UET) タグ構成ガイド
この記事では、Microsoft Advertising Universal Event Tracking (UET) タグの構成方法について説明します。
タグのヒント
-
マッピングを使用して:
- 標準の構成値を上書きする
- E-Commerce拡張の値を上書きする
- カスタムパラメータを渡す
- イベントトリガーを構成する
-
カスタムプロパティ/パラメータにマッピングすると、そのパラメータがすべてのイベントと共に送信されます。イベントパラメータタブを使用して、特定のイベントにのみデータを送信します
-
以下のe-commerce拡張値をサポートしています:
- 注文ID
- 注文の小計
- 注文の送料
- 注文の税金
- 注文の通貨
- 注文のクーポン/プロモーションコード
- 商品IDのリスト
- 名前のリスト
- ブランドのリスト
- カテゴリのリスト
- 数量のリスト
- 価格のリスト
タグ構成
まず、Tealiumのタグマーケットプレイスにアクセスし、Microsoft Advertising Universal Event Tracking (UET) タグを追加します。詳細については、タグの管理を参照してください。
タグを追加したら、以下の構成を行います:
- タグID:Microsoft Advertisingのタグ識別子。
- 広告保存の同意:広告保存のデフォルトの同意を構成します。データマッピングセクションの
ad_storage
パラメータをマッピングして、この値を動的に更新します。 - Tealium Consent Cookieから自動的に読み取る:
true
に構成すると、同意はTealium Consent Managerに基づいて構成されます。
同意モード
このタグの同意モードを実装するには、2つのオプションがあります:
- Tealium Consent Managementを使用し、Tealium Consent cookieを自動的に読み取ります。
- JavaScript Code extensionを追加し、あなたの同意管理プラットフォーム(CMP)からの同意選択とカテゴリマッピングをこのタグにマッピングします。
訪問が同意選択を行うと、タグは第一者と第三者のクッキーに対する適切なアプローチを選択します:
- 許可:第一者と第三者の両方のクッキーを読み取り、書き込むことができます。
- 拒否:第一者のクッキーは読み取られず、書き込まれず、第三者のクッキーは詐欺とスパムの目的のためにのみ読み取られ、広告のためには使用されません。
Tealium Consent Management
Tealium Consent Managementを使用してこのタグの同意モードを実装するには、タグ構成でTealium Consent Cookieから自動的に読み取るをtrue
に構成します。
JavaScript Code extension
エンドユーザーの同意選択をMicrosoftの同意モード構成にマッピングするには、JavaScript Code extensionを使用します。次のように拡張を構成します:
- スコープを**After Load Rules (default)**に構成します
- 発生を常に実行に構成します
- あなたのCMPのJavaScriptコードを入力します。以下のコードテンプレートをあなたのCMPに合わせてカスタマイズし、
CUSTOM_LOGIC
をあなたのベンダーのロジックに置き換えます。
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
パラメータをあなたの特定のケースの属性にマッピングして、これらの変数を上書きします。
データマッピング
マッピングとは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。変数をタグの宛先にマッピングする方法については、Data Mappingsを参照してください。
利用可能なカテゴリは以下の通りです:
標準
変数 | 説明 |
---|---|
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 |
|
custom.myvar |
|
E-Commerce
変数 | 説明 |
---|---|
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 |
|
custom |
|
商品オーディエンスイベント
ページ上で特定のイベントをトリガーするためにこれらの目的地にマッピングします。
イベントをトリガーするための次の手順を使用します:
- ドロップダウンリストからイベントを選択します。
事前定義されたリストから選択するか、カスタムイベントを作成します。
- カスタムイベントの場合、それを識別する名前を入力します。
- トリガーフィールドに、マッピングされる変数の値を入力します。
- より多くのイベントをマッピングするには、プラス記号(+)をクリックして手順1と2を繰り返します。
- 適用をクリックします。
提供された値がデータレイヤーで見つかったときにイベントがトリガーされます。
変数 | 説明 |
---|---|
retail |
|
travel |
|
hotel |
|
イベントパラメータ
以前にマッピングしたイベントに追加のデータを渡したい場合、これらの目的地にマッピングします。
パラメータは事前定義されたイベントでのみ使用されます。カスタムイベントでパラメータを渡す方法を学ぶには、カスタムイベント仕様の作成を参照してください。
事前定義されたイベントでパラメータを渡すための次の手順を使用します:
- ドロップダウンリストからイベントを選択します。
- ドロップダウンリストからパラメータを選択します。
カスタムパラメータを使用する場合、それを識別する名前を入力します。 - 追加をクリックします。
変数 | 説明 |
---|---|
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 |
|
ベンダー文書
最終更新日 :: 2024年November月6日