Ereignisse

ad_impression

Verwenden Sie dieses Ereignis, wenn ein Nutzer eine Anzeigenimpression sieht.

  • ad_impression-Daten, die mit dem Measurement Protocol gesendet werden, werden nicht in Exporte in andere Werbeplattformen wie Google Ads aufgenommen.
  • Wenn Sie ad_impression-Ereignisse mit dem Measurement Protocol senden, können doppelte Impressionen auftreten, wenn Sie Tagging oder das SDK für die verknüpften Werbeprodukte von Google konfiguriert haben. Senden Sie ein ad_impression-Ereignis nur dann mit dem Measurement Protocol, wenn es nicht durch Tagging oder mit dem SDK erfasst wurde.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
ad_platform string Nein MoPub Die Werbeplattform.
ad_source string Nein AdColony Die Anzeigenquelle.
ad_format string Nein Banner Das Anzeigenformat.
ad_unit_name string Nein Banner_03 Der Name des Anzeigenblocks.
currency string Nein USD Währung der Artikel, die dem Ereignis zugeordnet sind, im ISO 4217-Format mit drei Buchstaben.

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Nein 3,99 EUR
Der Wert der Anzeigenimpression.
* value wird normalerweise für aussagekräftige Berichte benötigt.
* currency ist erforderlich, wenn Sie value festlegen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

add_payment_info

Dieses Ereignis bedeutet, dass ein Nutzer seine Zahlungsinformationen beim E-Commerce-Kaufvorgang eingereicht hat.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "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",
            "currency": "USD",
            "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_shipping_info

Dieses Ereignis bedeutet, dass ein Nutzer seine Versandinformationen beim E-Commerce-Kaufvorgang eingereicht hat.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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 Landverkehr 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_shipping_info",
      "params": {
        "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",
            "currency": "USD",
            "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 bedeutet, dass ein Artikel zum Kauf in den Einkaufswagen gelegt wurde.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 bedeutet, dass ein Artikel einer Wunschliste hinzugefügt wurde. Verwenden Sie dieses Ereignis, um beliebte Geschenkartikel in Ihrer App zu identifizieren.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 bedeutet, dass ein Nutzer mit dem Bezahlvorgang begonnen hat.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

campaign_details

Mit diesem Ereignis können Sie Kampagnendetails senden, die auf zukünftige Ereignisse angewendet werden.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
campaign_id string Nein google_1234 Die Kampagnen-ID.
campaign string Nein Summer_fun Der Name, mit dem eine bestimmte Werbeaktion oder strategische Kampagne identifiziert wird.
source string Nein google Die Besucherquelle der Kampagne (z. B. Google oder E-Mail)
medium string Nein cpc Das Kampagnenmedium (z. B. E-Mail oder Cost-per-Click)
term string Nein summer+travel Der in der bezahlten Suche verwendete Kampagnenbegriff zur Bereitstellung der Keywords für Anzeigen.
content string Nein logolink Der Kampagneninhalt, der für A/B-Tests und inhaltsbezogene Anzeigen verwendet wird, um Anzeigen oder Links zu unterscheiden, die auf dieselbe URL verweisen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

earn_virtual_currency

Bei diesem Ereignis wird erfasst, wann ein Nutzer in einem Spiel virtuelle Währung erhält. Tragen Sie dies zusammen mit spend_virtual_currency ein, um sich ein besseres Bild von Ihrer virtuellen Wirtschaft zu machen.

Parameter

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

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

generate_lead

Bei diesem Ereignis wird erfasst, wann ein Lead generiert wurde (z. B. über ein Formular). Erfassen Sie dies, um die Effektivität Ihrer Marketingkampagnen zu verstehen und zu erfahren, wie viele Kunden nach dem Remarketing noch einmal mit Ihrem Unternehmen in Kontakt treten.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 99.99
      }
    }]
  })
});

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.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

Dieses Ereignis bedeutet, dass ein Spieler das nächste Level in einem Spiel erreicht hat. Damit können Sie die Levelverteilung Ihrer Nutzer messen und Ebenen identifizieren, die schwer auszuführen sind.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
level number Nein 5 Das Level des Charakters.
character string Nein Spieler 1 Die Figur, die das nächste Level erreicht hat.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

einloggen

Dieses Ereignis senden, um anzugeben, dass sich ein Nutzer bei Ihrer Website oder App angemeldet hat.

Parameter

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

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

post_score

