Empfohlene Google Analytics-Ereignisse

Im Folgenden finden Sie eine Liste der empfohlenen Ereignisse. Sie können auch eigene benutzerdefinierte Ereignisse erstellen und senden.

Wichtig :Verwenden Sie app_instance_id anstelle von client_id für Ereignisse, die an App-Datenstreams gesendet werden.

Beim Erstellen benutzerdefinierter Ereignisnamen müssen Sie Folgendes beachten:

1. Halten Sie sich an die Regeln für Ereignisnamen.
2. Vermeiden Sie reservierte Namen und Präfixe.
3. Halten Sie die Grenzwerte für die Ereigniserfassung ein, z. B. die Beschränkung auf 40 Zeichen für Ereignis- und Parameternamen.

Weitere Informationen

Wenn Sie ein Upgrade vom Measurement Protocol durchführen, finden Sie eine Anleitung unter Upgrade vom Measurement Protocol.

Für alle Properties

ad_impression

Dieses Ereignis ist nur für App-Streams verfügbar.

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

• Ein ad_impression, das über das Measurement Protocol gesendet wird, wird nicht in Exporte zu anderen Werbeplattformen wie Google Ads aufgenommen.
• Wenn Sie ad_impression-Ereignisse über das Measurement Protocol senden, kann es zu doppelten Impressionen kommen, wenn Sie das Tagging oder das SDK für Ihre verknüpften Google-Werbeprodukte konfiguriert haben. Senden Sie ein ad_impression-Ereignis nur dann über das Measurement Protocol, wenn es nicht durch Tagging oder das SDK erfasst wurde.

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Nein	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Nein	3,99 EUR	Der Wert der Anzeigenimpression. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. * currency ist erforderlich, wenn Sie conversion_value festlegen.

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.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein ad_impression-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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({
    "app_instance_id": "app_instance_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
      }
    }]
  })
});

earn_virtual_currency

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
conversion_value	number	Nein	5	Der Wert der virtuellen Währung.

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein earn_virtual_currency-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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
      }
    }]
  })
});

join_group

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

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein join_group-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

login

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

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein login-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

screen_view

Dieses Ereignis ist nur für App-Streams verfügbar.

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.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein screen_view-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

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

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein search-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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 gibt an, dass ein Nutzer Inhalte eines bestimmten Typs ausgewählt hat. Mit diesem Ereignis können Sie beliebte Inhalte und Inhaltskategorien auf Ihrer Website oder in Ihrer App ermitteln.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
content_type	string	Nein	Produkt	Der Typ der ausgewählten Inhalte.
content_id	string	Nein	C_12345	Eine Kennung für den ausgewählten Inhalt. Der Wert muss mindestens ein nicht numerisches Zeichen enthalten.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein select_content-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

share

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
cart_data.items	Item[]	Nein		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein share-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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 gibt an, dass sich ein Nutzer für ein Konto registriert hat. Mithilfe dieses Ereignisses können Sie das Verhalten angemeldeter und nicht angemeldeter Nutzer nachvollziehen.

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein sign_up-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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 Güter in Ihrer App gemessen. So können Sie herausfinden, welche virtuellen Güter am beliebtesten sind.

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
conversion_value	number	Ja	5	Der Wert der virtuellen Währung.
cart_data.items	Item[]	Nein		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Nein	Starter-Boost	Der Name des Artikels, für den die virtuelle Währung verwendet wird.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
virtual_currency_name	string	Ja	Edelsteine	Der Name der virtuellen Währung.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein spend_virtual_currency-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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 kennzeichnet den Beginn des Onboarding-Prozesses. Verwenden Sie diesen Parameter in einem Trichter mit tutorial_complete, um zu sehen, wie viele Nutzer das Tutorial abschließen.

Parameter

Für dieses Ereignis werden keine Parameter vorgeschlagen.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein tutorial_begin-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

Parameter

Für dieses Ereignis werden keine Parameter vorgeschlagen.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein tutorial_complete-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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"
    }]
  })
});

view_search_results

Protokollieren Sie dieses Ereignis, wenn dem Nutzer die Ergebnisse einer Suche präsentiert wurden. Das Ereignis „view_search_results“ kann in Google Analytics über Optimierte Ereignisanalyse automatisch erfasst werden.

Parameter

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

