このページは Cloud Translation API によって翻訳されました。

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 コマースレポートでサポートされていないため大きな効果はありません。
該当なし	`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 イベントのデータが入力されて完成します（または変更されません）。

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

背景

目的

トレードオフ

移行の仕組み

GA4 イベントタグ

UA タグ

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

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

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

`view_item_list`

`select_item`

`select_promotion`

`view_item`

`add_to_wishlist`

`add_to_cart`

`remove_from_cart`

`view_cart`

`begin_checkout`

`add_payment_info`

`add_shipping_info`

`view_promotion`

`purchase`

`refund`

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

背景

目的

トレードオフ

移行の仕組み

GA4 イベントタグ

UA タグ

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

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

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

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

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