Empfohlene Google Analytics-Ereignisse

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

Beim Erstellen benutzerdefinierter Ereignisnamen müssen Sie Folgendes beachten:

  1. Beachten Sie die Regeln für Ereignisnamen.
  2. Vermeiden Sie reservierte Namen und Präfixe.
  3. Beachten Sie die Einschränkungen für die Ereigniserfassung, z. B. die Zeichenbeschränkung auf 40 Zeichen für Ereignis- und Parameternamen.

Weitere Informationen finden Sie unter Erste Schritte.

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, der über das Measurement Protocol gesendet wird, wird nicht in Exporte an andere Werbeplattformen wie Google Ads einbezogen.
  • Wenn Sie ad_impression-Ereignisse über das Measurement Protocol senden, kann es zu doppelten Impressionen kommen, wenn Sie 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 wird gezeigt, 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

Mit diesem Ereignis wird erfasst, wenn 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 Gems Der Name der virtuellen Währung.

Beispiel

Im folgenden Beispiel wird gezeigt, 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

Protokollieren Sie dieses Ereignis, 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 wird gezeigt, 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 wird.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 einen Bildschirmübergang zu kennzeichnen.

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

Protokollieren Sie dieses Ereignis, um anzugeben, wann der Nutzer eine Suche durchgeführt hat. Mit diesem Ereignis können Sie herausfinden, wonach Nutzer auf Ihrer Website oder in Ihrer App suchen. Sie können dieses Ereignis 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 wird gezeigt, 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 bedeutet, dass ein Nutzer Inhalte eines bestimmten Typs ausgewählt hat. Mit diesem Ereignis können Sie beliebte Inhalte und Inhaltskategorien auf Ihrer Website oder in Ihrer App ermitteln.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
content_type string Nein Produkt Der Typ des ausgewählten Inhalts.
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 wird gezeigt, 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
method string Nein Twitter Die Methode, mit der die Inhalte geteilt werden.
content_type string Nein Image Die Art des geteilten Inhalts.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 wird gezeigt, 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 Waren in Ihrer App gemessen. So können Sie feststellen, welche virtuellen Waren 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„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 Gems Der Name der virtuellen Währung.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 dieses Ereignis 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 wird gezeigt, 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 wird gezeigt, wie Sie ein tutorial_complete-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_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 angezeigt wurden. Sie können das Ereignis „view_search_results“ für die automatische Erfassung über die optimierte Ereignisanalyse in Google Analytics aktivieren.

Parameter

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

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein view_search_results-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_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

Verwenden Sie dieses Ereignis, um Kampagnendetails zu senden, die auf Ereignisse mit einem Zeitstempel angewendet werden, der größer oder gleich dem Zeitstempel des Ereignisses campaign_details ist.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
campaign_id string Nein google_1234 Die Kampagnen-ID.
campaign string Nein Summer_fun Der Name, mit dem ein bestimmtes Angebot oder eine strategische Kampagne identifiziert wird.
source string Nein Google Die Traffic-Quelle der Kampagne (z. B. google, email).
medium string Nein CPC Das Kampagnenmedium (z.B. E-Mail, Cost-per-Click usw.)
term string Nein summer+travel Der Kampagnenbegriff, der bei der bezahlten Suche verwendet wird, um die Keywords für Anzeigen bereitzustellen.
content string Nein logolink Der Kampagneninhalt, der für A/B-Tests und Anzeigen mit inhaltsbezogener Ausrichtung verwendet wird, um Anzeigen oder Links zu unterscheiden, die auf dieselbe URL verweisen.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein campaign_details-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": "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 bedeutet, dass ein Nutzer seine Zahlungsinformationen im Bezahlvorgang eines E-Commerce-Shops 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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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 zugewiesen 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

Parameter

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

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein add_payment_info-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_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 bedeutet, dass ein Nutzer seine Versandinformationen im Rahmen eines Bezahlvorgangs im E-Commerce gesendet 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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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 zugewiesen 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

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 wird gezeigt, wie Sie ein add_shipping_info-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_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 einen 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 Ereignis view_item 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 Artikel 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 identifizieren.

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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 den Bezahlvorgang gestartet 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 Ereignis view_item 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 Artikel 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 zugewiesen 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 ISO 4217-Format mit drei Buchstaben.

