Übersicht
Das Senden von Daten an Google Analytics mithilfe des Measurement Protocol besteht aus zwei Teilen:
- Transport – Wo und wie Daten gesendet werden
- 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>
Der
BODY
der Anfrage. Siehe Nutzlast.
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:
- Abfrageparameter
- Ein
JSON
-POST
-Text
Suchparameter
Parametername | Beschreibung |
---|---|
|
Erforderlich. Ein
Wenn Sie ein neues Secret erstellen möchten, gehen Sie in der Google Analytics-Benutzeroberfläche zu:
Wir empfehlen Ihnen, diese Informationen auf Ihre Organisation zu beschränken. Wenn Sie das Measurement Protocol auf Clientseite 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 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 |
---|---|---|
|
string |
Erforderlich. Kennzeichnet eine bestimmte Installation einer Firebase-App eindeutig. Dieser Wert muss über das Firebase SDK abgerufen werden. |
|
string |
Erforderlich. Kennzeichnet eindeutig eine Nutzerinstanz eines Webclients. Siehe Ereignis an Measurement Protocol senden. |
|
string |
Optional. Eine eindeutige Kennung für einen Nutzer. Weitere Informationen zu dieser ID finden Sie unter Nutzer-ID für plattformübergreifende Analysen. |
|
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 |
|
object |
Optional. Die Nutzereigenschaften für die Messung. Weitere Informationen finden Sie unter Nutzereigenschaften. |
|
boolean |
Optional. Legen Sie true fest, wenn diese Ereignisse nicht für personalisierte Anzeigen verwendet werden sollen.
|
|
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. |
|
string |
Erforderlich. Der Name des Ereignisses. In der Referenz zu Ereignissen finden Sie alle Optionen. |
|
object |
Optional. Die Parameter für das Ereignis. Die vorgeschlagenen Parameter für jedes Ereignis finden Sie unter Ereignisse. |
Empfohlene Werte für bestimmte 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_