Empfohlene Ereignisse

In Google Analytics werden einige Ereignistypen automatisch gesendet. Auf dieser Seite werden optionale zusätzliche Ereignisse beschrieben, die Sie konfigurieren können, um mehr Verhaltensweisen zu erfassen und nützlichere Berichte für Ihr Unternehmen zu erstellen. Die Konfiguration dieser zusätzlichen Ereignisse ist aufwendiger, daher können sie nicht automatisch von Google Analytics 4 gesendet werden. Eine detaillierte Anleitung zum Konfigurieren empfohlener und benutzerdefinierter Ereignisse für Ihre Website oder App finden Sie unter Ereignisse einrichten.

Wenn Sie sich Details zu den einzelnen Ereignissen ansehen möchten, die Sie verwenden können, wählen Sie Ihre Tag-Management-Plattform aus:

add_payment_info

Dieses Ereignis wird ausgelöst, wenn ein Nutzer seine Zahlungsinformationen im Rahmen eines E-Commerce-Bezahlvorgangs eingereicht hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Ereignis zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
payment_type string Nein Kreditkarte Die ausgewählte Zahlungsmethode.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: add_payment_info
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
    • E-Commerce-Gutschein – ecommerce.coupon
    • E-Commerce-Zahlungstyp – ecommerce.payment_type
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon – &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
    • payment_type – &lbrace;&lbrace;Ecommerce Payment Type&rbrace;&rbrace;
  • Trigger: event = add_payment_info

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: add_payment_info
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Wenn Sie das „items“-Array außerhalb des „ecommerce“-Arrays festlegen müssen, legen Sie den Parameter currency auf Ereignisebene fest, wenn Sie value-Daten (Umsatz) senden.

add_shipping_info

Dieses Ereignis wird ausgelöst, wenn ein Nutzer seine Versandinformationen im Rahmen eines E-Commerce-Bezahlvorgangs sendet.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Ereignis zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
shipping_tier string Nein Boden Die Versandmethode (z.B. Ground, Air, Next-day), die für die Lieferung des gekauften Artikels ausgewählt wird.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: add_shipping_info
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
    • E-Commerce-Gutschein – ecommerce.coupon
    • E-Commerce-Versandstufe – ecommerce.shipping_tier
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon – &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
    • shipping_tier – &lbrace;&lbrace;Ecommerce Shipping Tier&rbrace;&rbrace;
  • Trigger: Ereignis entspricht „add_shipping_info“

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: add_shipping_info
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_cart

Dieses Ereignis gibt an, dass ein Artikel zum Kauf in den Einkaufswagen gelegt wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: add_to_cart
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Trigger: event equals add_to_cart

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: add_to_cart
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

Das Ereignis gibt an, dass ein Artikel einer Wunschliste hinzugefügt wurde. Mit diesem Ereignis können Sie beliebte Geschenkartikel in Ihrer App ermitteln.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: add_to_wishlist
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Trigger: event = add_to_wishlist

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: add_to_wishlist
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

begin_checkout

Dieses Ereignis gibt an, dass ein Nutzer mit dem Bezahlvorgang begonnen hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Ereignis zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: begin_checkout
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
    • E-Commerce-Gutschein – ecommerce.coupon
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon – &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Trigger: event = begin_checkout

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: begin_checkout
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

close_convert_lead

Bei diesem Ereignis wird erfasst, wann ein Lead in eine Conversion umgewandelt und geschlossen wurde (z. B. durch einen Kauf).

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des value des Ereignisses im ISO 4217-Format mit drei Buchstaben.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: close_convert_lead
  • Ereignisparameter (Parametername – Wert):
    • currency – USD
    • value – 30.03
  • Ereignis auslösen, wenn der Nutzer zu einem Lead mit Conversion (einem Kunden) wird

close_unconvert_lead

Bei diesem Ereignis wird erfasst, wann ein Nutzer als nicht zu einem Lead mit Conversion werdend markiert wird, sowie der Grund dafür.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des value des Ereignisses im ISO 4217-Format mit drei Buchstaben.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
unconvert_lead_reason string Nein Nie geantwortet Der Grund, warum es nicht zu einer Lead-Conversion gekommen ist.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: close_unconvert_lead
  • Ereignisparameter (Parametername – Wert):
    • currency – USD
    • value – 30.03
  • Das Ereignis wird ausgelöst, wenn ein Nutzer aus einem von mehreren Gründen nicht als konvertierter Lead gekennzeichnet wird.

disqualify_lead