Hinweis :Beim Ereignis view_search_results wird der Parameter unique_search_term mit dem Wert „1“ gesendet, wenn der Suchbegriff in der aktuellen Sitzung noch nicht verwendet wurde. Wurde der Suchbegriff in der aktuellen Sitzung bereits gesendet, wird für den Parameterwert der Wert „0“ erfasst.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein view_search_results-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

campaign_details

Mit diesem Ereignis können Sie Kampagnendetails senden, die auf Ereignisse mit einem Zeitstempel angewendet werden, der größer oder gleich dem Zeitstempel des campaign_details-Ereignisses ist.

Hinweis :Das Ereignis campaign_details ist in Google Analytics-Berichten oder in DebugView nicht zu sehen. Wenn Sie den BigQuery-Export aktiviert haben, ist dieses Ereignis in Ihren BigQuery-Ereignisexportdaten enthalten.

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 „email“.
medium	string	Nein	CPC	Das Kampagnenmedium (z.B. E-Mail, Cost-per-Click usw.)
term	string	Nein	summer+travel	Der Kampagnenbegriff, der für die bezahlte Suche verwendet wird, um die Keywords für Anzeigen anzugeben.
content	string	Nein	logolink	Der Kampagneninhalt wird für A/B-Tests und Anzeigen mit inhaltsbezogener Ausrichtung verwendet, um Anzeigen oder Links zu unterscheiden, die auf dieselbe URL verweisen.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein campaign_details-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

Onlineverkäufe

add_payment_info

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.
cart_data.coupon_codes	string[]	Nein	SUMMER_FUN	Der Gutscheincode, der dem Ereignis zugeordnet ist. Legen Sie das Feld coupon_codes für das Objekt CartData fest. * Geben Sie in dieser Liste nur einen Gutscheincode an. * Dies ist unabhängig von Gutscheincodes auf Artikelebene.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
payment_type	string	Nein	Kreditkarte	Die ausgewählte Zahlungsmethode.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein add_payment_info-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.
cart_data.coupon_codes	string[]	Nein	SUMMER_FUN	Der Gutscheincode, der dem Ereignis zugeordnet ist. Legen Sie das Feld coupon_codes für das Objekt CartData fest. * Geben Sie in dieser Liste nur einen Gutscheincode an. * Dies ist unabhängig von Gutscheincodes auf Artikelebene.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
shipping_tier	string	Nein	Boden	Die Versandmethode (z.B. Ground, Air, Next-day), die für die Lieferung des gekauften Artikels ausgewählt wird.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein add_shipping_info-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_cart

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein add_to_cart-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein add_to_wishlist-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.
cart_data.coupon_codes	string[]	Nein	SUMMER_FUN	Der Gutscheincode, der dem Ereignis zugeordnet ist. Legen Sie das Feld coupon_codes für das Objekt CartData fest. * Geben Sie in dieser Liste nur einen Gutscheincode an. * Dies ist unabhängig von Gutscheincodes auf Artikelebene.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein begin_checkout-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

Dieses Ereignis ist nur für App-Streams verfügbar.

Verwenden Sie dieses Ereignis, wenn ein Nutzer einen In-App-Kauf tätigt.

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Nein		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
product_id	string	Nein	ABC123456789	Die ID des Produkts.
subscription	boolean	Nein	wahr	Gibt an, ob es sich bei dem Kauf um ein Abo handelt. Hat standardmäßig den Wert false, wenn nichts anderes festgelegt wird.
free_trial	boolean	Nein	wahr	Gibt an, ob das Ereignis für ein kostenloses Probeabo ist. Hat standardmäßig den Wert false, wenn nichts anderes festgelegt wird.
price_is_discounted	boolean	Nein	falsch	Gibt an, ob für die price ein Rabatt gewährt wird. Hat standardmäßig den Wert false, wenn nichts anderes festgelegt wird.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein in_app_purchase-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
transaction_id	string	Ja	T_12345	Die eindeutige ID einer Transaktion. Mit dem Parameter transaction_id lässt sich vermeiden, dass doppelte Ereignisse für einen Kauf erfasst werden. Legen Sie das Feld transaction_id für das Objekt Event fest.
user_properties.customer_type	CustomerType	Nein	NEW	Gibt an, ob die Conversion von einem NEW- oder RETURNING-Kunden stammt.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.
cart_data.coupon_codes	string[]	Nein	SUMMER_FUN	Der Gutscheincode, der dem Ereignis zugeordnet ist. Legen Sie das Feld coupon_codes für das Objekt CartData fest. * Geben Sie in dieser Liste nur einen Gutscheincode an. * Dies ist unabhängig von Gutscheincodes auf Artikelebene.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
shipping	number	Nein	3,33	Die Versandkosten, die einer Transaktion zugewiesen sind.
tax	number	Nein	1.11	Die Steuern für eine Transaktion.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein purchase-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

