Ereignisse werden gesendet

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

In diesem Leitfaden wird erläutert, wie Anfragen formatiert und an das Google Analytics Measurement Protocol gesendet werden.

Ereignisse werden gesendet

Senden Sie eine HTTP-POST-Anfrage an den folgenden Endpunkt, um ein Ereignis zu senden:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Erforderliche Parameter

Für eine gültige Anfrage sind zwei Gruppen von Parametern erforderlich, die variieren, wenn Sie Firebase oder gtag.js verwenden:

  1. URL-Parameter

    • api_secret: Erforderlich. Ein API SECRET, der in der Google Analytics-UI generiert wird. Rufen Sie zum Erstellen eines neuen Secrets Folgendes auf:
      Admin > Datenstreams > Stream auswählen > Measurement Protocol > Erstellen

    Eine vollständige Referenz finden Sie unter Abfrageparameter.

  2. JSON-Text

    • user_id (optional): Eine eindeutige Kennung für einen Nutzer. Weitere Informationen zu dieser Kennung finden Sie unter User-ID für plattformübergreifende Analysen.

    • events: Erforderlich. Ein Array von Ereigniselementen.

    Eine vollständige Referenz finden Sie unter JSON POST BODY.

Damit Nutzeraktivitäten in Standardberichten wie Echtzeit angezeigt werden, müssen engagement_time_msec und session_id als Teil von params für event bereitgestellt 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 dass session_start gesendet werden muss.

Ereignis senden

Stellen Sie die folgende Anfrage, um ein tutorial_begin-Ereignis zu senden:

Beschränkungen

  • Anfragen können 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 und nur alphanumerische Zeichen und Unterstriche enthalten. Außerdem müssen sie mit einem Buchstaben beginnen.
  • Parameternamen (einschließlich „item“-Parameter) 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 Artikelparameterwerte) dürfen maximal 100 Zeichen lang sein.
  • Für „item“-Parameter sind maximal zehn benutzerdefinierte Parameter zulässig.
  • Der Post-Text muss kleiner als 130 KB sein.