Bei diesem Ereignis wird erfasst, wann ein Nutzer als Lead disqualifiziert wird, sowie der Grund für die Disqualifizierung.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des value des Ereignisses im ISO 4217-Format mit drei Buchstaben.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
disqualified_lead_reason string Nein Ich möchte nichts kaufen Der Grund, warum ein Lead als ausgeschlossen markiert wurde

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: disqualify_lead
  • Ereignisparameter (Parametername – Wert):
    • currency – USD
    • value – 30.03
    • disqualified_lead_reason – Ich möchte nichts kaufen
  • Das Ereignis wird ausgelöst, wenn ein Nutzer aus einem von mehreren Gründen nicht als Lead gekennzeichnet wird.

earn_virtual_currency

Bei diesem Ereignis wird erfasst, wann ein Nutzer in einem Spiel virtuelle Währung erhält. Protokollieren Sie dieses Ereignis zusammen mit spend_virtual_currency, um Ihre virtuelle Wirtschaft besser zu verstehen.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
virtual_currency_name string Nein Edelsteine Der Name der virtuellen Währung.
value number Nein 5 Der Wert der virtuellen Währung.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: earn_virtual_currency
  • Ereignisparameter (Parametername – Wert):
    • virtual_currency_name – Gems
    • value – 5
  • Ereignis auslösen, wenn ein Nutzer eine virtuelle Währung erhält

generate_lead

Bei diesem Ereignis wird erfasst, wann ein Lead generiert wurde, z. B. über ein Formular. So können Sie die Effektivität Ihrer Marketingkampagnen nachvollziehen und sehen, wie viele Kunden nach dem Remarketing wieder mit Ihrem Unternehmen interagieren.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des value des Ereignisses im ISO 4217-Format mit drei Buchstaben.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
lead_source string Nein Messe Die Quelle des Leads.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: generate_lead
  • Ereignisparameter (Parametername – Wert):
    • currency – USD
    • value – 30.03
    • lead_source – Messe
  • Ereignis auslösen, wenn ein Lead generiert wurde

join_group

Dieses Ereignis protokollieren, wenn ein Nutzer einer Gruppe beitritt, z. B. einer Gilde, einem Team oder einer Familie. Mit diesem Ereignis können Sie analysieren, wie beliebt bestimmte Gruppen oder soziale Funktionen sind.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
group_id string Nein G_12345 Die ID der Gruppe.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: join_group
  • Ereignisparameter (Parametername – Wert):
    • group_id – G_12345
  • Ereignis auslösen, wenn ein Nutzer einer Gruppe beitritt

level_end

Dieses Ereignis gibt an, dass ein Spieler das Ende eines Levels in einem Spiel erreicht hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
level_name string Nein Die Reise beginnt… Der Name der Stufe.
success boolean Nein wahr Auf true festgelegt, wenn das Level erfolgreich abgeschlossen wurde.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: level_end
  • Ereignisparameter (Parametername – Wert):
    • level_name – Die Reise beginnt…
    • success – true
  • Wird ausgelöst, wenn ein Spieler das Ende eines Levels erreicht hat (z.B. die Bestätigungsseite für das Level)

level_start

Dieses Ereignis gibt an, dass ein Spieler ein Level in einem Spiel begonnen hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
level_name string Nein Die Reise beginnt… Der Name der Stufe.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: level_start
  • Ereignisparameter (Parametername – Wert):
    • level_name – Die Reise beginnt…
  • Wird ausgelöst, wenn ein Nutzer ein neues Level beginnt (z.B. die Startseite des Levels)

level_up

Dieses Ereignis gibt an, dass ein Spieler in einem Spiel das nächste Level erreicht hat. Mit diesem Messwert können Sie die Verteilung der Level Ihrer Nutzerbasis einschätzen und Level identifizieren, die schwer zu absolvieren sind.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
level number Nein 5 Die Stufe des Charakters.
character string Nein Spieler 1 Der Charakter, der eine Stufe aufgestiegen ist.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: level_up
  • Ereignisparameter (Parametername – Wert):
    • level – 5
    • character – Spieler 1
  • Auslösen, wenn ein Spieler das nächste Level erreicht hat

login

Senden Sie dieses Ereignis, um anzugeben, dass sich ein Nutzer auf Ihrer Website oder in Ihrer App angemeldet hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
method string Nein Google Die Methode, die für die Anmeldung verwendet wurde.

Beispiel

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: login
  • Ereignisparameter (Parametername – Wert):
    • method ‒ Google
  • Auslösen, wenn sich ein Nutzer angemeldet hat

