e コマース イベントの互換性と変換に関するリファレンス（タグ マネージャー）

このドキュメントでは、ユニバーサル アナリティクス（UA）と Google アナリティクス 4（GA4）の e コマース イベントの互換性と変換について説明します。

背景

GA4 の e コマース イベントは、UA プロパティに送信されると、同等の UA イベントに自動的に変換されます。UA の e コマース イベントを GA4 プロパティに送信する場合も変換が行われます。このドキュメントでは、変換の仕組み、イベントの互換性、自動変換を使用する場合に必要となるかもしれないトレードオフについて説明します。

目的

UA と GA4 間の e コマース イベントの変換により、次のようなメリットが得られます。

• 実装が簡単: 既存の UA 実装の設定を少し更新するだけで、GA4 の e コマースを実装できます。
• デュアルタグ設定の必要がなくなる: 同じ e コマース イベントを UA と GA4 プロパティに送信できます。この方法では、デュアルタグの設定を維持しなくても、UA の e コマース実装を維持したまま GA4 に移行できます。

トレードオフ

互換性があるため、必要に応じて短期的または長期的に UA 実装を維持しながら GA4 に移行する最適な方法を柔軟に選択することができます。

GA4 と UA の e コマースのイベント / パラメータは、そのほとんどに互換性があります。互換性がないごく一部のケースでは、選択した移行オプションよっては、UA または GA4 の e コマースのいずれかのレポートにデータが完全には入力されないことがあります。

互換性と必要な設定について詳しくは、各移行オプションを必ず確認してください。

移行の仕組み

GA4 イベントタグ

• GA4 e コマース イベントを送信するには、gtag を使用することをおすすめします。ただし、GA4 イベントタグは、データレイヤーにプッシュされた e コマースデータを読み取ることができます。
• GA4 イベントタグで直接設定される GA4 イベント パラメータは、どの gtag / データレイヤーまたはカスタム変数で提供されるデータよりも優先されます。
• GA4 イベントタグは、UA で使用される e コマース イベントデータと下位互換性があります。優先動作は次のとおりです。
  • GA4 e コマース イベントを使用する。
  • GA4 e コマース イベントが見つからない場合は、UA e コマース イベントを探して使用する。
• UA e コマース イベントを GA4 イベントタグとともに使用すると、そのイベントはまず GA4 e コマース イベントに変換されてから GA4 プロパティに送信されます。これは、gtag、データレイヤー、カスタム オブジェクトのいずれを使用する場合にも当てはまります。

UA タグ

• UA タグでは、GA4 e コマース イベント（gtag を使用して送信されたデータを含む）の読み取りがサポートされています。
• GA4 e コマース イベントの読み取りをタグで有効した場合、優先動作は次のとおりです。
  • GA4 e コマース イベントを使用する。
  • GA4 e コマース イベントが見つからない場合は、UA e コマース イベントを探して使用する。
• UA タグで GA4 e コマース イベントが使用されている場合、イベントは同等の UA e コマース イベントにまず変換されてから、UA プロパティに送信されます。これは、gtag、データレイヤー、カスタム オブジェクトのいずれを使用する場合にも当てはまります。

UA と GA4 のパラメータの対応表

次の表に、UA と GA4 で対応する e コマース パラメータを示します。

注: 空のテーブルセルは、対応するパラメータがないことを表しています。

UA のパラメータ名	GA4 のパラメータ名	備考
affiliation	affiliation
checkout_step
checkout_option
content_type
coupon	coupon
currency	currency	GA4 プロパティに UA イベントを送信する場合、この通貨の値は GA4 の items[].currency パラメータで使用されます。
	location_id
	payment_type
shipping	shipping
shipping_tier
tax	tax
transaction_id	transaction_id
value	value
items[]	items[]
items[].name	items[].item_name
items[].id	items[].item_id
	items[].affiliation
items[].brand	items[].item_brand
items[].category	items[].item_category items[].item_category2 items[].item_category3 items[].item_category4 items[].item_category5	商品アイテムのカテゴリ。最大 5 レベルの階層を指定できます。 UA イベントと GA4 イベントの間のカテゴリ変換の処理方法について詳しくは、カテゴリ パラメータの変換をご覧ください。
	items[].currency
items[].coupon	items[].coupon
	items[].discount
items[].list_name	items[].item_list_name
items[].list_position	items[].index
	items[].location_id
items[].price	items[].price
items[].quantity	items[].quantity
items[].variant	items[].item_variant
promotions[]		GA4 の場合、items[] は items[].promotion_id などのプロモーション固有のパラメータとともに使用されます。
promotions[].id	items[].promotion_id	これらのパラメータは、UA イベントを GA4 に送信する際に変換されません（GA4 イベントを UA に送信する場合も同様）。
promotions[].name	items[].promotion_name	これらのパラメータは、UA イベントを GA4 に送信する際に変換されません（GA4 イベントを UA に送信する場合も同様）。
promotions[].creative_name
promotions[].creative_slot	items[].creative_slot	これらのパラメータは、UA イベントを GA4 に送信する際に変換されません（GA4 イベントを UA に送信する場合も同様）。

