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
  • Eine beliebige IDE zum Vornehmen von Änderungen
  • GA4-Konto
  • Optional: Python-Entwicklungsumgebung (oder Colab)

2. Pflichtfelder erfassen

API-Secret in GA4 erstellen

Erstellen Sie in GA4 ein neues API-Secret. Klicken Sie dazu auf „Verwaltung“ > „Datenstreams“ > „Stream auswählen“ > „Measurement Protocol“ > „Erstellen“.

8dee89e850ae90bb.pngd0be19d8112435a2.pngde5a80a1445d3a14.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

Füllen Sie die folgenden Felder aus:

  • 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.
  • Die 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 einem Button zum Validieren des Ereignisses:

31f720d550906298.png

Klicken Sie dann auf den orangefarbenen Button „Ereignis validieren“. Es sollte die Meldung unten angezeigt werden, die besagt, dass das Ereignis gültig ist. Außerdem sollte ein Button 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 den Button. 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 in 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-Tool zur Ereigniserstellung 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 Folgendes gelernt:

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

Referenzdokumente