Diese Seite wurde von der Cloud Translation API übersetzt.

GA4-E-Commerce (analytics.js – Standard-E-Commerce): GA4-E-Commerce-Ereignisse senden

In diesem Leitfaden wird beschrieben, wie Sie eine bestehende E-Commerce-Standardimplementierung für analytics.js Universal Analytics zur Verwendung von Google Analytics 4-E-Commerce-Ereignissen migrieren.

Im Migrationscenter für Entwickler finden Sie weitere Migrationsleitfäden und ‐ressourcen.

Ergebnis

Wenn Sie diesem Leitfaden folgen, werden bei der neuen Google Analytics 4-Implementierung GA4-E-Commerce-Ereignisse an eine neue GA4-Property und eine vorhandene Universal Analytics-Property gesendet. Die bestehende Universal Analytics-Property erhält E-Commerce-Daten aus GA4, die Berichte bleiben jedoch unverändert.

Dies sind zwei Migrationsphasen:

UA-Transaktionen zu einem GA4-Kaufereignis migrieren
- Standard-E-Commerce für Universal Analytics unterstützt das Senden von Transaktions- und Artikeldaten. Die Migration zu einem Google Analytics 4-Ereignis vom Typ purchase bietet gleichwertige Funktionen.
Optional: Zusätzliche GA4-E-Commerce-Ereignisse messen
- Implementieren Sie weitere GA4-E-Commerce-Ereignisse, um die GA4-E-Commerce-Funktionen optimal zu nutzen. Beispiele: Produktaufrufe und Interaktionen, Interaktionen vor dem Kauf, Bezahlinteraktionen

Hinweis

Prüfen Sie, ob Ihre aktuelle Implementierung folgendermaßen beschrieben ist:
- Sie verwenden eine Universal Analytics-Property.
  - Wenn Ihre Property eine Tracking-ID hat, ist es Universal Analytics.
- Auf Ihrer Website wird die analytics.js-Bibliothek verwendet, um E-Commerce-Ereignisse zu senden.
Sehen Sie sich die Migrationsoptionen für E-Commerce-Implementierungen an, um mehr über die Vor- und Nachteile der beiden Optionen zu erfahren. Bestätigen Sie, dass Sie diesem Leitfaden folgen möchten, um Google Analytics 4-E-Commerce-Ereignisse für Ihre bestehende Universal Analytics-Implementierung zu verwenden.
In der Referenz zur Ereigniskompatibilität finden Sie Informationen dazu, wie das GA4-Kaufereignis beim Senden an eine UA-Property übersetzt wird.

Vor- und Nachteile

Lesen Sie die folgenden Informationen, um die Auswirkungen der Verwendung von Google Analytics 4-E-Commerce-Ereignissen mit Ihrer Universal Analytics-E-Commerce-Implementierung vollständig zu verstehen.

Vorteile	Nachteile
E-Commerce-Daten können Sie sowohl in GA4- als auch in Universal Analytics-Berichten abrufen. Durch die Migration zum GA4-Ereignis `purchase` erhalten Sie vollständige UA-E-Commerce-Berichte.	Zusätzlicher Aufwand bei der Migration von analytics.js zu gtag.js Wir empfehlen, alle benutzerdefinierten Analysen von analytics.js zu gtag.js zu migrieren (z. B. Ereignisse, Seitenaufrufe, Timing usw.).

Implementierung

1. UA-Analyse von analytics.js zu gtag.js migrieren

Wenn Sie GA4-E-Commerce-Ereignisse senden möchten, müssen Sie von analytics.js zu gtag.js migrieren, einschließlich aller benutzerdefinierten Analysen.

Im Allgemeinen umfassen die Schritte zum Abschließen der Migration folgende Schritte:

Bitte entfernen Sie das analytics.js-Snippet.
Binden Sie das Google-Tag (gtag.js) ein und konfigurieren Sie die Konfiguration mit der Tracking-ID Ihrer UA-Property.
Migrieren Sie Ihren benutzerdefinierten Messcode von analytics.js zu gtag.js. In den folgenden Abschnitten wird beschrieben, wie Sie eine Standard-E-Commerce-Transaktion migrieren. Unter Messmigration erhalten Sie allgemeine Hilfe zur Migration anderer Messszenarien.

Vorher: analytics.js-Tag

<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');    // Universal Analytics property.
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->

Nachher: Google-Tag (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.
</script>

2. E-Commerce-Implementierung aktualisieren, um GA4-Ereignisse zu senden

Aktualisieren Sie Ihre vorhandene E-Commerce-Implementierung, um von Universal Analytics-E-Commerce-Ereignissen auf Google Analytics 4-Ereignisse zu migrieren. Sobald Sie diesen Schritt ausgeführt haben, empfängt Ihre Universal Analytics-Property ein GA4-purchase-Ereignis. Lesen Sie den Abschnitt Abwägungen und Überlegungen, um die Auswirkungen dieser Aktualisierung zu verstehen.

Im folgenden Beispiel wird gezeigt, wie Sie ein standardmäßiges analytics.js-E-Commerce-Transaktionsereignis zu einem entsprechenden E-Commerce-Ereignis vom Typ purchase in GA4 migrieren, das mit Universal Analytics kompatibel ist.

Vorher: UA-Standard-E-Commerce-Transaktion (analytics.js)

Das folgende Beispiel zeigt eine analytics.js-Standard-E-Commerce-Implementierung für eine Transaktion mit zwei Artikeln:

// Add the transaction.
ga('ecommerce:addTransaction', {
  id: '1234',     // Transaction ID.
  affiliation: 'Google Store',
  revenue: '29.97',
  shipping: '5.25',
  tax: '2.42'
});

// Add the items belonging to the transaction.
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Android Warhol T-Shirt',
  sku: 'P12345',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '12.99',
  quantity: '2'
});
ga('ecommerce:addItem', {
  id: '1234',     // Transaction ID.
  name: 'Flame challenge T-Shirt',
  sku: 'P67890',  // Item ID.
  category: 'Apparel/T-Shirts',
  price: '3.99',
  quantity: '1'
});
ga('ecommerce:send');