post_score

Senden Sie dieses Ereignis, wenn der Nutzer ein Ergebnis postet. Mit diesem Ereignis können Sie nachvollziehen, wie Nutzer in Ihrem Spiel abschneiden, und Highscores mit Zielgruppen oder Verhaltensweisen in Beziehung setzen.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
score number Ja 10000 Die zu postende Punktzahl.
level number Nein 5 Die Stufe für den Score.
character string Nein Spieler 1 Die Figur, die die Punktzahl erreicht hat.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: post_score
  • Ereignisparameter (Parametername – Wert):
    • score – 10.000
    • level – 5
    • character – Spieler 1
  • Auslösen, wenn der Nutzer eine Punktzahl postet

purchase

Dieses Ereignis wird ausgelöst, wenn ein Nutzer mindestens einen Artikel kauft.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
customer_type string (new / returning) Nein neuen Stammt die Conversion von einem neuen oder wiederkehrenden Kunden?
  • new: Neukunde – hat im angegebenen Zeitraum nichts gekauft (Zeitfenster von 540 Tagen empfohlen und als Standard festgelegt, aber nicht vorgeschrieben)
  • returning: Ein wiederkehrender Kunde, der im angegebenen Zeitraum etwas gekauft hat.

Geben Sie keinen Wert an, wenn die Klassifizierung nicht sicher ist, z. B. wenn der Nutzer als Gast bezahlt hat.
transaction_id string Ja T_12345 Die eindeutige ID einer Transaktion.

Mit dem Parameter transaction_id lässt sich vermeiden, dass doppelte Ereignisse für einen Kauf erfasst werden.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Ereignis zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
shipping number Nein 3,33 Die Versandkosten, die einer Transaktion zugewiesen sind.
tax number Nein 1.11 Die Steuern für eine Transaktion.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: purchase
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Transaktions-ID: ecommerce.transaction_id
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Steuer – ecommerce.tax
    • E-Commerce-Versand – ecommerce.shipping
    • E-Commerce-Währung – ecommerce.currency
    • E-Commerce-Gutschein – ecommerce.coupon
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • transaction_id – &lbrace;&lbrace;Ecommerce Transaction ID&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax – &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping – &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon – &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Trigger: Ereignis entspricht „Kauf“

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: purchase
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    customer_type: "new",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

qualify_lead

Bei diesem Ereignis wird erfasst, wann ein Nutzer als den Kriterien für einen qualifizierten Lead entsprechend gekennzeichnet wird.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des value des Ereignisses im ISO 4217-Format mit drei Buchstaben.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: qualify_lead
  • Ereignisparameter (Parametername – Wert):
    • currency – USD
    • value – 30.03
  • Ereignis auslösen, wenn ein Nutzer als den Kriterien für einen qualifizierten Lead entsprechend gekennzeichnet wird

refund

Dieses Ereignis wird ausgelöst, wenn einem Nutzer ein oder mehrere Artikel erstattet werden.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
transaction_id string Ja T_12345 Die eindeutige ID einer Transaktion.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Ereignis zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
shipping number Nein 3,33 Die Versandkosten, die einer Transaktion zugewiesen sind.
tax number Nein 1.11 Die Steuern für eine Transaktion.
items Array<Item> Nein* Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: refund
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Transaktions-ID: ecommerce.transaction_id
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Steuer – ecommerce.tax
    • E-Commerce-Versand – ecommerce.shipping
    • E-Commerce-Währung – ecommerce.currency
    • E-Commerce-Gutschein – ecommerce.coupon
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • transaction_id – &lbrace;&lbrace;Ecommerce Transaction ID&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • tax – &lbrace;&lbrace;Ecommerce Tax&rbrace;&rbrace;
    • shipping – &lbrace;&lbrace;Ecommerce Shipping&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
    • coupon – &lbrace;&lbrace;Ecommerce Coupon&rbrace;&rbrace;
  • Trigger: event = refund

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: refund
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

remove_from_cart

Dieses Ereignis gibt an, dass ein Artikel aus einem Einkaufswagen entfernt wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: remove_from_cart
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Trigger: event = remove_from_cart

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: remove_from_cart
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

