Webereignisse über das Measurement Protocol an GA4 senden

1. Einführung

Zuletzt aktualisiert: 30.04.2019

Umfang

  • In diesem Codelab erfahren Sie, wie Sie externe Ereignisse über das Measurement Protocol an GA4 senden.
  • In diesem Codelab wird davon ausgegangen, dass Sie bereits eine Webseite oder Website mit Google Analytics 4 haben.

Lerninhalte

  • Anleitung: Ihr erster Aufruf für das Measurement Protocol
  • Informationen zu den Parameter, die beim Aufruf erforderlich sind
  • Testaufruf senden und validieren
  • Beispielskript in Python erstellen, um den Aufruf auszuführen

Voraussetzungen

  • Eine Website/Webseite
  • Beliebige IDE zum Vornehmen von Änderungen
  • GA4-Konto
  • Optional: Python-Entwicklungsumgebung (oder Colab)

2. Pflichtfelder erfassen

API-Secret in GA4 erstellen

Rufen Sie GA4 auf und erstellen Sie Ihr neues API-Secret unter „Verwaltung“ > „Datenstreams“ > „Stream auswählen“ > „Measurement Protocol“ > „Erstellen“.

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Sie können einen beliebigen Alias angeben. Der Secret-Wert wird angezeigt und kann für den Aufruf verwendet werden.

client_id erfassen

Sie können eine der folgenden Methoden verwenden, um Ihre client_id zu erfassen.

  1. Erhebung über gtag

Beide werden im Folgenden ausführlich erläutert.

Erhebung über gTag

Sie können Ihre client_id über Ihre Website abrufen :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

Unten finden Sie weitere Links, die von Ihrer Infrastruktur abhängen.

3. Anruf erstellen

Mit dem Tool zur Ereigniserstellung in GA4 können Sie einen Beispielaufruf generieren. Hierfür müssen Sie sich anmelden und Cookies aktiviert haben. Der Umschalter muss auf „gtag.js“ eingestellt sein.

b904d2a053eb7817.png

Sie müssen die folgenden Felder ausfüllen:

  • api_secret: wurde bereits in GA4 erstellt
  • measurement_id: Sie finden diese ID unter „Verwaltung“ > „Datenstreams“ > „Stream auswählen“. Es sollte wie unten dargestellt angezeigt werden.

d362992ff592c675.png

  • client_id: Sie haben diesen Wert bereits abgerufen.
  • „user_id“ ist nicht obligatorisch. Sie können es vorerst leer lassen.
  • Kategorie: Ändern Sie diese im Drop-down-Menü in „Benutzerdefiniert“ und geben Sie einen beliebigen Ereignisnamen ein (verwenden Sie keine automatisch erfassten Ereignisse). Hier verwenden wir „test_from_codelab“.

cf580a708bb0a8a2.png

Optional können Sie auch Ereignisparameter und/oder Nutzereigenschaften angeben, indem Sie auf die Schaltflächen unten klicken.

da59bb982f6f906a.png

Wenn Sie alles ausgefüllt haben, sollte in etwa Folgendes angezeigt werden, mit einer Schaltfläche zum Validieren des Ereignisses:

31f720d550906298.png

Klicken Sie dann auf die orangefarben hervorgehobene Schaltfläche „EVENT VALIDIEREN“. Es sollte die Meldung unten angezeigt werden, die besagt, dass das Ereignis gültig ist. Außerdem sollte eine Schaltfläche zum Senden an Google Analytics zu sehen sein. Wenn das Ereignis an dieser Stelle als ungültig angezeigt wird, teilt Ihnen das Tool das genaue Feld mit, in dem ein Problem vorliegt. Sie können das Problem beheben und es noch einmal versuchen.

1d63d1e067c46294.png

Klicken Sie jetzt auf die Schaltfläche. Dadurch sollte ein Testlauf an GA4 gesendet werden.

4. Ereignisse in GA4 validieren

Nachdem Sie das Ereignis gesendet haben, können Sie in Ihrem GA4-Konto den Echtzeitbericht aufrufen. Das Ereignis sollte angezeigt werden.

7b9e9a0f74b64757.png

Es kann etwa 24 Stunden dauern, bis die Ereignisse von der Echtzeitansicht auf den Tab „Berichte“ übertragen werden. Sie müssen sich also keine Sorgen machen, wenn Sie sie nicht sofort in den regulären Ereignisberichten sehen.

5. Python-Script erstellen

Nachdem Sie die Funktion getestet haben, können Sie sich den API-Aufruf und die Ereignisnutzlast ansehen, um eine ähnliche Architektur in Python (oder einer beliebigen anderen Sprache) zu erstellen, mit der dieser Aufruf ausgeführt werden kann. Anschließend können Sie die Ausführung mit der gewünschten Häufigkeit planen und operationalisieren. Für diesen Teil können Sie entweder eine beliebige IDE Ihrer Wahl verwenden, die Python unterstützt, oder einfach ein Google Colab-Notebook, für das keine Installation auf Ihrem Gerät erforderlich ist.

Wenn Sie zum GA4-Ereignis-Builder zurückkehren, sehen Sie, dass der Endpunkt wie unten angegeben ist.

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

Die Ereignisnutzlast war wie unten angegeben.

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

Sie können dies in Python so übersetzen:

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

Wenn Sie diesen Befehl mit den richtigen Werten ausführen, sollte das Ereignis in GA4 in Echtzeit angezeigt werden.

6. Glückwunsch

Das wars! Sie haben das Measurement Protocol in GA4 erfolgreich verwendet. Sie können jetzt leistungsstarke Lösungsarchitekturen erstellen, um aussagekräftigere Daten an Google Analytics zu senden und Ihre Marketing- und Unternehmensanalysen zu verbessern. Damit Sie diese Funktion optimal nutzen können, empfehlen wir Ihnen, eine Verbindung zu Google Ads herzustellen und diese Ereignisse als Conversions zu importieren.

Sie haben gelernt,

  • Die richtigen Variablen für MP-Aufrufe erfassen
  • Testereignisse senden und validieren
  • Script zum Senden von MP-Anrufen erstellen

Referenzdokumente