Dieses Ereignis senden, wenn der Nutzer eine Punktzahl postet. Mit diesem Ereignis kannst du nachvollziehen, wie Nutzer in deinem Spiel abschneiden, und Highscores mit Zielgruppen oder Verhalten in Beziehung setzen.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
score number Ja 10000 Die zu postende Punktzahl.
level number Nein 5 Das Level für die Punktzahl.
character string Nein Spieler 1 Der Charakter, der die Punktzahl erreicht hat.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

Kauf

Dieses Ereignis gibt an, wenn ein oder mehrere Artikel von einem Nutzer gekauft werden.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion markieren, sollten Sie value festlegen.
* currency ist erforderlich, wenn Sie value festlegen.
transaction_id string Ja T_12345 Die eindeutige Kennung einer Transaktion.

Mit dem Parameter transaction_id können Sie doppelte Ereignisse für einen Kauf vermeiden.
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 einer Transaktion.
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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

refund

Dieses Ereignis gibt an, wenn einem Nutzer ein oder mehrere Artikel erstattet werden.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
transaction_id string Ja T_12345 Die eindeutige Kennung einer Transaktion.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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 einer Transaktion.
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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "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",
            "currency": "USD",
            "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 bedeutet, dass ein Artikel aus dem Einkaufswagen entfernt wurde.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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
          }
        ]
      }
    }]
  })
});

screen_view

Verwenden Sie dieses Ereignis, um anzugeben, dass ein Bildschirmübergang stattgefunden hat.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
screen_class string Nein MainActivity Die Klasse des Bildschirms.
screen_name string Nein Info Der Name des Bildschirms.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

Protokolliert dieses Ereignis, um anzuzeigen, wann der Nutzer eine Suche durchgeführt hat. Mit diesem Ereignis lässt sich ermitteln, wonach Nutzer auf Ihrer Website oder in Ihrer App suchen. Es lässt sich 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.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Dieses Ereignis bedeutet, 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 identifizieren.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
content_type string Nein product Der Typ des ausgewählten Inhalts.
content_id string Nein C_12345 Eine Kennung für den ausgewählten Inhalt.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

select_item

Dieses Ereignis bedeutet, 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 die Einstellung auf Artikelebene festgelegt wurde.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

* Das Array items muss ein einzelnes Element haben, 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "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",
            "currency": "USD",
            "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 bedeutet, dass ein Angebot aus einer Liste ausgewählt wurde.

Parameter

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

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

Wird ignoriert, wenn die Einstellung auf Artikelebene festgelegt wurde.
promotion_id string Nein P_12345 Die ID des mit dem Ereignis verknüpften Angebots.

Wird ignoriert, wenn die Einstellung auf Artikelebene festgelegt wurde.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Ereignis verknüpft ist.

Wird ignoriert, wenn die Einstellung auf Artikelebene festgelegt wurde.
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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "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",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "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,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

teilen

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

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
method string Nein X (ehemals Twitter) Die Methode, mit der der Inhalt geteilt wird.
content_type string Nein Image Der Typ des geteilten Inhalts.
item_id string Nein C_12345 Die ID des geteilten Inhalts.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Dieses Ereignis zeigt an, dass sich ein Nutzer für ein Konto registriert hat. Mithilfe dieses Ereignisses können Sie sich einen Überblick über das unterschiedliche Verhalten von angemeldeten und nicht angemeldeten Nutzern verschaffen.

Parameter

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

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

Mit diesem Ereignis wird der Verkauf virtueller Waren in Ihrer App erfasst. So können Sie ermitteln, welche virtuellen Waren am beliebtesten sind.

Parameter

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

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

Dieses Ereignis stellt den Beginn des Onboarding-Prozesses dar. Verwenden Sie dies in einem Trichter mit tutorial_complete, um zu sehen, wie viele Nutzer die Anleitung abgeschlossen haben.

Parameter

Für dieses Ereignis werden keine Parameter vorgeschlagen.

Für dieses Ereignis gibt es keine Parameter.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

Dieses Ereignis bedeutet, dass der Nutzer den Onboardingprozess abgeschlossen hat. Verwenden Sie diesen Wert in einem Trichter mit tutorial_begin, um zu ermitteln, wie viele Nutzer die Anleitung abgeschlossen haben.

Parameter

Für dieses Ereignis werden keine Parameter vorgeschlagen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_complete"
    }]
  })
});

unlock_achievement

