Kompatibilität von E-Commerce-Ereignissen und Übersetzungsreferenz (gtag.js)

In diesem Dokument wird die Kompatibilität von E-Commerce-Ereignissen und die Übersetzung zwischen Universal Analytics (UA) und Google Analytics 4 (GA4) beschrieben.

Hintergrund

GA4-E-Commerce-Ereignisse werden automatisch in entsprechende UA-Ereignisse umgewandelt, wenn sie an eine UA-Property gesendet werden. Die Übersetzung erfolgt auch, wenn UA-E-Commerce-Ereignisse an eine GA4-Property gesendet werden. In diesem Dokument werden die Funktionsweise der Übersetzung, die Kompatibilität von Ereignissen und etwaige Nachteile erläutert, die Sie bei der Verwendung der automatischen Übersetzung eingehen müssen.

Zweck

Die Übersetzung von E-Commerce-Ereignissen aus UA und GA4 bietet folgende Vorteile:

  • Einfache Implementierung: Sie können GA4-E-Commerce verwenden, indem Sie Ihre bestehende UA-Implementierung mit einem geringfügigen Konfigurationsupdate verwenden.
  • Doppeltes Tagging vermeiden: Sie können dieselben E-Commerce-Ereignisse an eine UA- und eine GA4-Property senden. Sie haben die Möglichkeit, auf GA4 umzustellen und Ihre UA-E-Commerce-Implementierung beizubehalten, ohne dass eine Zwei-Tag-Konfiguration verwaltet werden muss.

Vor- und Nachteile

Dank der Kompatibilität können Sie flexibel einen GA4-Migrationspfad auswählen, der am besten geeignet ist, um Ihre kurz- und langfristigen Anforderungen an die Aufrechterhaltung Ihrer UA-Implementierung zu erfüllen.

Die meisten E-Commerce-Ereignisse und -Parameter aus GA4 sind mit UA kompatibel und umgekehrt. Bei wenigen Fällen mit Inkompatibilitäten werden je nach gewählter Migration entweder Ihre UA- oder GA4-E-Commerce-Berichte möglicherweise nicht vollständig mit Daten gefüllt.

Es ist wichtig, dass Sie sich die einzelnen Migrationsoptionen ansehen, um Details zur Kompatibilität und zur erforderlichen Konfiguration zu erhalten.

So funktioniert die Übersetzung

  • Wenn ein GA4-E-Commerce-Ereignis an eine UA-Property gesendet wird, wird es in das entsprechende UA-E-Commerce-Ereignis (gtag.js) umgewandelt.
    • UA-Ereignisparameter werden mit Werten aus vergleichbaren GA4-Parametern ausgefüllt. Wenn ein UA-Parameter nicht aus einem GA4-Ereignis ausgefüllt werden kann (es gibt also keinen vergleichbaren Parameter), wird er weggelassen, wenn das Ereignis an die UA-Property gesendet wird.
  • Wenn ein UA-E-Commerce-Ereignis (gtag.js) an eine GA4-Property gesendet wird, wird es in das entsprechende GA4-E-Commerce-Ereignis umgewandelt.
    • GA4-Ereignisparameter werden mit Werten aus vergleichbaren UA-Parametern ausgefüllt. Wenn ein GA4-Parameter nicht aus einem UA-Ereignis ausgefüllt werden kann, es also keinen entsprechenden Parameter gibt, wird er weggelassen, wenn das Ereignis an die GA4-Property gesendet wird. Wenn ein UA-Parameter keinen vergleichbaren GA4-Parameter hat, wird er in einigen Fällen mit dem GA4-Ereignis als benutzerdefinierten Parameter gesendet.
  • Alle Übersetzungen von GA4 in UA und umgekehrt werden clientseitig durchgeführt.
  • Übersetzungen für Ereignisse und Parameter sind standardmäßig aktiviert. Es ist keine Nutzerkonfiguration erforderlich und kann nicht deaktiviert werden.

Vergleichbare Parameter für UA und GA4

In der folgenden Tabelle sehen Sie vergleichbare E-Commerce-Parameter für Universal Analytics und Google Analytics 4.

