Übersicht
Das Senden von Daten an Google Analytics mit dem Messwert „Messung“ erfolgt in zwei Schritten. Protokoll:
- Die Übertragung – wohin und wie Sie Daten senden
- Nutzlast: die Daten, die Sie senden
In diesem Dokument wird beschrieben, wie Transport und Nutzlast formatiert werden.
Transport
URL-Endpunkt
Sie senden Daten mithilfe des Measurement Protocol, indem 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>
Die
BODY
der Anfrage. Siehe Nutzlast.
Antwortcodes
Das Measurement Protocol gibt immer den Statuscode 2xx
zurück, wenn die HTTP
Anfrage ist eingegangen. Das Measurement Protocol gibt keinen Fehlercode zurück, wenn
waren die Nutzlastdaten fehlerhaft oder die Daten in der Nutzlast waren falsch oder
nicht von Google Analytics verarbeitet.
Nutzlast
Die Daten werden in zwei Wochen mithilfe des Measurement Protocol an Google Analytics gesendet. Teile:
- Abfrageparameter
- Einen
JSON
-POST
-Text
Suchparameter
Parametername | Beschreibung |
---|---|
|
Erforderlich. Ein
So erstellen Sie ein neues Secret in der Google Analytics-Benutzeroberfläche:
Wir empfehlen, diese auf Ihre Organisation zu beschränken. Wenn
stellen Sie das Measurement Protocol auf Clientseite bereit,
Rotieren Sie regelmäßig |
|
Erforderlich. Firebase-App-ID. Die ID für eine Firebase-App.
Diese finden Sie in der Firebase Console unter:
Projekteinstellungen > Allgemein > Meine Apps > App-ID |
JSON-Beitragstext
Schlüssel | Typ | Beschreibung |
---|---|---|
|
string |
Erforderlich. Kennzeichnet eindeutig eine bestimmte Installation eines Firebase App. Dieser Wert muss über die Firebase- SDK.
|
|
string |
Optional. Eine eindeutige Kennung für einen Nutzer. Siehe User-ID für plattformübergreifende Analyse. <ph type="x-smartling-placeholder"> |
|
number |
Optional. Ein Unix-Zeitstempel (in Mikrosekunden) für die zu verknüpfende Zeit
mit dem Ereignis. Diese Option sollte nur festgelegt werden, um Ereignisse aufzuzeichnen, die stattgefunden haben
in der Vergangenheit liegen. Dieser Wert kann überschrieben werden durch
|
|
object |
Optional. Die Nutzereigenschaften für die Messung. Siehe Nutzer . |
|
object |
Optional. Legt die Einwilligungseinstellungen für die Anfrage fest. Weitere Informationen finden Sie im Abschnitt zur Einwilligung. |
|
boolean |
Optional. Legen Sie true fest, um anzugeben, dass die Daten des Nutzers nicht
für personalisierte Anzeigen verwendet werden.
<ph type="x-smartling-placeholder">
|
|
array |
Erforderlich. Ein Array von Ereigniselementen. Pro können bis zu 25 Ereignisse gesendet werden. Veranstaltungen ansehen Referenz für alle gültigen Ereignisse. |
|
string |
Erforderlich. Der Name des Ereignisses. Veranstaltungen ansehen für alle Optionen. |
|
object |
Optional. Die Parameter für das Ereignis. Ereignisse ansehen für die vorgeschlagenen Parameter für jedes Ereignis. |
Einwilligung
Mit dem Attribut consent
werden Einwilligungsarten und -status konfiguriert.
Wenn Sie consent
nicht angeben, verwendet Google Analytics die Einwilligung
Einstellungen aus den entsprechenden Onlineinteraktionen für den Client oder die App-Instanz.
Schlüssel | Typ | Beschreibung |
---|---|---|
|
string |
Optional. Legt die Einwilligung zum Senden von Nutzerdaten aus dem zu Werbezwecken an Google senden. 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 benutzerdefiniert auf Nutzer-, Ereignis- und Artikelebene Parameter in einer Measurement Protocol-Nutzlast.
- Benutzerdefinierte Parameter auf Nutzerebene können in das
user_properties
-Objekt der Nutzlast aufgenommen werden. - Benutzerdefinierte Parameter auf Ereignisebene können in
events[].params
aufgenommen werden. -Objekt der Nutzlast. - Benutzerdefinierte Parameter auf Artikelebene können in den
items
-Array für jedes Ereignis.
Empfohlene Werte für bestimmte Ereignisse
Für einige Ereignisse sind empfohlene Parameter vorhanden. Unter diesem Link finden Sie die empfohlenen Ereignisse. Parameter für alle unterstützten 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_