Übersicht
In diesem Leitfaden wird erläutert, wie Anfragen formatiert und an das Google Analytics Measurement Protocol gesendet werden.
Ereignisse werden gesendet
Senden Sie eine HTTP
-POST
-Anfrage an den folgenden Endpunkt, um ein Ereignis zu senden:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
Erforderliche Parameter
Für eine gültige Anfrage sind zwei Gruppen von Parametern erforderlich, die variieren, wenn Sie Firebase oder gtag.js verwenden:
URL-Parameter
api_secret
: Erforderlich. EinAPI SECRET
, der in der Google Analytics-UI generiert wird. Rufen Sie zum Erstellen eines neuen Secrets Folgendes auf:
Admin > Datenstreams > Stream auswählen > Measurement Protocol > Erstellen
Eine vollständige Referenz finden Sie unter Abfrageparameter.
JSON-Text
user_id
(optional): Eine eindeutige Kennung für einen Nutzer. Weitere Informationen zu dieser Kennung finden Sie unter User-ID für plattformübergreifende Analysen.events
: Erforderlich. Ein Array von Ereigniselementen.
Eine vollständige Referenz finden Sie unter JSON POST BODY.
Empfohlene Parameter für Berichte
Damit Nutzeraktivitäten in Standardberichten wie Echtzeit angezeigt werden, müssen engagement_time_msec
und session_id
als Teil von params
für event
bereitgestellt werden.
Beispiel:
{
"client_id": "x",
"events": [
{
"name": "offline_purchase",
"params": {
"engagement_time_msec": "100",
"session_id": "123"
}
}
]
}
session_start
ist zwar ein reservierter Ereignisname, beim Erstellen eines neuen session_id
wird jedoch eine neue Sitzung erstellt, ohne dass session_start
gesendet werden muss.
Ereignis senden
Stellen Sie die folgende Anfrage, um ein tutorial_begin
-Ereignis zu senden:
Beschränkungen
- Anfragen können maximal 25 Ereignisse haben.
- Ereignisse dürfen maximal 25 Parameter haben.
- Ereignisse dürfen maximal 25 Nutzereigenschaften haben.
- Namen von Nutzereigenschaften dürfen maximal 24 Zeichen lang sein.
- Werte von Nutzereigenschaften dürfen maximal 36 Zeichen umfassen.
- Ereignisnamen dürfen maximal 40 Zeichen lang sein und nur alphanumerische Zeichen und Unterstriche enthalten. Außerdem müssen sie mit einem Buchstaben beginnen.
- Parameternamen (einschließlich „item“-Parameter) dürfen maximal 40 Zeichen lang sein, dürfen nur alphanumerische Zeichen und Unterstriche enthalten und müssen mit einem Buchstaben beginnen.
- Parameterwerte (einschließlich Artikelparameterwerte) dürfen maximal 100 Zeichen lang sein.
- Für „item“-Parameter sind maximal zehn benutzerdefinierte Parameter zulässig.
- Der Post-Text muss kleiner als 130 KB sein.