Überblick
Das Senden von Daten an Google Analytics mithilfe des Measurement Protocol besteht aus zwei Teilen:
In diesem Dokument wird beschrieben, wie Transport und Nutzlast formatiert sind.
Transport
URL-Endpunkt
Zum Senden von Daten mithilfe des Measurement Protocol stellen Sie HTTP-POST-Anfragen an den folgenden Endpunkt:
https://www.google-analytics.com/mp/collect
Um ein Ereignis zu senden, senden Sie die folgende POST
-Anfrage:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
Der
BODY
der Anfrage. Siehe Nutzlast.
Antwortcodes
Das Measurement Protocol gibt immer den Statuscode 2xx
zurück, wenn die HTTP
-Anfrage empfangen wurde. Das Measurement Protocol gibt keinen Fehlercode zurück, wenn die Nutzlastdaten fehlerhaft waren oder wenn die Daten in der Nutzlast falsch waren oder nicht von Google Analytics verarbeitet wurden.
Nutzlast
Daten werden mithilfe der Measurement Protocol-Daten an Google Analytics gesendet, die aus zwei Teilen bestehen:
- Abfrageparameter
- Ein
JSON
-POST
-Text
Suchparameter
Parametername | Beschreibung |
---|---|
|
Erforderlich. Ein
Zum Erstellen eines neuen Secrets rufen Sie die Google Analytics-Benutzeroberfläche auf:
Wir empfehlen Ihnen, diese auf Ihre Organisation zu beschränken. Wenn Sie das Measurement Protocol clientseitig bereitstellen, sollten Sie |
|
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 |
|
Mess-ID: Die ID für einen Datenstream. Sie finden die Google Analytics-Benutzeroberfläche unter:
Verwaltung > Datenstreams > Stream auswählen > Mess-ID |
JSON-Beitragstext
Schlüssel | Typ | Beschreibung |
---|---|---|
|
string |
Erforderlich. Hiermit wird eine bestimmte Installation einer Firebase-App eindeutig identifiziert. Dieser Wert muss über das Firebase SDK abgerufen werden. |
|
string |
Erforderlich. Kennzeichnet eine Nutzerinstanz eines Webclients eindeutig. Weitere Informationen finden Sie unter Ereignis an das Measurement Protocol senden. |
|
string |
Optional. Eine eindeutige Kennung für einen Nutzer. Weitere Informationen zu dieser ID finden Sie unter User-ID für plattformübergreifende Analysen. |
|
number |
Optional. Ein Unix-Zeitstempel (in Mikrosekunden) für die Zeit, die dem Ereignis zugeordnet werden soll. Diese sollte nur so eingestellt werden, dass Ereignisse aufgezeichnet werden, die in der Vergangenheit stattgefunden haben. Dieser Wert kann über |
|
object |
Optional. Die Nutzereigenschaften für die Messung. Weitere Informationen finden Sie unter Nutzereigenschaften. |
|
object |
Optional. Legt die Einwilligungseinstellungen für die Anfrage fest. Weitere Informationen finden Sie im Abschnitt „Einwilligung“. |
|
boolean |
Optional. Legen Sie true fest, um anzugeben, dass die Daten des Nutzers nicht für personalisierte Werbung verwendet werden sollen.
|
|
array |
Erforderlich. Array mit Ereigniselementen Pro Anfrage können bis zu 25 Ereignisse gesendet werden. Alle gültigen Ereignisse finden Sie in der Ereignisreferenz. |
|
string |
Erforderlich. Der Name des Ereignisses. In der Ereignisreferenz finden Sie alle Optionen. |
|
object |
Optional. Die Parameter für das Ereignis. Unter Ereignisse finden Sie die empfohlenen Parameter für jedes Ereignis. |
Einwilligung
Mit dem Attribut consent
werden die Arten und Status von Einwilligungen konfiguriert.
Wenn Sie consent
nicht angeben, verwendet Google Analytics die Einwilligungseinstellungen der entsprechenden Onlineinteraktionen für den Client oder die App-Instanz.
Schlüssel | Typ | Beschreibung |
---|---|---|
|
string |
Optional. Legt die Einwilligung für das Senden von Nutzerdaten aus den Ereignissen und Nutzereigenschaften der Anfrage zu Werbezwecken an Google fest. Muss entweder |
|
string |
Optional. Legt die Einwilligung für personalisierte Anzeigen für den Nutzer fest. Muss entweder |
Benutzerdefinierte Parameter
Zusätzlich zu den vorgeschriebenen Parametern können Sie in eine Measurement Protocol-Nutzlast benutzerdefinierte Parameter auf Nutzer-, Ereignis- und Artikelebene aufnehmen.
- Benutzerdefinierte Parameter auf Nutzerebene können in das
user_properties
-Objekt der Nutzlast aufgenommen werden. - Benutzerdefinierte Parameter auf Ereignisebene können in das
events[].params
-Objekt der Nutzlast aufgenommen werden. - Benutzerdefinierte Parameter auf Artikelebene können für jedes Ereignis in das
items
-Array aufgenommen werden.
Empfohlene Werte für bestimmte Ereignisse
Für einige Ereignisse gibt es 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_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
Außerdem dürfen Parameternamen 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_