Measurement Protocol-Referenz

Auf dieser Seite werden der Transportmechanismus und die Datenparameter für das Measurement Protocol beschrieben.

Transport

Alle Daten müssen sicher mit HTTPS-POST-Anfragen gesendet werden.

Senden Sie Anfragen an den folgenden Endpunkt:

https://www.google-analytics.com/mp/collect

Wenn Sie möchten, dass Ihre Daten in der EU verarbeitet werden, verwenden Sie stattdessen den folgenden Endpunkt:

https://region1.google-analytics.com/mp/collect

Hier ein Beispiel für eine POST-Anfrage:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

Ersetzen Sie PAYLOAD_DATA durch die Nutzlast der Anfrage.

Das Measurement Protocol gibt den Statuscode 2xx zurück, wenn die HTTP-Anfrage empfangen wird. Das Measurement Protocol gibt keinen Fehlercode zurück, wenn die Nutzlast fehlerhaft ist oder die Daten falsch sind oder nicht von Google Analytics verarbeitet werden.

Nutzlast

Die Nutzlast besteht aus zwei Teilen:

1. Abfrageparameter
2. Einen JSON-POST-Textkörper.

Abfrageparameter

JSON-POST-Text

Einwilligung

Mit dem Attribut consent werden die Typen und Status der Einwilligung konfiguriert. Wenn Sie consent nicht angeben, verwendet Google Analytics die Einwilligungseinstellungen aus den entsprechenden Onlineinteraktionen für die Client- oder App-Instanz.

Geografische Daten

Die Attribute user_location und ip_override enthalten geografische Informationen. user_location hat Vorrang vor ip_override.

Hier ist die Struktur des Felds user_location. Geben Sie so viele Attribute wie möglich an. Wir empfehlen mindestens country_id und region_id.

Hier ein Beispiel für user_location:

"user_location:" {
  "city:" "Mountain View",
  "region_id:" "US-CA",
  "country_id:" "US",
  "subcontinent_id:" "021",
  "continent_id:" "019"
}

ip_override ist eine Alternative zu user_location. Wenn Sie stattdessen ip_override senden, werden in Google Analytics geografische Informationen aus der IP-Adresse abgeleitet. Wenn Sie user_location senden, wird ip_override in Google Analytics ignoriert.

Wenn Sie user_location oder ip_override nicht senden, werden in Google Analytics geografische Informationen aus Tagging-Ereignissen mit client_id.

In Google Analytics werden die Einstellungen für die detaillierte Erhebung von Standortdaten der Property auf die Anfrage angewendet, unabhängig von den gesendeten geografischen Informationen.

Geräteinformationen

Verwenden Sie das Feld device, um Geräteinformationen zu senden. Hier ist die Struktur des Felds device. Geben Sie so viele Attribute wie möglich an. Wir empfehlen mindestens category.

Das folgende Snippet zeigt ein Beispiel für device-Einstellungen:

"device:" {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

Unabhängig davon, ob Sie angeben, werden in Google Analytics die Einstellungen für detaillierte Gerätedaten der Property auf die Anfrage angewendet.

Benutzerdefinierte Parameter

Sie können benutzerdefinierte Parameter auf Nutzer-, Ereignis- und Artikelebene in eine Measurement Protocol-Nutzlast aufnehmen.

• Benutzerdefinierte Parameter auf Nutzerebene können in user_properties eingefügt werden.
• events[].params kann benutzerdefinierte Parameter auf Ereignisebene enthalten.
• Benutzerdefinierte Parameter auf Artikelebene können in items eingefügt werden.

Empfohlene Werte für bestimmte Ereignisse

Für einige Ereignisse gibt es empfohlene Parameter. Unter Ereignisse finden Sie die empfohlenen Parameter für alle unterstützten Ereignisse.

Reservierte Namen

Einige Namen von Ereignissen, Parametern und Nutzereigenschaften sind reserviert und können nicht verwendet werden:

Reservierte Ereignisnamen

Die folgenden Ereignisnamen sind reserviert und können nicht verwendet werden:

• ad_activeview
• ad_click
• ad_exposure
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• app_exception
• app_install
• app_remove
• app_store_refund
• app_update
• app_upgrade
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

Reservierte Parameternamen

Die folgenden Parameternamen sind reserviert und können nicht verwendet werden:

• firebase_conversion

Parameternamen dürfen nicht mit folgenden Zeichen oder Präfixen beginnen:

• _ (underscore)
• firebase_
• ga_
• google_
• gtag.

Reservierte Namen von Nutzereigenschaften

Die folgenden Namen von Nutzereigenschaften sind reserviert und können nicht verwendet werden:

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

Außerdem dürfen Namen von Nutzereigenschaften nicht mit folgenden Zeichen oder Präfixen beginnen:

• _ (underscore)
• firebase_
• ga_
• google_