Universal Analytics-Parametername Google Analytics 4-Parametername Hinweise
affiliation affiliation
checkout_step
checkout_option
content_type
coupon coupon
currency currency Wenn Sie ein UA-Ereignis an eine GA4-Property senden, wird dieser Währungswert für den GA4-Parameter items[].currency verwendet.
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
Die Kategorie des Artikels Es können bis zu fünf Hierarchieebenen angegeben werden.

Weitere Informationen zur Übersetzung von Kategorieparametern zwischen UA- und GA4-Ereignissen finden Sie unter Übersetzung von Kategorieparametern.
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[] Für GA4 wird items[] mit angebotsspezifischen Parametern wie items[].promotion_id verwendet.
promotions[].id items[].promotion_id Diese Parameter werden nicht übersetzt, wenn ein UA-Ereignis an GA4 gesendet wird oder umgekehrt.
promotions[].name items[].promotion_name Diese Parameter werden nicht übersetzt, wenn ein UA-Ereignis an GA4 gesendet wird oder umgekehrt.
promotions[].creative_name
promotions[].creative_slot items[].creative_slot Diese Parameter werden nicht übersetzt, wenn ein UA-Ereignis an GA4 gesendet wird oder umgekehrt.

Übersetzung von Kategorieparametern

Die Übersetzung des Kategorieparameters wird als Sonderfall gehandhabt, wenn GA4-Ereignisse an UA gesendet werden oder umgekehrt.

Wenn Sie in Universal Analytics den Parameter items[].category festlegen, verwenden Sie / als Trennzeichen, um bis zu fünf Hierarchieebenen festzulegen. In Google Analytics 4 können Sie mithilfe von Aufzählungskategorieparametern bis zu fünf Hierarchieebenen angeben: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4 und items[].item_category5.

Das Verhalten bei der Kategorieübersetzung sieht so aus:

  • Bei GA4-Ereignissen, die in UA umgewandelt werden, werden die Aufzählungskategorien in einem einzigen category-Parameter zusammengefasst, wobei jede Kategorie durch / getrennt wird.
  • Bei UA-Ereignissen, die in GA4 umgewandelt werden, wird der Wert des Kategorieparameters in die entsprechenden GA4-Aufzählungskategorien aufgeteilt.
  • Wenn Sie GA4-Ereignisse an UA senden möchten, sollten Sie das Zeichen / nicht in Kategoriewerten verwenden, da es bei der Übersetzung in UA als Kategorietrennzeichen interpretiert wird.
  • Es werden nur die ersten fünf Kategorieebenen verwendet, unabhängig davon, wie viele definiert sind.

Beispiel für die Übersetzung von Kategorien

Die folgenden Beispiele zeigen einen UA-Kategorieparameter, der in GA4 umgewandelt wurde. Das gleiche Prinzip gilt bei der Übersetzung eines GA4-Ereignisses in UA.

Ein UA-Ereignis mit einer Kategorie, die fünf Hierarchieebenen definiert:

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

Das UA-Ereignis wurde in ein GA4-Ereignis mit Aufzählungskategorien umgewandelt:

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

Kompatibilität zwischen UA- und GA4-Ereignissen

In der folgenden Tabelle sehen Sie vergleichbare E-Commerce-Ereignisse für Universal Analytics und Google Analytics 4 sowie das Übersetzungsverhalten beim Senden eines UA-Ereignisses an GA4 und umgekehrt.

Für jede Zeile in der Tabelle enthält jede Spalte die folgenden Informationen:

  • In den Spalten UA-Ereignis und GA4-Ereignisse werden vergleichbare Ereignisse basierend auf dem Ereignis angezeigt, das mit ihnen gemessen werden soll.
  • Unter Parameter werden Parameter aufgelistet, für die es zwischen den jeweiligen UA- und GA4-Ereignissen keine Entsprechung gibt. Nur GA4 enthält Parameter, die nur mit dem GA4-Ereignis verwendet werden, und Nur UA enthält Parameter, die nur mit dem UA-Ereignis verwendet werden.
  • Unter Übersetzungsverhalten (UA an GA4 senden) wird das Übersetzungsverhalten beschrieben, wenn ein UA-Ereignis an eine GA4-Property gesendet wird. Die Hinweise enthalten Details zu den gesendeten Daten, den Unterschieden zum GA4-Ereignis und zu den wichtigsten Auswirkungen auf GA4-Berichte.
  • Unter Übersetzungsverhalten (GA4 an UA senden) wird das Übersetzungsverhalten beim Senden eines UA-Ereignisses an eine GA4-Property beschrieben. Sie finden hier Details zu den gesendeten Daten, den Unterschieden zum UA-Ereignis und zu nennenswerten Auswirkungen auf UA-Berichte.