Hinweis :Wir empfehlen, Artikelinformationen in Ihr refund-Ereignis aufzunehmen, damit Sie in Analytics Messwerte für Erstattungen auf Artikelebene sehen können.

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
transaction_id	string	Ja	T_12345	Die eindeutige ID einer Transaktion.
cart_data.items	Item[]	Nein		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.
cart_data.coupon_codes	string[]	Nein	SUMMER_FUN	Der Gutscheincode, der dem Ereignis zugeordnet ist. Legen Sie das Feld coupon_codes für das Objekt CartData fest. * Geben Sie in dieser Liste nur einen Gutscheincode an. * Dies ist unabhängig von Gutscheincodes auf Artikelebene.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
shipping	number	Nein	3,33	Die Versandkosten, die einer Transaktion zugewiesen sind.
tax	number	Nein	1.11	Die Steuern für eine Transaktion.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein refund-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein remove_from_cart-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
cart_data.items	Item[]	Ja*		Die Artikel für das Ereignis. * Das items-Array sollte ein einzelnes Element enthalten, das das ausgewählte Element darstellt. Wenn mehrere Elemente angegeben sind, wird nur das erste Element in items verwendet. Setzen Sie das Feld cart_data.items für das Objekt Event.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wird ignoriert, wenn sie auf Artikelebene festgelegt ist.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein select_item-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
cart_data.items	Item[]	Nein		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
creative_name	string	Nein	summer_banner2	Der Name des Angebots-Creatives.
creative_slot	string	Nein	featured_app_1	Der Name der Creative-Fläche, die mit dem Ereignis verknüpft ist.
promotion_id	string	Nein	P_12345	Die ID des Angebots, das mit dem Ereignis verknüpft ist.
promotion_name	string	Nein	Sommer-Sale	Der Name des Angebots, das mit dem Ereignis verknüpft ist.

Wenn Sie in Google Analytics-Berichten Dimensionen auf Artikelebene für Angebote wie „Angebots-ID“ oder „Name des Angebots“ verwenden möchten, sucht Google Analytics zuerst in jedem einzelnen Objekt im Array items Ihrer E-Commerce-Ereignisse nach den entsprechenden Parametern für Angebote (promotion_id, promotion_name, creative_name und creative_slot). Wenn ein Parameter nicht im Artikelobjekt gefunden wird, verwendet Google Analytics den Wert des Parameters auf Ereignisebene, sofern er angegeben ist. Eine promotionsbezogene Dimension auf Artikelebene für einen bestimmten Artikel wird nur dann als „(not set)“ (nicht festgelegt) erfasst, wenn der entsprechende Parameter sowohl im Artikelobjekt als auch in den Parametern auf Ereignisebene fehlt. Parameter auf Artikelebene haben immer Vorrang vor Parametern auf Ereignisebene.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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 Angebots-Creatives. Wenn kein Wert festgelegt ist, wird standardmäßig creative_name auf Ereignisebene verwendet.
creative_slot	string	Nein	featured_app_1	Der Name der Creative-Fläche, die mit dem Artikel verknüpft ist. Wenn kein Wert festgelegt ist, wird standardmäßig creative_slot auf Ereignisebene verwendet.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.
promotion_id	string	Nein	P_12345	Die ID des Angebots, das mit dem Artikel verknüpft ist. Wenn kein Wert festgelegt ist, wird standardmäßig promotion_id auf Ereignisebene verwendet.
promotion_name	string	Nein	Sommer-Sale	Der Name des Werbeangebots, das mit dem Artikel verknüpft ist. Wenn kein Wert festgelegt ist, wird standardmäßig promotion_name auf Ereignisebene verwendet.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein select_promotion-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein view_cart-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * Legen Sie conversion_value auf die Summe von (price * quantity) für alle Elemente in items fest. Geben Sie nicht shipping oder tax an. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein view_item-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung der Artikel, die dem Ereignis zugewiesen sind, im ISO 4217-Format mit drei Buchstaben. * Wertmesswerte für das view_item-Ereignis tragen nicht zum Umsatz bei. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
cart_data.items	Item[]	Ja		Die Artikel für das Ereignis. Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein view_item_list-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
cart_data.items	Item[]	Ja*		Die Artikel für das Ereignis. * Das items-Array sollte ein einzelnes Element enthalten, das das mit dem Angebot verknüpfte Element darstellt. Wenn mehrere Elemente angegeben sind, wird nur das erste Element in items verwendet. Setzen Sie das Feld cart_data.items für das Objekt Event.