* 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.
transaction_id string Nein T_12345 Die eindeutige Kennung 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.
cart_data.items Item[] Nein Die Artikel für das Ereignis.

Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

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.
Wenn nichts anderes festgelegt ist, wird standardmäßig false verwendet.
free_trial boolean Nein wahr

Gibt an, ob das Ereignis für ein kostenloses Probeabo gilt.
Wenn nichts anderes festgelegt ist, wird standardmäßig false verwendet.
price_is_discounted boolean Nein falsch

Gibt an, ob der price rabattiert ist.
Wenn nichts anderes festgelegt ist, wird standardmäßig false verwendet.

Beispiel

Im folgenden Beispiel wird gezeigt, 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",
      "transactionId": "T_12345",
      "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,
        "transaction_id": "T_12345",
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

Dieses Ereignis wird ausgelöst, wenn ein Nutzer einen oder mehrere 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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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 Kennung 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 zugewiesen 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

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 Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 gibt an, wenn einem Nutzer ein oder mehrere Artikel erstattet werden.

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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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 Kennung 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 zugewiesen 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

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 Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel in items fest. Gib 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein remove_from_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": "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 Artikel aus einer Liste ausgewählt wurde.

Ereignisfelder

Name Typ Erforderlich Beispielwert Beschreibung
cart_data.items Item[] Ja* Die Artikel für das Ereignis.

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

Legen Sie das Feld cart_data.items für das Objekt Event fest.

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

Wird ignoriert, wenn auf Artikelebene festgelegt.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
creative_name string Nein summer_banner2 Der Name des Werbe-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 der Werbeaktion, die mit dem Ereignis verknüpft ist.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 Werbe-Creatives.

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

Wenn nicht festgelegt, wird standardmäßig die Ereignisebene creative_slot 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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
promotion_id string Nein P_12345 Die ID des Angebots, das mit dem Artikel verknüpft ist.

Wenn nicht festgelegt, wird standardmäßig die Ereignisebene promotion_id verwendet.
promotion_name string Nein Sommer-Sale Der Name des Angebots, das mit dem Artikel verknüpft ist.

Wenn nicht festgelegt, wird standardmäßig die Ereignisebene promotion_name verwendet.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein select_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": "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 sich ein Nutzer 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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 angezeigt wurden. Mit diesem Ereignis können Sie die am häufigsten angesehenen 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 Ereignis view_item 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 für conversion_value die Summe von (price * quantity) für alle Artikel 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 Ereignis view_item 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.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 angesehen wurde.

Ereignisfelder

Name Typ Erforderlich Beispielwert Beschreibung
cart_data.items Item[] Ja* Die Artikel für das Ereignis.

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

Legen Sie das Feld cart_data.items für das Objekt Event fest.

Artikelfelder

Name Typ Erforderlich Beispielwert Beschreibung
item_id string Ja I_12345 Eine eindeutige Kennung für den Artikel. Legen Sie das Feld item_id für das Objekt Item fest.
unit_price number Ja 27,67 Der Stückpreis ohne Steuern, Versand und Rabatte auf Ereignisebene (Transaktionsebene) für diesen Artikel.

Wenn für den Artikel ein artikelspezifischer Rabatt gilt, verwenden Sie den rabattierten Einzelpreis. Wenn ein Artikel beispielsweise einen Einzelpreis von 27,67 und einen Einzelrabatt von 6,66 hat, legen Sie unitPrice auf 21,01 fest.
quantity number Ja 1 Die Anzahl der gekauften Artikel für diesen bestimmten Artikel.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
creative_name string Nein summer_banner2 Der Name des Werbe-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 der Werbeaktion, die mit dem Ereignis verknüpft ist.

„item“-Parameter

Name Typ Erforderlich Beispielwert Beschreibung
item_name string Ja* Stan and Friends Tee

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 Werbe-Creatives.

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

Wenn nicht festgelegt, wird standardmäßig die Ereignisebene creative_slot 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 für den Artikel.
item_category3 string Nein Hemden Die dritte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category4 string Nein Crew Die vierte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_category5 string Nein Kurzarm Die fünfte Kategoriehierarchie oder zusätzliche Taxonomie für den Artikel.
item_list_id string Nein related_products Die ID der Liste, in der dem Nutzer der Artikel präsentiert wurde

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