Protokollieren Sie dieses Ereignis, um anzugeben, wann der Nutzer eine Suche durchgeführt hat. Mit diesem Ereignis können Sie ermitteln, wonach Nutzer auf Ihrer Website oder in Ihrer App suchen. Sie können es beispielsweise senden, wenn ein Nutzer nach einer Suche eine Suchergebnisseite aufruft.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
search_term string Ja T-Shirts Der Begriff, nach dem gesucht wurde.

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: search
  • Ereignisparameter (Parametername – Wert):
    • search_term – T-Shirts
  • Auslösen, wenn ein Nutzer auf Ihrer Website sucht

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: search
  • Ereignisparameter (Parametername – Wert):
    • search_term – T-Shirts
  • Auslösen, wenn ein Nutzer auf Ihrer Website sucht

select_content

Dieses Ereignis gibt an, dass ein Nutzer Inhalte eines bestimmten Typs ausgewählt hat. Mit diesem Ereignis können Sie beliebte Inhalte und Inhaltskategorien auf Ihrer Website oder in Ihrer App ermitteln.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
content_type string Nein Produkt Der Typ der ausgewählten Inhalte.
content_id string Nein C_12345 Eine Kennung für den ausgewählten Inhalt.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: select_content
  • Ereignisparameter (Parametername – Wert):
    • content_type – Produkt
    • content_id – C_12345
  • Trigger: event equals select_content

select_item

Dieses Ereignis gibt an, dass ein Element aus einer Liste ausgewählt wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
items Array<Item> Ja* Die Artikel für das Ereignis.

* Das items-Array sollte ein einzelnes Element enthalten, das das ausgewählte Element darstellt. Wenn mehrere Elemente angegeben sind, wird nur das erste Element in items verwendet.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: select_item
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Artikellisten-ID: ecommerce.item_list_id
    • Name der E-Commerce-Artikelliste: ecommerce.item_list_name
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • item_list_id – &lbrace;&lbrace;Ecommerce Item List ID&rbrace;&rbrace;
    • item_list_name – &lbrace;&lbrace;Ecommerce Item List Name&rbrace;&rbrace;
  • Trigger: event = select_item

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: select_item
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

select_promotion

Dieses Ereignis gibt an, dass ein Angebot aus einer Liste ausgewählt wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
creative_name string Nein summer_banner2 Der Name des Angebots-Creatives.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
creative_slot string Nein featured_app_1 Der Name der Creative-Fläche, die mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
promotion_id string Nein P_12345 Die ID der Werbeaktion, die mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
promotion_name string Nein Sommer-Sale Der Name des Angebots, das mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
items Array<Item> Nein Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
creative_name string Nein summer_banner2 Der Name des Angebots-Creatives.

Wenn festgelegt, wird creative_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die creative_name auf Ereignisebene verwendet, sofern vorhanden.
creative_slot string Nein featured_app_1 Der Name der Creative-Fläche, die mit dem Artikel verknüpft ist.

Wenn festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
promotion_id string Nein P_12345 Die ID des Angebots, das mit dem Artikel verknüpft ist.

Wenn festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommer-Sale Der Name des Werbeangebots, das mit dem Artikel verknüpft ist.

Wenn festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die promotion_name auf Ereignisebene verwendet, sofern vorhanden.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • Name des E-Commerce-Creatives: ecommerce.creative_name
    • E-Commerce-Creative-Slot – ecommerce.creative_slot
    • E-Commerce-Angebots-ID: ecommerce.promotion_id
    • Name der E-Commerce-Promotion: ecommerce.promotion_name
    • E-Commerce-Artikel – ecommerce.items
  • Ereignisparameter (Parametername – Wert):
    • creative_name – &lbrace;&lbrace;Ecommerce Creative Name&rbrace;&rbrace;
    • creative_slot – &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id – &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name – &lbrace;&lbrace;Ecommerce Promotion Name&rbrace;&rbrace;
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
  • Variablentyp: Datenschichtvariable – „ecommerce.items“
  • Trigger: event = select_promotion

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: select_promotion
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

share

Verwenden Sie dieses Ereignis, wenn ein Nutzer Inhalte geteilt hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
method string Nein Twitter Die Methode, mit der die Inhalte geteilt werden.
content_type string Nein Image Der Typ der freigegebenen Inhalte.
item_id string Nein C_12345 Die ID der freigegebenen Inhalte.

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: share
  • Ereignisparameter (Parametername – Wert):
    • method – Twitter
    • content_type – Bild
    • item_id – C_12345
  • Auslösen, wenn ein Nutzer Inhalte geteilt hat

Beispiel

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: share
  • Ereignisparameter (Parametername – Wert):
    • method – Twitter
    • content_type – Bild
    • item_id – C_12345
  • Auslösen, wenn ein Nutzer Inhalte geteilt hat