カテゴリ パラメータの変換

カテゴリ パラメータの変換は、GA4 イベントを UA に送信する際の特別なケースとして処理されます（UA イベントを GA4 に送信する場合も同様）。

UA では、items[].category パラメータを設定するときに、区切り文字として / を使用して最大 5 レベルの階層を指定します。GA4 では、列挙型カテゴリ パラメータを使用して、最大 5 レベルの階層（items[].item_category、items[].item_category2、items[].item_category3、items[].item_category4、items[].item_category5）を指定します。

カテゴリ変換の動作は次のとおりです。

• UA に変換された GA4 イベントの場合、列挙型カテゴリは単一の category パラメータに結合され、各カテゴリは / で区切られます。
• GA4 に変換された UA イベントの場合、カテゴリ パラメータの値は分割され、対応する GA4 列挙型カテゴリに入力されます。
• GA4 イベントを UA に送信する予定の場合は、UA への変換時にカテゴリ区切り文字として解釈されるため、カテゴリ値に / 文字は使用しないでください。
• 定義されたレベル数に関係なく、最初の 5 つのカテゴリレベルのみが使用されます。

カテゴリ変換のサンプル

以下のサンプルは、GA4 に変換された UA カテゴリ パラメータを示しています。GA4 のイベントを UA に変換する場合も同じ原則が当てはまります。

カテゴリに 5 レベルの階層が定義された UA イベント:

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

列挙型カテゴリを持つ GA4 イベントに変換された UA イベント:

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

UA イベントと GA4 イベントとの互換性

以下の表は、UA と GA4 の対応する e コマース イベントと、UA イベントを GA4 に送信した場合（またその逆の場合）の変換動作を示しています。

表の各行の各列には、次の情報が表示されます。

• UA イベント列と GA4 イベント列は、測定対象に基づく対応するイベントを示します。
• パラメータには、対応する UA と GA4 のイベントが同等でないパラメータがリスト表示されています。「GA4 のみ」には、GA4 イベントでのみ使用されるパラメータのリストが表示され、「UA のみ」には UA イベントでのみ使用されるパラメータのリストが表示されます。
• 変換動作（UA を GA4 に送信）では、UA イベントを GA4 プロパティに送信する際の変換動作について説明します。メモには、送信されたデータの詳細、GA4 イベントとの相違点、GA4 レポートへの重要な影響が記載されています。
• 変換動作（GA4 を UA に送信）では、UA イベントを GA4 プロパティに送信する際の変換動作について説明します。メモには、送信されたデータの詳細、UA イベントとの相違点、UA レポートへの重要な影響が記載されています。