UA-Ereignis GA4-Ereignis Parameter Übersetzungsverhalten
(UA an GA4 senden)
Übersetzungsverhalten
(GA4 wird an UA gesendet)
view_item_list Nur GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet. Nur GA4-Parameter werden nicht gesendet. Der Parameter item_list_name auf Ereignisebene wird ignoriert. Nur der item_list_name auf Artikelebene wird gesendet.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert.
select_content (items) Nur GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id

Nur UA:
content_type
Nicht kompatibel.

Ein benutzerdefiniertes select_content-Ereignis und ein benutzerdefinierter Parameter content_type werden gesendet. Es werden keine items-Daten gesendet.
Nicht kompatibel.

Ein UA-Ereignistreffer wird mit general als event_category und select_item als event_action gesendet. Es werden keine items-Daten gesendet.
select_content (promotions) Nur GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Nur UA:
content_type
promotions
Nicht kompatibel.

Ein benutzerdefiniertes select_content-Ereignis wird mit content_type und promotions als benutzerdefinierte Parameter gesendet. Der benutzerdefinierte Parameter promotions enthält keine nützlichen Daten.
Nicht kompatibel.

Ein UA-Ereignistreffer wird mit general als event_category und select_promotion als event_action gesendet. Es werden keine promotions-Daten gesendet.
view_item Nur GA4:
currency
value
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet. Die Ausnahme ist item_list_name, die nicht gesendet wird. Von den ausschließlich GA4-Parametern werden currency und value mit dem Treffer als currency bzw. Transaktionsumsatz gesendet. event_value ist auch auf den Parameter value als Ganzzahl festgelegt. Die Übersetzung von GA4 in UA enthält event_value. Dieser Wert wird jedoch normalerweise nicht für UA-Treffer festgelegt.

UA-Berichte, die mit Daten aus GA4 gefüllt werden, sind größtenteils vollständig bzw. unverändert. Der Name der Artikelliste fehlt.
add_to_wishlist*

*items-Daten werden für UA nicht unterstützt.
Nur GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

Ein gleichwertiger Ereignistreffer wird mit ecommerce als event_category, add_to_wishlist als event_action und dem Parameter value als event_value gesendet.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert. Da dieses Ereignis in UA-E-Commerce-Berichten im Allgemeinen nicht unterstützt wird, hat es keine nennenswerte Auswirkung.
add_to_cart Nur GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet.* Nur GA4-Parameter werden nicht gesendet.

*item_list_name wird nicht gesendet. Dieses Verhalten entspricht jedoch gtag.js (UA), über das list_name nicht gesendet wird.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert.
remove_from_cart Nur GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet.* Nur GA4-Parameter werden nicht gesendet.

*item_list_name wird nicht gesendet. Dieses Verhalten entspricht jedoch gtag.js (UA), über das list_name nicht gesendet wird.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert.
Das Ereignis wird nur für GA4 empfohlen.
Nicht kompatibel*.

*Es ist unwahrscheinlich, dass dieses Ereignis von Ihrer UA-Implementierung gesendet wird, da es kein empfohlenes Ereignis ist. Damit GA4-Berichte vollständig sind, können Sie dieses Ereignis für UA im GA4-Format implementieren.

Wenn Sie das GA4-Ereignis für UA implementieren, wird es als Ereignis ohne items-Daten angezeigt. Das ist eventuell nicht sehr nützlich. Sie hat keine Auswirkungen auf UA-E-Commerce-Berichte.
Nicht kompatibel.

Ein Ereignistreffer wird mit general als event_category, view_cart als event_action und mit dem value-Parameter als event_value gesendet. items-Daten werden nicht gesendet.

Da dieses Ereignis in UA-E-Commerce-Berichten im Allgemeinen nicht unterstützt wird, hat es keine nennenswerte Auswirkung.
begin_checkout Nur GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet.* Nur GA4-Parameter werden nicht gesendet.

*item_list_name wird nicht gesendet. Dieses Verhalten entspricht jedoch gtag.js (UA), über das list_name nicht gesendet wird.