sign_up

Dieses Ereignis gibt an, dass sich ein Nutzer für ein Konto registriert hat. Mithilfe dieses Ereignisses können Sie das Verhalten angemeldeter und nicht angemeldeter Nutzer nachvollziehen.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
method string Nein Google Die für die Registrierung verwendete Methode.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: sign_up
  • Ereignisparameter (Parametername – Wert):
    • method ‒ Google
  • Wird ausgelöst, wenn sich ein Nutzer für ein Konto registriert hat

spend_virtual_currency

Mit diesem Ereignis wird der Verkauf virtueller Güter in Ihrer App gemessen. So können Sie herausfinden, welche virtuellen Güter am beliebtesten sind.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
value number Ja 5 Der Wert der virtuellen Währung.
virtual_currency_name string Ja Edelsteine Der Name der virtuellen Währung.
item_name string Nein Starter-Boost Der Name des Artikels, für den die virtuelle Währung verwendet wird.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: spend_virtual_currency
  • Ereignisparameter (Parametername – Wert):
    • value – 5
    • virtual_currency_name – Gems
    • item_name – Starthilfe
  • Auslösen, wenn jemand einen virtuellen Artikel kauft

tutorial_begin

Dieses Ereignis kennzeichnet den Beginn des Onboarding-Prozesses. Verwenden Sie diesen Parameter in einem Trichter mit tutorial_complete, um zu sehen, wie viele Nutzer das Tutorial abschließen.

Parameter

Für dieses Ereignis sind keine Parameter vorhanden.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: tutorial_begin
  • Auslösen, wenn jemand mit dem Onboardingprozess beginnt

tutorial_complete

Dieses Ereignis gibt an, dass der Nutzer den Onboarding-Prozess abgeschlossen hat. Verwenden Sie dieses Ereignis in einem Trichter mit tutorial_begin, um zu sehen, wie viele Nutzer das Tutorial abschließen.

Parameter

Für dieses Ereignis werden keine Parameter vorgeschlagen.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: tutorial_complete
  • Auslösen, wenn jemand den Onboardingprozess abschließt

unlock_achievement

Protokollieren Sie dieses Ereignis, wenn der Nutzer einen Erfolg freigeschaltet hat. Mit diesem Ereignis können Sie nachvollziehen, wie Nutzer Ihr Spiel erleben.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
achievement_id string Ja A_12345 Die ID des freigeschalteten Erfolgs.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: unlock_achievement
  • Ereignisparameter (Parametername – Wert):
    • achievement_id – A_12345
  • Auslösen, wenn ein Nutzer einen Erfolg freigeschaltet hat

view_cart

Dieses Ereignis gibt an, dass ein Nutzer sich seinen Einkaufswagen angesehen hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: view_cart
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Trigger: event = view_cart

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: view_cart
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item

Dieses Ereignis gibt an, dass dem Nutzer Inhalte präsentiert wurden. Mit diesem Ereignis können Sie die am häufigsten aufgerufenen Artikel ermitteln.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* Legen Sie value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an.
* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: view_item
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Wert – ecommerce.value
    • E-Commerce-Währung – ecommerce.currency
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • value – &lbrace;&lbrace;Ecommerce Value&rbrace;&rbrace;
    • currency – &lbrace;&lbrace;Ecommerce Currency&rbrace;&rbrace;
  • Trigger: event = view_item

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: view_item
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item_list

Protokollieren Sie dieses Ereignis, wenn dem Nutzer eine Liste von Artikeln einer bestimmten Kategorie präsentiert wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben.

Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
items Array<Item> Ja Die Artikel für das Ereignis.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: view_item_list
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • E-Commerce-Artikel – ecommerce.items
    • E-Commerce-Artikellisten-ID: ecommerce.item_list_id
    • Name der E-Commerce-Artikelliste: ecommerce.item_list_name
  • Ereignisparameter (Parametername – Wert):
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
    • item_list_id – &lbrace;&lbrace;Ecommerce Item List ID&rbrace;&rbrace;
    • item_list_name – &lbrace;&lbrace;Ecommerce Item List Name&rbrace;&rbrace;
  • Trigger: event equals view_item_list

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: view_item_list
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

view_promotion

Dieses Ereignis gibt an, dass ein Angebot in einer Liste aufgerufen wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
creative_name string Nein summer_banner2 Der Name des Angebots-Creatives.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
creative_slot string Nein featured_app_1 Der Name der Creative-Fläche, die mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
promotion_id string Nein P_12345 Die ID der Werbeaktion, die mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
promotion_name string Nein Sommer-Sale Der Name des Angebots, das mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
items Array<Item> Ja* Die Artikel für das Ereignis.