Wenn dieser Parameter festgelegt ist, wird item_list_name auf Ereignisebene ignoriert.
Wenn nicht festgelegt, wird die item_list_name auf Ereignisebene verwendet, falls vorhanden.
item_variant string Nein Grün Die Artikelvariante, der eindeutige Code oder die Beschreibung für zusätzliche Artikeldetails oder -optionen.
location_id string Nein ChIJIQBpAG2ahYAR_6128GcTUEo (die Google-Orts-ID für San Francisco) Der physische Standort, der mit dem Artikel verknüpft ist (z.B. der Standort des Geschäfts). Wir empfehlen, die Google-Orts-ID zu verwenden, die dem zugehörigen Element entspricht. Sie können auch eine benutzerdefinierte Standort-ID verwenden.
Hinweis: location_id ist nur auf Artikelebene verfügbar.
promotion_id string Nein P_12345 Die ID des Angebots, das mit dem Artikel verknüpft ist.

Wenn nicht festgelegt, wird standardmäßig die Ereignisebene promotion_id verwendet.
promotion_name string Nein Sommer-Sale Der Name des Angebots, das mit dem Artikel verknüpft ist.

Wenn nicht festgelegt, wird standardmäßig die Ereignisebene promotion_name verwendet.
Zusätzlich zu den vorgeschriebenen Parametern können Sie bis zu 27 benutzerdefinierte Parameter in das items-Array aufnehmen.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 neues Level erreicht hat. Damit können Sie die Verteilung der Level Ihrer Nutzerbasis messen und Level identifizieren, die schwer abzuschließen sind.

Parameter

Name Typ Erforderlich Beispielwert Beschreibung
level number Nein 5 Das Level des Charakters.
character string Nein Spieler 1 Der Charakter, der ein Level aufgestiegen ist.

Beispiel

Im folgenden Beispiel wird gezeigt, 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 die Leistung von Nutzern in Ihrem Spiel nachvollziehen und Highscores mit Zielgruppen oder Verhaltensweisen in Verbindung bringen.

Parameter

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

Beispiel

Im folgenden Beispiel wird gezeigt, 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

Dieses Ereignis sollte protokolliert werden, wenn der Nutzer einen Erfolg erzielt 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 wird gezeigt, wie Sie ein unlock_achievement-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": "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 gestartet oder ein endgültiger Verkauf abgeschlossen wird.

  • Hinweis:Wenn Sie die erste Leadgewinnung erfassen möchten, z. B. Formulareinreichungen, Newsletter-Anmeldungen 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 ISO 4217-Format mit drei Buchstaben.

* 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 wird gezeigt, wie Sie ein close_convert_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": "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

Mit diesem Ereignis wird erfasst, wenn ein Nutzer nicht zu einem Lead mit Conversion wird, und der Grund dafür.

Ereignisfelder

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des conversion_value des Ereignisses 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 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 der Lead nicht konvertiert wurde.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie ein close_unconvert_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": "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

Mit diesem Ereignis wird erfasst, wenn ein Nutzer als Lead disqualifiziert wird, zusammen mit dem Grund für die Disqualifikation.

Ereignisfelder

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des conversion_value des Ereignisses 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 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 wird gezeigt, 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

Mit diesem Ereignis wird erfasst, wenn ein Lead generiert wurde, z. B. über ein Formular. Protokollieren Sie dies, um die Effektivität Ihrer Marketingkampagnen zu ermitteln und zu 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 ISO 4217-Format mit drei Buchstaben.

* 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 wird gezeigt, 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

Mit diesem Ereignis wird erfasst, wenn ein Nutzer die Kriterien für einen qualifizierten Lead erfüllt.

Ereignisfelder

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des conversion_value des Ereignisses 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 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 wird gezeigt, 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

Mit diesem Ereignis wird erfasst, wenn ein Nutzer einen Mitarbeiter kontaktiert oder von einem Mitarbeiter kontaktiert wird.

Ereignisfelder

Name Typ Erforderlich Beispielwert Beschreibung
currency string Ja* USD Die Währung des conversion_value des Ereignisses 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 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 Begonnene Unterhaltungen Der Status des Leads.

Beispiel

Im folgenden Beispiel wird gezeigt, 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"
      }
    }]
  })
});