begin_checkout entspricht praktisch dem Senden eines checkout_progress-Ereignisses, bei dem checkout_step auf 1 gesetzt ist.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert.
add_payment_info Nur GA4:
currency
value
coupon
payment_type
items

UA:
Nicht zutreffend: Parameter werden nicht unterstützt.
Nicht kompatibel*.

*Da in UA keine Parameter für dieses Ereignis unterstützt werden, werden keine gesendet. Es wird funktionieren, ist aber wahrscheinlich nicht sehr nützlich.

GA4-Berichte, für die Ereignisparameter erforderlich sind, sind unvollständig.
Kompatibel.

Ein äquivalenter Ereignistreffer wird mit ecommerce als event_category, add_to_wishlist als event_action und dem Parameter value (umgewandelt in Ganzzahl) als event_value gesendet. Die Übersetzung von GA4 in UA enthält event_value. Dieser Wert wird jedoch normalerweise nicht für UA-Treffer festgelegt.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert. Da dieses Ereignis in UA-E-Commerce-Berichten im Allgemeinen nicht unterstützt wird, hat es keine nennenswerte Auswirkung.
Das Ereignis wird nur für GA4 empfohlen.
Nicht kompatibel*.

*Es ist unwahrscheinlich, dass dieses Ereignis von Ihrer UA-Implementierung gesendet wird, da es kein empfohlenes Ereignis ist. Damit GA4-Berichte vollständig sind, können Sie dieses Ereignis für UA im GA4-Format implementieren.

Wenn Sie das GA4-Ereignis für UA implementieren, wird es als Ereignis ohne items-Daten angezeigt. Das ist eventuell nicht sehr nützlich. Sie hat keine Auswirkungen auf UA-E-Commerce-Berichte.
Nicht kompatibel*.

Ein Ereignistreffer wird mit general als event_category, add_shipping_info als event_action und dem Parameter value (umgewandelt in Ganzzahl) als event_value gesendet. Der GA4-Parameter currency wird mit dem Treffer als Währung gesendet.

Da dieses Ereignis in UA-E-Commerce-Berichten im Allgemeinen nicht unterstützt wird, hat es keine nennenswerte Auswirkung.
checkout_progress
set_checkout_option
Ereignisse werden nur für UA empfohlen.
Das Ereignis wird als benutzerdefiniertes Ereignis behandelt. Es werden nur Parameter auf Ereignisebene und keine items-Daten gesendet.

Da diese Ereignisse in der Regel in E-Commerce-Berichten in GA4 nicht unterstützt werden, haben sie keine nennenswerte Auswirkung.
view_promotion Nur GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Nur UA:
promotions
Nicht kompatibel.

Ein benutzerdefiniertes view_promotion-Ereignis wird mit promotions als benutzerdefinierten Parameter gesendet. Der benutzerdefinierte Parameter promotions enthält keine nützlichen Daten.
Nicht kompatibel.

Ein UA-Ereignistreffer wird mit engagement als event_category und view_promotion als event_action gesendet. Es werden keine promotions-Daten gesendet. Das Ereignis wird als Ereignis ohne Interaktion markiert.
purchase Nur GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

currency wird auf Ereignisebene verwendet, da currency auf Artikelebene nicht unterstützt wird.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet.* Nur GA4-Parameter werden nicht gesendet.

*item_list_name wird nicht gesendet. Dieses Verhalten entspricht jedoch gtag.js (UA), über das list_name nicht gesendet wird.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert.
refund Nur GA4:
affiliation
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Kompatibel.

Alle UA-Parameter werden in GA4-Entsprechungen umgewandelt und gesendet.

currency wird auf Ereignisebene verwendet, da currency auf Artikelebene nicht unterstützt wird.

GA4-Berichte, für die Nur GA4-Parameter erforderlich sind, sind unvollständig.
Kompatibel.

GA4-Parameter mit einem entsprechenden UA-Parameter werden übersetzt und gesendet.* Nur GA4-Parameter werden nicht gesendet.

*item_list_name wird nicht gesendet. Dieses Verhalten entspricht jedoch gtag.js (UA), über das list_name nicht gesendet wird.

UA-Berichte, die mit Daten aus dem GA4-Ereignis gefüllt werden, sind vollständig bzw. unverändert.