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

GA4 e コマース（gtag.js）: GA4 イベントを送信する

このガイドでは、既存の gtag.js ユニバーサルアナリティクス（UA）e コマースの実装を移行して、Google アナリティクス 4（GA4）の e コマースイベントを使用する方法について説明します。

その他の移行ガイドとリソースについては、デベロッパー移行センターをご覧ください。

結果

このガイドに従うと、新しい GA4 プロパティに GA4 e コマースイベントが実装され、その新しい実装を使って既存の UA のレポートが入力されるようになります。既存の UA 実装は、GA4 e コマースデータを受け取るように変更されます。

始める前に

e コマース移行ヘルパーツールを使用して、現在の実装が次の条件を満たしていることを確認してください。
- UA プロパティを使用していること
- サイトで gtag.js ライブラリを使用して e コマースイベントを送信していること
各オプションのトレードオフについては、e コマース実装の移行オプションをご覧ください。このガイドの手順に従うと、既存の gtag.js UA 実装に GA4 e コマースイベントが使用されることになります。そのような結果を本当に望んでいるかどうかをご確認ください。
GA4 プロパティへの送信時の UA イベントの変換方法については、イベント互換性に関するリファレンスをご覧ください。

トレードオフと考慮事項

以下の情報をご確認のうえ、既存の gtag.js（UA）e コマース実装で GA4 プロパティ e コマースイベントを使用する場合の影響について十分に理解するようにしてください。

メリット	デメリット
GA4 と UA のレポートの両方で e コマースデータを確認できます。 GA4 のイベントとパラメータを使用することで、GA4 の e コマースレポートを確実に完成させることができます。	既存の e コマースイベントを変更する必要があります。すべての GA4 イベントとパラメータが、UA に同等のものがあるとは限りません。`shipping_tier`、`discount`、`currency`、`location_id`、`promotion_name`、`promotion_id` のパラメータは、UA に同等のパラメータがないため、UA レポートに表示されません。

実装

1. e コマース実装を更新する

既存の e コマース実装を更新して、UA e コマースイベントの使用から GA4 イベントの使用に移行します。この手順を完了すると、UA プロパティに GA4 e コマースイベントが送信されます。この更新による影響を理解するために、トレードオフと考慮事項をご確認ください。

更新の際は、次のリソースを参考にしてください。

GA4 e コマースのガイド。GA4 e コマースイベントを送信する方法について説明しています。
UA イベントと GA4 イベント間の互換性を示す表と UA と GA4 のパラメータの対応表にある情報。この情報は、UA e コマースイベント名とパラメータを、GA4 の同等のイベントとパラメータにマッピングするのに役立ちます。
e コマース移行ヘルパーツールを使用すると、e コマースイベントが正しく更新されたことを確認できます。

2. 新しい GA4 プロパティを作成して設定する

GA4 e コマースイベントを送信するように e コマースの実装を更新したら、次のいずれかのオプションを使用して、新しい GA4 プロパティへのデータ送信を開始します。

オプション 1: GA4 設定アシスタントを使用し、接続済みのサイトタグを有効にする

GA4 設定アシスタントを使用すると、新しい GA4 プロパティが自動的に作成され、UA プロパティから設定（プロパティ名、ウェブサイトの URL、タイムゾーン、通貨の設定）がコピーされます。また、接続済みのサイトタグ機能を有効にして、既存の UA gtag.js 実装を再利用し、新しい GA4 プロパティを読み込むこともできます。

GA4 設定アシスタントの手順に沿って、新しい GA4 プロパティを作成して設定してください。接続済みのサイトタグ機能を使用するには、[既存のタグを使用してデータ収集を有効にします] オプションを必ずオンにします。

オプション 2: gtag.js スニペットを更新する

新しい GA4 プロパティを作成します。
- GA4 設定アシスタントを使用して、GA4 プロパティを追加しますが、設定時に表示されるプロンプトで [既存のタグを使用してデータ収集を有効にします] オプションはオフにします。別の方法として、GA4 設定アシスタントを使用せずに GA4 プロパティを作成することもできます。設定アシスタントを使用すれば、一部の基本設定が UA のプロパティからコピーされるメリットがあります。
GA4 プロパティのタグ ID を見つけます。
タグ ID が指定された config コマンドを使用して、既存の gtag.js スニペットに GA4 プロパティを追加します。

以下は、ユニバーサルアナリティクスと Google アナリティクス 4 の各プロパティを設定した gtag.js スニペットの例です。

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');  // Universal Analytics property
  gtag('config', 'TAG_ID');  // Google Analytics 4 property
</script>