Artikel-Felder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_id	string	Ja	I_12345	Eine eindeutige Kennung für das Element. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price	number	Ja	27,67	Der Artikelpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel. Wenn für den Artikel ein Rabatt auf Artikelebene gilt, verwenden Sie den reduzierten Stückpreis. Wenn ein Artikel beispielsweise einen Grundpreis von 27,67 € und einen Rabatt pro Einheit von 6,66 € hat, legen Sie unitPrice auf 21,01 € fest.
quantity	number	Ja	1	Die Anzahl der für diesen Artikel gekauften Einheiten.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
creative_name	string	Nein	summer_banner2	Der Name des Angebots-Creatives.
creative_slot	string	Nein	featured_app_1	Der Name der Creative-Fläche, die mit dem Ereignis verknüpft ist.
promotion_id	string	Nein	P_12345	Die ID des Angebots, das mit dem Ereignis verknüpft ist.
promotion_name	string	Nein	Sommer-Sale	Der Name des Angebots, das mit dem Ereignis verknüpft ist.

Wenn Sie in Google Analytics-Berichten Dimensionen für Angebote auf Artikelebene wie „Angebots-ID“ oder „Name des Angebots“ verwenden möchten, sucht Google Analytics zuerst in jedem Objekt des items-Arrays Ihrer E-Commerce-Ereignisse nach den entsprechenden Angebotsparametern (promotion_id, promotion_name, creative_name und creative_slot). Wenn ein Parameter nicht im Artikelobjekt gefunden wird, verwendet Google Analytics den Wert des Parameters auf Ereignisebene, sofern er angegeben ist. Dimensionswerte für Werbeaktionen auf Artikelebene für einen bestimmten Artikel werden nur dann als „(not set)“ (nicht festgelegt) erfasst, wenn der entsprechende Parameter sowohl im Artikelobjekt als auch in den Parametern auf Ereignisebene fehlt. Parameter auf Artikelebene haben immer Vorrang vor Parametern auf Ereignisebene.

„item“-Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
item_name	string	Ja*	„Stan and Friends“-T-Shirt	Der Name des Artikels. *Entweder item_id oder item_name ist erforderlich.
affiliation	string	Nein	Google Store	Eine Produktzugehörigkeit zur Angabe eines Lieferanten oder Ladengeschäfts Hinweis: affiliation ist nur auf 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 Angebots-Creatives. Wenn kein Wert festgelegt ist, wird standardmäßig creative_name auf Ereignisebene verwendet.
creative_slot	string	Nein	featured_app_1	Der Name der Creative-Fläche, die mit dem Artikel verknüpft ist. Wenn kein Wert festgelegt ist, wird standardmäßig creative_slot auf Ereignisebene verwendet.
discount	number	Nein	2.22	Der Geldwert des Rabatts pro Einheit, der dem Artikel zugewiesen ist.
index	number	Nein	5	Der Index bzw. die Position des Artikels in einer Liste.
item_brand	string	Nein	Google	Die Marke des Artikels
item_category	string	Nein	Bekleidung	Die Kategorie des Artikels Wenn sie als Teil einer Kategoriehierarchie oder ‑taxonomie verwendet wird, ist dies die erste Kategorie.
item_category2	string	Nein	Adult	Die zweite Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category3	string	Nein	Hemden	Die dritte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category4	string	Nein	Crew	Die vierte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_category5	string	Nein	Kurzarm	Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie des Artikels.
item_list_id	string	Nein	related_products	Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_id auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_id auf Ereignisebene verwendet, sofern vorhanden.
item_list_name	string	Nein	Ähnliche Produkte	Der Name der Liste, in der dem Nutzer der Artikel präsentiert wurde Wenn festgelegt, wird item_list_name auf Ereignisebene ignoriert. Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, sofern vorhanden.
item_variant	string	Nein	Grün	Die Artikelvariante oder der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails/-optionen.
location_id	string	Nein	ChIJIQBpAG2ahYAR_6128GcTUEo (die Google Orts-ID für San Francisco)	Der dem Artikel zugeordnete physische Standort, z.B. der Standort des Ladengeschäfts. Wir empfehlen, die Google Orts-ID zu verwenden, die dem zugehörigen Artikel entspricht. Es kann auch eine benutzerdefinierte Standort-ID verwendet werden. Hinweis: location_id ist nur auf Artikelebene verfügbar.
promotion_id	string	Nein	P_12345	Die ID des Angebots, das mit dem Artikel verknüpft ist. Wenn kein Wert festgelegt ist, wird standardmäßig promotion_id auf Ereignisebene verwendet.
promotion_name	string	Nein	Sommer-Sale	Der Name des Werbeangebots, das mit dem Artikel verknüpft ist. Wenn kein Wert festgelegt ist, wird standardmäßig promotion_name auf Ereignisebene verwendet.