* Das items-Array sollte ein einzelnes Element enthalten, das das mit dem Angebot verknüpfte Element darstellt. Wenn mehrere Elemente angegeben sind, wird nur das erste Element in items verwendet.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja* SKU_12345

Die ID des Artikels.

*Entweder item_id oder item_name ist erforderlich.

item_name string Ja* „Stan and Friends“-T-Shirt

Der Name des Artikels.

*Entweder item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts
Hinweis: „affiliation“ ist nur auf der Ebene des Elements verfügbar.
coupon string Nein SUMMER_FUN Der Name/Code des Gutscheins, der dem Artikel zugewiesen ist.

coupon-Parameter auf Ereignis- und Artikelebene sind voneinander unabhängig.
creative_name string Nein summer_banner2 Der Name des Angebots-Creatives.

Wenn festgelegt, wird creative_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die creative_name auf Ereignisebene verwendet, sofern vorhanden.
creative_slot string Nein featured_app_1 Der Name der Creative-Fläche, die mit dem Artikel verknüpft ist.

Wenn festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2.22 Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index number Nein 5 Der Index bzw. die Position des Artikels in einer Liste.
item_brand string Nein Google Die Marke des Artikels
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein Grün Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Place-ID für San Francisco) Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Place-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden.
Hinweis: `location id` ist nur auf Artikelebene verfügbar.
price number Nein 10.01 Der Preis des Artikels in der angegebenen Währung.
Wenn ein Rabatt auf den Artikel angewendet wird, legen Sie price auf den reduzierten Stückpreis fest und geben Sie den Stückpreisrabatt im Parameter discount an.
promotion_id string Nein P_12345 Die ID des Angebots, das mit dem Artikel verknüpft ist.

Wenn festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommer-Sale Der Name des Werbeangebots, das mit dem Artikel verknüpft ist.

Wenn festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die promotion_name auf Ereignisebene verwendet, sofern vorhanden.
quantity number Nein 3

Artikelmenge.

Wenn nicht festgelegt, wird quantity auf 1 gesetzt.
Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: view_promotion
  • Datenschichtvariablen (Name – Name der Datenschichtvariablen):
    • Name des E-Commerce-Creatives: ecommerce.creative_name
    • E-Commerce-Creative-Slot – ecommerce.creative_slot
    • E-Commerce-Angebots-ID: ecommerce.promotion_id
    • Name der E-Commerce-Promotion: ecommerce.promotion_name
    • E-Commerce-Artikel – ecommerce.items
  • Ereignisparameter (Parametername – Wert):
    • creative_name – &lbrace;&lbrace;Ecommerce Creative Name&rbrace;&rbrace;
    • creative_slot – &lbrace;&lbrace;Ecommerce Creative Slot&rbrace;&rbrace;
    • promotion_id – &lbrace;&lbrace;Ecommerce Promotion ID&rbrace;&rbrace;
    • promotion_name – &lbrace;&lbrace;Ecommerce Promotion Name&rbrace;&rbrace;
    • items – &lbrace;&lbrace;Ecommerce Items&rbrace;&rbrace;
  • Trigger: event = view_promotion

Triggerkonfiguration:

  • Triggertyp: Benutzerdefiniertes Ereignis
  • Name der Veranstaltung: view_promotion
  • Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
 
dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

working_lead

Bei diesem Ereignis wird erfasst, wann ein Nutzer einen Kundenservicemitarbeiter kontaktiert oder von einem Kundenservicemitarbeiter kontaktiert wird.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des value des Ereignisses im ISO 4217-Format mit drei Buchstaben.

* Wenn Sie value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30.03 Der Geldwert des Ereignisses.

* value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
lead_status string Nein Gestartete Unterhaltungen Der Status des Leads.

Beispiel

Das folgende Beispiel bezieht sich auf Tag Manager-Implementierungen:

Zeige mir die Tag-Konfiguration

Tag-Konfiguration:

  • Tag-Typ: GA4-Ereignis
  • Name der Veranstaltung: working_lead
  • Ereignisparameter (Parametername – Wert):
    • currency – USD
    • value – 30.03
    • lead_status – Begonnene Unterhaltungen
  • Lösen Sie das Ereignis aus, wenn ein Nutzer einen Kundenservicemitarbeiter kontaktiert oder von einem Kundenservicemitarbeiter kontaktiert wird.