In diesem Leitfaden wird erläutert, wie Sie Web- und App-Stream-Ereignisse des Google Analytics Measurement Protocol an einen Google Analytics-Server senden, damit Measurement Protocol-Ereignisse in den Google Analytics-Berichten angezeigt werden.
Wählen Sie die Plattform aus, die in diesem Leitfaden angezeigt werden soll:
Anfrage formatieren
Das Measurement Protocol für Google Analytics 4 unterstützt nur HTTP-POST
-Anfragen.
Verwenden Sie das folgende Format, um ein Ereignis zu senden:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
Die Anfrage-URL muss Folgendes enthalten:
api_secret
: Das API-GEHEIM, das in der Google Analytics-Benutzeroberfläche generiert wirdRufen Sie Verwaltung > Datenstreams > Stream auswählen > Measurement Protocol > Erstellen auf, um ein neues Secret zu erstellen.
measurement_id
: Die Mess-ID, die mit einem Stream verknüpft ist. Sie finden sie in der Google Analytics-Benutzeroberfläche unter Verwaltung > Datenstreams > Stream auswählen > Mess-ID.measurement_id
ist nicht deine Stream-ID.
Die vollständige Referenz finden Sie unter Suchparameter.
Im Anfragetext müssen Sie Folgendes angeben:
client_id
: Eine eindeutige Kennung für einen Client. Dies unterscheidet sich von einem Firebase-app_instance_id
. Verwenden Sie gtag.js('get').
user_id
: Optional. Eine eindeutige Kennung für einen Nutzer. Darf nur utf-8-Zeichen enthalten. Weitere Informationen zu dieser Kennung finden Sie unter User-ID für plattformübergreifende Analysen.events
: ein Array von Ereigniselementen. Eine Anfrage kann mehrere Ereignisse umfassen.Damit Nutzeraktivitäten in Berichten wie Echtzeit angezeigt werden, müssen
engagement_time_msec
undsession_id
als Teil vonparams
fürevent
angegeben 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 neuensession_id
wird jedoch eine neue Sitzung erstellt, ohnesession_start
zu senden. Anzahl der Sitzungen zählen
Ausprobieren
Hier sehen Sie ein Beispiel, wie Sie ein tutorial_begin
-Ereignis an Ihren Google Analytics-Server senden können:
const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
client_id: 'XXXXXXXXXX.YYYYYYYYYY',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
Beschränkungen
Das Senden von Measurement Protocol-Ereignissen an Google Analytics hat folgende Einschränkungen:
- Anfragen können maximal 25 Ereignisse enthalten.
- 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 mit Artikelparametern dürfen maximal 40 Zeichen lang sein und nur alphanumerische Zeichen und Unterstriche enthalten. Außerdem müssen sie mit einem Buchstaben beginnen.
- Parameterwerte einschließlich Artikelparameterwerten dürfen maximal 100 Zeichen enthalten.
- Artikelparameter dürfen maximal 10 benutzerdefinierte Parameter enthalten.
- Der Post-Text muss kleiner als 130 KB sein.