Zusätzlich zu den vorgeschriebenen Parametern können Sie im Array items bis zu 27 benutzerdefinierte Parameter angeben.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein view_promotion-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Spiele

level_up

Dieses Ereignis gibt an, dass ein Spieler in einem Spiel ein höheres Level erreicht hat. Damit können Sie die Verteilung der Level Ihrer Nutzerbasis einschätzen und Level identifizieren, die schwer zu absolvieren sind.

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein level_up-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

post_score

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

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein post_score-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

unlock_achievement

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

Parameter

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

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein unlock_achievement-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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"
      }
    }]
  })
});

Lead-Generierung

close_convert_lead

Protokollieren Sie dieses Ereignis, wenn ein qualifizierter Lead erfolgreich in einen Kunden umgewandelt wird. Dies bedeutet in der Regel das Ende des Lead-Nurturing-Prozesses, z. B. wenn ein Vertrag unterzeichnet, ein kostenpflichtiges Abo abgeschlossen oder ein endgültiger Verkauf abgeschlossen wird.

• Hinweis:Wenn Sie die erste Lead-Erfassung erfassen möchten, z. B. Formulareinsendungen, Newsletteranmeldungen oder Demoanfragen, verwenden Sie das Ereignis generate_lead.

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein close_convert_lead-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
unconvert_lead_reason	string	Nein	Nie geantwortet	Der Grund, warum es nicht zu einer Lead-Conversion gekommen ist.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein close_unconvert_lead-Ereignis über die Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

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": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
disqualified_lead_reason	string	Nein	Ich möchte nichts kaufen	Der Grund, warum ein Lead als ausgeschlossen markiert wurde

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein disqualify_lead-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

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": "disqualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "disqualified_lead_reason": "Not looking to buy"
      }
    }]
  })
});

generate_lead

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
lead_source	string	Nein	Messe	Die Quelle des Leads.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein generate_lead-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

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": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

qualify_lead

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein qualify_lead-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

working_lead

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

Ereignisfelder

Name	Typ	Erforderlich	Beispielwert	Beschreibung
currency	string	Ja*	USD	Die Währung des conversion_value des Ereignisses im dreistelligen ISO 4217-Format. * Wenn Sie conversion_value festlegen, ist currency erforderlich, damit Umsatzmesswerte genau berechnet werden können.
conversion_value	number	Ja*	30.03	Der Geldwert des Ereignisses. * conversion_value ist in der Regel für aussagekräftige Berichte erforderlich. Wenn Sie das Ereignis als Schlüsselereignis markieren, sollten Sie conversion_value festlegen. * currency ist erforderlich, wenn Sie conversion_value festlegen.

Parameter

Name	Typ	Erforderlich	Beispielwert	Beschreibung
lead_status	string	Nein	Gestartete Unterhaltungen	Der Status des Leads.

Beispiel

Im folgenden Beispiel sehen Sie, wie Sie ein working_lead-Ereignis mit der Data Manager API senden. Wenn Sie ein Upgrade vom Measurement Protocol durchführen, verwenden Sie die Tabs, um Ihre Anfragen zur Data Manager API zu migrieren.

Data Manager API

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

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": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});