Measurement Protocol-Ereignisse an Google Analytics senden

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 wird

    Rufen 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 und session_id als Teil von params für event 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 neuen session_id wird jedoch eine neue Sitzung erstellt, ohne session_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.