Measurement Protocol-Referenz

Übersicht

Das Senden von Daten an Google Analytics mithilfe des Measurement Protocol besteht aus zwei Teilen:

  1. Transport – Wo und wie Daten gesendet werden
  2. Die Nutzlast – die von Ihnen gesendeten Daten

In diesem Dokument wird beschrieben, wie Transport und Nutzlast formatiert sind.

Transport

URL-Endpunkt

Sie senden Daten mit dem Measurement Protocol, indem Sie HTTP-POST-Anfragen an den folgenden Endpunkt senden:

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

Senden Sie eine POST-Anfrage, um ein Ereignis zu senden:

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

Antwortcodes

Das Measurement Protocol gibt immer den Statuscode 2xx zurück, wenn die Anfrage HTTP eingegangen ist. Das Measurement Protocol gibt keinen Fehlercode zurück, wenn die Nutzlastdaten fehlerhaft waren oder die Daten in der Nutzlast falsch waren oder nicht von Google Analytics verarbeitet wurden.

Nutzlast

Die Daten werden mithilfe der Measurement Protocol-Daten aus zwei Teilen an Google Analytics gesendet:

  1. Abfrageparameter
  2. Ein JSON-POST-Text

Suchparameter

Parametername Beschreibung

api_secret

Erforderlich. Ein API Secret, der über die Google Analytics-Benutzeroberfläche generiert wird.

Wenn Sie ein neues Secret erstellen möchten, gehen Sie in der Google Analytics-Benutzeroberfläche zu:
Admin > Datenstreams > Stream auswählen > Measurement Protocol > Erstellen

Wir empfehlen Ihnen, diese Informationen auf Ihre Organisation zu beschränken. Wenn Sie das Measurement Protocol auf Clientseite bereitstellen, sollten Sie api_secrets regelmäßig rotieren, um übermäßige SPAM zu vermeiden.

firebase_app_id

 Erforderlich. Firebase App-ID. Die Kennung für eine Firebase-App. Sie finden sie in der Firebase Console unter:
Projekteinstellungen > Allgemein > Meine Apps > App-ID

measurement_id

 Mess-ID. Die Kennung für einen Datenstream. Sie finden ihn in der Google Analytics-Benutzeroberfläche unter:
Verwaltung > Datenstreams > Stream auswählen > Mess-ID

JSON-Beitragstext

Schlüssel Typ Beschreibung

app_instance_id

 string

Erforderlich. Kennzeichnet eine bestimmte Installation einer Firebase-App eindeutig. Dieser Wert muss über das Firebase SDK abgerufen werden.

client_id

 string

Erforderlich. Kennzeichnet eindeutig eine Nutzerinstanz eines Webclients. Siehe Ereignis an Measurement Protocol senden.

user_id

 string

Optional. Eine eindeutige Kennung für einen Nutzer. Weitere Informationen zu dieser ID finden Sie unter Nutzer-ID für plattformübergreifende Analysen.

timestamp_micros

 number

Optional. Ein Unix-Zeitstempel (in Mikrosekunden) für die Zeit, die dem Ereignis zugeordnet werden soll. Dies sollte nur so festgelegt werden, dass Ereignisse erfasst werden, die in der Vergangenheit stattgefunden haben. Dieser Wert kann mit user_property- oder Ereigniszeitstempeln überschrieben werden. Ereignisse können bis zu 3 Kalendertage in der Zeitzone der Unterkunft rückdatiert werden.

user_properties

 object Optional. Die Nutzereigenschaften für die Messung. Weitere Informationen finden Sie unter Nutzereigenschaften.

non_personalized_ads

 boolean Optional. Legen Sie true fest, wenn diese Ereignisse nicht für personalisierte Anzeigen verwendet werden sollen.

events[]

 array Erforderlich. Ein Array von Ereigniselementen. Pro Anfrage können bis zu 25 Ereignisse gesendet werden. In der Referenz zu Ereignissen finden Sie alle gültigen Ereignisse.

events[].name

 string Erforderlich. Der Name des Ereignisses. In der Referenz zu Ereignissen finden Sie alle Optionen.

events[].params

 object Optional. Die Parameter für das Ereignis. Die vorgeschlagenen Parameter für jedes Ereignis finden Sie unter Ereignisse.

Einige Ereignisse haben empfohlene Parameter. Die empfohlenen Parameter für alle unterstützten Ereignisse finden Sie unter Ereignisse.

Reservierte Namen

Reservierte Ereignisnamen

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

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_impression
  • 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
  • screen_view
  • session_start
  • user_engagement

Reservierte Parameternamen

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

  • firebase_conversion

Parameternamen dürfen außerdem nicht mit folgenden Zeichen beginnen:

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

Reservierte Namen von Nutzereigenschaften

Die folgenden Namen für 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

Namen von Nutzereigenschaften dürfen außerdem nicht mit folgenden Zeichen beginnen:

  • _ (underscore)
  • firebase_
  • ga_
  • google_