Nachher: GA4-E-Commerce-Kauf (gtag.js)

Wenn Sie ein analytics.js-Transaktionsereignis zu einem GA4-purchase-Ereignis migrieren, gibt es folgende wesentliche Unterschiede:

In GA4 gibt es ein einzelnes purchase-Ereignis, das alle Details und Artikel im Zusammenhang mit der Transaktion enthält. analytics.js führt mehrere ga()-E-Commerce-Befehle aus, um dieselben Informationen zu erfassen.
In GA4 gibt es ein einzelnes transaction_id-Feld für das gesamte Ereignis. In analytics.js muss jedem Element die Transaktions-ID hinzugefügt werden.
GA4 enthält mehrere Artikelkategoriefelder. In analytics.js wird zur Beschreibung von Hierarchien ein einzelnes Kategoriefeld mit einem /-Trennzeichen verwendet. GA4-Ereignisse mit mehreren Feldern für Artikelkategorien funktionieren jedoch aufgrund der Übersetzung von Kategorieparametern für Ihre UA-Property.

 gtag('event', 'purchase', {
   currency: 'USD',
   transaction_id: '1234',    // Transaction ID.
   value: 29.97,
   affiliation: 'Google Store',
   shipping: 5.25,
   tax: 2.42,
   items: [
    {
      item_id: 'P12345',     // Item ID.
      item_name: 'Android Warhol T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 12.99,
      quantity: 2
    },
    {
      item_id: 'P67890',    // Item ID.
      item_name: 'Flame challenge T-Shirt',
      item_category: 'Apparel',
      item_category2: 'T-Shirts',
      price: 3.99,
      quantity: 1
    }
  ]
});

3. Neue GA4-Property erstellen und konfigurieren

Nachdem Sie Ihre E-Commerce-Implementierung so aktualisiert haben, dass GA4-E-Commerce-Ereignisse gesendet werden, haben Sie zwei Möglichkeiten, um Daten an eine neue Google Analytics 4-Property zu senden.

Option 1: GA4-Einrichtungsassistent verwenden und verbundene Website-Tags aktivieren

Mit dem Assistenten zum Einrichten einer GA4-Property wird automatisch eine neue GA4-Property erstellt und die folgenden Einstellungen aus Ihrer Universal Analytics-Property kopiert: Property-Name, Website-URL, Zeitzone und Währungseinstellungen. Außerdem lässt sich die Funktion verbundenes Website-Tag aktivieren, um die gtag.js-Implementierung von Universal Analytics wiederzuverwenden, um die neue GA4-Property zu laden.

Folgen Sie der Anleitung im Assistenten zum Einrichten einer GA4-Property, um eine neue Google Analytics 4-Property zu erstellen und zu konfigurieren. Klicken Sie das Kästchen Datenerhebung unter Verwendung der vorhandenen Tags aktivieren an, um die Funktion für verbundene Website-Tags zu verwenden.

Option 2: gtag.js-Snippet aktualisieren

Erstellen Sie eine neue Google Analytics 4-Property.
- Mit dem Assistenten zum Einrichten einer GA4-Property können Sie eine Google Analytics 4-Property hinzufügen. Wenn Sie während der Einrichtung dazu aufgefordert werden, entfernen Sie jedoch das Häkchen bei Datenerhebung unter Verwendung der vorhandenen Tags aktivieren. Alternativ können Sie eine Google Analytics 4-Property ohne den GA4-Einrichtungsassistenten erstellen. Der Vorteil des Assistenten besteht darin, dass er einige grundlegende Einstellungen aus Ihrer Universal Analytics-Property kopiert.
Suchen Sie die Tag-ID für die Google Analytics 4-Property.
Fügen Sie die Google Analytics 4-Property dem vorhandenen gtag.js-Snippet hinzu. Verwenden Sie dazu den Befehl config mit der Tag-ID.

Hier sehen Sie ein Beispiel für ein gtag.js-Snippet, für das eine Universal Analytics- und eine Google Analytics 4-Property konfiguriert wurde.

<!-- 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>

4. Optional: Zusätzliche E-Commerce-Ereignisse messen

Wenn Sie zusätzliche GA4-E-Commerce-Ereignisse implementieren möchten, sollten Sie zusätzliche GA4-E-Commerce-Ereignisse implementieren. Weitere Informationen finden Sie unter Google Analytics 4 – E-Commerce.

Wenn Sie die standardmäßige gtag.js-Snippet-Konfiguration verwenden, werden GA4-Ereignisse sowohl an die UA- als auch die GA4-Property gesendet. GA4-Ereignisse, die an Ihre UA-Property gesendet werden, werden wie in der Referenz zur Ereigniskompatibilität definiert. Wenn Sie ein anderes Verhalten bevorzugen, können Sie mit der Funktion Daten gruppieren und weiterleiten von gtag.js steuern, welche Ereignisse an Ihre UA- und GA4-Property gesendet werden. So können Sie beispielsweise das purchase-Ereignis sowohl an die UA- als auch an die GA4-Property, aber nur andere GA4-E-Commerce-Ereignisse an Ihre GA4-Property senden.