In diesem Leitfaden wird erläutert, wie Sie Ereignisse für Web- und App-Streams von Google Analytics Measurement Protocol an einen Google Analytics-Server senden, um Measurement Protocol-Ereignisse in Ihren Google Analytics-Berichten zu sehen.
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>
In der Anfrage-URL müssen Sie Folgendes angeben:
api_secret
: Das in der Google Analytics-Benutzeroberfläche erstellte API-GEHEIM.Um ein neues Secret zu erstellen, gehen Sie zu Verwaltung > Datenstreams > Stream auswählen > Measurement Protocol > Erstellen.
measurement_id
: Die mit einem Stream verknüpfte Mess-ID. 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 Abfrageparameter.
Im Anfragetext müssen Sie Folgendes angeben:
client_id
: Eine eindeutige Kennung für einen Client. Dies unterscheidet sich von einerapp_instance_id
von Firebase. 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.consent
: Optional. Weitere Informationen zum Festlegen der Einwilligungseinstellungenevents
: ein Array von Ereigniselementen. Sie können mehrere Ereignisse in eine Anfrage aufnehmen.Damit Nutzeraktivitäten in Berichten wie Echtzeit,
engagement_time_msec
undsession_id
angezeigt werden, müssen Sie sie imparams
fürevent
angeben. Der Parameterengagement_time_msec
sollte die Interaktionsdauer des Ereignisses in Millisekunden widerspiegeln.Beispiel:
{
"client_id": "123456.7654321",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
Während session_start
ein reservierter Ereignisname ist, wird durch das Erstellen einer neuen session_id
eine neue Sitzung erstellt, ohne dass session_start
gesendet werden muss. Informieren Sie sich darüber, wie Sitzungen gezählt werden.
Jetzt testen
Hier ist 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
Für das Senden von Measurement Protocol-Ereignissen an Google Analytics gelten die folgenden Einschränkungen:
- Anfragen können maximal 25 Ereignisse umfassen.
- 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, die Artikelparameterwerte enthalten, dürfen in einer Google Analytics 4-Standard-Property maximal 100 Zeichen lang sein. Bei einer Google Analytics 360-Property dürfen sie maximal 500 Zeichen lang sein.
- Artikelparameter dürfen maximal zehn benutzerdefinierte Parameter haben.
- Der Post-Text muss kleiner als 130 KB sein.
- Die Attribution auf Ereignisebene von Measurement Protocol-Ereignissen wird bis zu 63 Tage nach dem letzten Tagging-Onlineereignis für den Conversion-Export in Google Ads und andere Medienintegrationen unterstützt, selbst wenn der Conversion-Tracking-Zeitraum für das Conversion-Ereignis länger als 63 Tage ist. Im Gegensatz dazu wird die Attribution auf Ereignisebene zum Taggen von Onlineereignissen für den gesamten Conversion-Tracking-Zeitraum unterstützt.
- Zu Remarketing-Zwecken können Sie Measurement Protocol-Ereignisse bis zu der folgenden Anzahl von Tagen nach dem letzten Onlineereignis mit einem zugehörigen Cookie oder einer zugehörigen Geräte-ID zusammenführen:
- Webstream: 30 Tage
- App-Stream: 42 Tage
- App Measurement Protocol-Ereignisse, die an Google Analytics 4 gesendet werden, werden nicht als Zielgruppen für Suchkampagnen in Google Ads für App-Nutzer erfasst.