UA イベント	GA4 イベント	パラメータ	変換動作 （UA を GA4 に送信）	変換動作 （GA4 を UA に送信）
商品のインプレッション（impressions）	view_item_list	GA4 のみ: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。「GA4 のみ」のパラメータは送信されません。 イベントレベルの item_list_name パラメータは無視され、アイテムレベルの item_list_name のみ送信されます。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。
商品クリック（click）	select_item	GA4 のみ: item_list_id item_list_name items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id UA のみ: content_type	互換性なし。 select_content カスタム イベントと content_type カスタム パラメータが送信されます。items データは送信されません。	互換性なし。 general を event_category、select_item を event_action として、UA イベントヒットが送信されます。items データは送信されません。
プロモーションのクリック（promoClick）	select_promotion	GA4 のみ: creative_name creative_slot location_id promotion_id promotion_name items UA のみ: content_type promotions	互換性なし。 content_type と promotions をカスタム パラメータとして、select_content カスタム イベントが送信されます。promotions カスタム パラメータには有用なデータが含まれていません。	互換性なし。 general を event_category、select_promotion を event_action として、UA イベントヒットが送信されます。promotions データは送信されません。
商品情報の表示（detail）	view_item	GA4 のみ: currency value items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。item_list_name は例外で、送信されません。「GA4 のみ」のパラメータのうち currency と value は、それぞれヒットの通貨とトランザクション収益の値として送信されます。event_value も、整数として value パラメータに設定されます。 GA4 から UA への変換には event_value が含まれますが、これは通常では UA ヒットに設定されません。 UA レポートは、GA4 イベントのデータが入力されてほぼ完成します（または変更されません）。 アイテムリスト名は入力されません。
add_to_wishlist* *UA では、items データはサポートされていません。	add_to_wishlist	GA4 のみ: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 ecommerce を event_category、add_to_wishlist を event_action、value パラメータを event_value として、同等のイベントヒットが送信されます。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。 このイベントは通常、UA e コマース レポートでサポートされていないため大きな効果はありません。
ショッピング カートに商品を追加する（add）	add_to_cart	GA4 のみ: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。*「GA4 のみ」のパラメータは送信されません。 *item_list_name は送信されませんが、この動作は list_name を送信しない gtag.js（UA）と一致します。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。
ショッピング カートからの商品の削除（remove）	remove_from_cart	GA4 のみ: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。*「GA4 のみ」のパラメータは送信されません。 *item_list_name は送信されませんが、この動作は list_name を送信しない gtag.js（UA）と一致します。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。
なし	view_cart	このイベントは GA4 にのみ推奨されます。	互換性なし*。 *推奨イベントではないため、UA の実装ではこのイベントが送信される可能性は低くなります。GA4 レポートを完成させるには、GA4 形式を使用して UA にこのイベントを実装します。 UA に GA4 イベントを実装すると、items データのないイベントとして表示され、あまり役に立たない可能性があります。UA e コマース レポートには影響はありません。	互換性なし。 general を event_category、view_cart を event_action、value パラメータを event_value として、イベントヒットが送信されます。 items データは送信されません。 このイベントは通常、UA e コマース レポートでサポートされていないため大きな効果はありません。
決済手続き（checkout、checkout_option）	begin_checkout	GA4 のみ: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。*「GA4 のみ」のパラメータは送信されません。 *item_list_name は送信されませんが、この動作は list_name を送信しない gtag.js（UA）と一致します。 begin_checkout は、checkout_step を 1 に設定した checkout_progress イベントを送信するのと事実上同等になります。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。
add_payment_info	add_payment_info	GA4 のみ: currency value coupon payment_type items UA: 該当なし: パラメータはサポートされていません。	互換性なし*。 *UA では、このイベントのパラメータがサポートされていないため、何も送信されません。動作しますが、あまり役に立たない可能性があります。 イベント パラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 ecommerce を event_category、add_to_wishlist を event_action、value パラメータ（整数としてキャスとされる）を event_value として、同等のイベントヒットが送信されます。GA4 から UA への変換には event_value が含まれますが、これは通常では UA ヒットに設定されません。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。 このイベントは通常、UA e コマース レポートでサポートされていないため大きな効果はありません。
N/A	add_shipping_info	このイベントは GA4 にのみ推奨されます。	互換性なし*。 *推奨イベントではないため、UA の実装ではこのイベントが送信される可能性は低くなります。GA4 レポートを完成させるには、GA4 形式を使用して UA にこのイベントを実装します。 UA に GA4 イベントを実装すると、items データのないイベントとして表示され、あまり役に立たない可能性があります。UA e コマース レポートには影響はありません。	互換性なし*。 general を event_category、add_shipping_info を event_action、value パラメータ（整数としてキャスとされる）を event_value として、イベントヒットが送信されます。 GA4 currencyのパラメータは、ヒットの通貨の値として送信されます。 このイベントは通常、UA e コマース レポートでサポートされていないため大きな効果はありません。
決済手続き（checkout、checkout_option）	なし	このイベントは UA にのみ推奨されます。	イベントはカスタム イベントとして扱われます。イベントレベルのパラメータのみが送信され、items データは送信されません。 このイベントは通常、GA4 e コマース レポートでサポートされていないため大きな効果はありません。	なし
プロモーションのインプレッション（promoView）	view_promotion	GA4 のみ: creative_name creative_slot location_id promotion_id promotion_name items UA のみ: promotions	互換性なし。 promotions をカスタム パラメータとして、view_promotion カスタム イベントが送信されます。promotions カスタム パラメータには有用なデータが含まれていません。	互換性なし。 engagement を event_category、view_promotion を event_action として、UA イベントヒットが送信されます。promotions データは送信されません。イベントは、非インタラクション イベントとしてマークが付けられています。
購入を測定する（purchase）	purchase	GA4 のみ: items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 アイテムレベルの currency はサポートされていないため、イベントレベルの currency が使用されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。*「GA4 のみ」のパラメータは送信されません。 *item_list_name は送信されませんが、この動作は list_name を送信しない gtag.js（UA）と一致します。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。
払い戻しの測定（refund）	refund	GA4 のみ: affiliation items[].affiliation items[].currency items[].discount items[].item_list_id items[].location_id	互換性あり。 すべての UA パラメータが GA4 の同等のパラメータに変換されて、送信されます。 アイテムレベルの currency はサポートされていないため、イベントレベルの currency が使用されます。 「GA4 のみ」のパラメータを必要とする GA4 レポートは不完全になります。	互換性あり。 UA パラメータと同等の GA4 パラメータに変換されて、送信されます。*「GA4 のみ」のパラメータは送信されません。 *item_list_name は送信されませんが、この動作は list_name を送信しない gtag.js（UA）と一致します。 UA レポートは、GA4 イベントのデータが入力されて完成します（または変更されません）。