Measurement Protocol-Ereignisse an Google Analytics senden

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.

  • 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.

    Die measurement_id ist nicht deine Stream-ID.

Die vollständige Referenz finden Sie unter Abfrageparameter.

Der Anfragetext muss Folgendes enthalten:

  • 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 ID finden Sie unter User-ID für plattformübergreifende Analysen.

  • consent: Optional. Informationen zum Festlegen der Einwilligungseinstellungen

  • events: 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 und session_id als Teil des params für ein event-Objekt angegeben werden. Der Parameter engagement_time_msec sollte die Interaktionsdauer des Ereignisses in Millisekunden angeben.

    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"
        }
     }
   ]
  }

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 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 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.