In diesem Leitfaden wird erläutert, wie Sie Ereignisse von Web- und App-Streams vom Google Analytics Measurement Protocol an einen Google Analytics-Server senden können, um Measurement Protocol-Ereignisse in Ihren Google Analytics-Berichten zu sehen.
Wählen Sie die Plattform aus, die Sie in diesem Leitfaden sehen möchten:
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 generierte API-SECRET.Wenn Sie ein neues Secret erstellen möchten, klicken Sie auf Verwaltung > Datenstreams > Stream auswählen > Measurement Protocol > Erstellen.
firebase_app_id
: Die Firebase-App-ID, die Sie in der Firebase Console unter Projekteinstellungen > Allgemein > Meine Apps > App-ID finden.firebase_app_id
ist nicht dasselbe wieapp_instance_id
. Dasfirebase_app_id
identifiziert Ihre Anwendung, währendapp_instance_id
eine einzelne Installation der Anwendung identifiziert.
Die vollständige Referenz finden Sie unter Abfrageparameter.
Der Anfragetext muss Folgendes enthalten:
app_instance_id
: Eine eindeutige Kennung für eine Firebase-App-Instanz. Dies unterscheidet sich von einem Web-client_id
:
user_id
: Optional. Eine eindeutige Kennung für einen Nutzer. Darf nur UTF-8-Zeichen enthalten. Weitere Informationen zu dieser ID finden Sie unter User-ID für plattformübergreifende Analysen.consent
: Optional. Informationen zum Festlegen der Einwilligungseinstellungenevents
: ein Array von Ereigniselementen Sie können mehrere Ereignisse in einer Anfrage angeben.Damit Nutzeraktivitäten in Berichten wie Echtzeit angezeigt werden, müssen
engagement_time_msec
undsession_id
als Teil desparams
für einevent
-Objekt angegeben werden. Der Parameterengagement_time_msec
sollte die Interaktionsdauer des Ereignisses in Millisekunden angeben.Beispiel:
{
"app_instance_id": "12345678901234567890123456789012",
"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"
}
}
]
}
session_start
ist zwar ein reservierter Ereignisname. Wenn Sie aber eine neue session_id
erstellen, wird eine neue Sitzung erstellt, ohne dass session_start
gesendet werden muss. Berechnung von Sitzungen
Jetzt testen
Hier sehen Sie ein Beispiel, wie Sie ein tutorial_begin
-Ereignis an Ihren Google Analytics-Server senden können:
const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
Das Format von firebase_app_id
ist plattformspezifisch. Siehe Anwendungs-ID unter Firebase-Konfigurationsdateien und -Objekte.
Beschränkungen
Für das Senden von Measurement Protocol-Ereignissen an Google Analytics gelten folgende Einschränkungen:
- Anfragen dürfen 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, dürfen nur alphanumerische Zeichen und Unterstriche enthalten und müssen mit einem Buchstaben beginnen.
- Parameternamen, einschließlich Artikelparameter, 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 Artikelparameterwerten, dürfen maximal 100 Zeichen lang sein.
- Artikelparameter können maximal 10 benutzerdefinierte Parameter haben.
- Der Post-Text muss kleiner als 130 KB sein.
- Die Attribution auf Ereignisebene aus Measurement Protocol-Ereignissen wird bis zu 63 Tage nach dem letzten Tagging-Onlineereignis für den Conversion-Export nach Google Ads und andere Medienintegrationen unterstützt, auch wenn der Conversion-Tracking-Zeitraum für das Conversion-Ereignis länger als 63 Tage ist. Im Gegensatz dazu wird die Attribution auf Ereignisebene für das Tagging von Onlineereignissen für den gesamten Conversion-Tracking-Zeitraum unterstützt.
- Für Remarketing können Sie Measurement Protocol-Ereignisse mit einem Cookie oder einer Geräte-ID bis zu der folgenden Anzahl von Tagen nach dem letzten Onlineereignis verknüpfen:
- Webstream: 30 Tage
- App-Stream: 42 Tage
- App Measurement Protocol-Ereignisse, die an Google Analytics 4 gesendet werden, werden nicht in Google Ads-Zielgruppen für App-Nutzer erfasst.