Dieses Ereignis wird protokolliert, wenn der Nutzer einen Erfolg freigeschaltet hat. Mit diesem Ereignis kannst du besser nachvollziehen, wie Nutzer dein Spiel erleben.

Parameter

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

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

view_cart

Dieses Ereignis bedeutet, dass ein Nutzer den Einkaufswagen aufgerufen hat.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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 bedeutet, dass dem Nutzer einige Inhalte angezeigt wurden. Mithilfe dieses Ereignisses können Sie die beliebtesten Artikel ermitteln.

Parameter

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

* Wenn du value festlegst, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
value number Ja* 30,03 Geldwert des Ereignisses.

* Setze value für alle Elemente in items auf die Summe von (price * quantity). Lassen Sie shipping oder tax weg.
* value wird normalerweise für aussagekräftige Berichte benötigt. Wenn Sie das Ereignis als Conversion 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "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

Dieses Ereignis wird protokolliert, wenn dem Nutzer eine Liste von Elementen einer bestimmten Kategorie angezeigt wird.

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 die Einstellung auf Artikelebene festgelegt wurde.
item_list_name string Nein Ähnliche Produkte Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde

Wird ignoriert, wenn die Einstellung auf Artikelebene festgelegt wurde.
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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "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",
            "currency": "USD",
            "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_promotion

Dieses Ereignis bedeutet, dass eine Werbung in einer Liste angesehen wurde.

Parameter

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

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

Wird ignoriert, wenn die Einstellung auf Artikelebene festgelegt wurde.
promotion_id string Nein P_12345 Die ID des mit dem Ereignis verknüpften Angebots.

Wird ignoriert, wenn die Einstellung auf Artikelebene festgelegt wurde.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Ereignis verknüpft ist.

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

* Das Array items muss ein einzelnes Element enthalten, das den mit dem Angebot verknüpften Artikel 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.

*item_id oder item_name ist erforderlich.

item_name string Ja* Stan und seine Freunde

Der Name des Artikels.

*item_id oder item_name ist erforderlich.

affiliation string Nein Google Store Eine Produktzugehörigkeit zur Bestimmung eines Lieferunternehmens oder eines physischen Geschäfts.
Hinweis: „Zugehörigkeit“ ist nur auf Artikelebene 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 Werbe-Creatives.

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

Falls festgelegt, wird creative_slot auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird creative_slot auf Ereignisebene verwendet, sofern vorhanden.
discount number Nein 2,22 Der Wert des Geldbetrags für den Rabatt, der dem Artikel zugewiesen ist.
index number Nein 5 Index/Position des Elements in einer Liste.
item_brand string Nein Google Die Marke des Artikels.
item_category string Nein Bekleidung Die Kategorie des Artikels Wenn sie im Rahmen einer Kategoriehierarchie oder Taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2 string Nein Adult Die zweite Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4 string Nein Mitwirkende Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
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

Falls festgelegt, wird item_list_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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

Falls festgelegt, wird item_list_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant string Nein green Die Artikelvariante, 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 Standort, der dem Artikel zugeordnet ist, z. B. das Geschäft Es empfiehlt sich, die Google Place ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: „location id“ ist nur auf Artikelebene verfügbar.
price number Nein 10,01 Der Geldeinheitspreis des Artikels in Einheiten des angegebenen Währungsparameters.
Wenn für den Artikel ein Rabatt gilt, setzen Sie price auf den rabattierten Preis pro Einheit und geben Sie den Rabatt pro Einheit im Parameter discount an.
promotion_id string Nein P_12345 Die ID des mit dem Artikel verknüpften Angebots

Falls festgelegt, wird promotion_id auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird promotion_id auf Ereignisebene verwendet, sofern vorhanden.
promotion_name string Nein Sommerschlussverkauf Der Name der Werbeaktion, die mit dem Artikel verknüpft ist.

Falls festgelegt, wird promotion_name auf Ereignisebene ignoriert.
Wenn die Richtlinie nicht konfiguriert ist, wird 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 bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "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",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "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,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

Dieses Ereignis wird protokolliert, wenn dem Nutzer die Ergebnisse einer Suche angezeigt werden. Hinweis: Sie können das Ereignis „view_search_results“ für die automatische Erhebung in Google Analytics über die optimierte Ereignisanalyse aktivieren.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
search_term string Nein Bekleidung Der für die Suche verwendete Begriff.

Ereignis senden

Dieses Ereignis in GA4 Event Builder ausprobieren

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});