Webereignisse über das Measurement Protocol an GA4 senden

1. Einführung

Zuletzt aktualisiert:30.04.2019

Inhalt

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

Aufgaben in diesem Lab

  • Schritte für deinen ersten MP-Anruf
  • Informationen zu den für den Aufruf erforderlichen Parametern
  • Testanruf senden und validieren
  • Beispielskript in Python erstellen, um den Aufruf auszuführen

Voraussetzungen

  • Eine Website/Webseite
  • Änderungen in einer beliebigen IDE
  • GA4-Konto
  • Optional – Python-Entwicklungsumgebung (oder Colab)

2. Pflichtfelder erfassen

API-Secret in GA4 erstellen

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

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

Sie können einen beliebigen Alias angeben und der Secret-Wert wird angezeigt, den Sie in Ihrem Anruf verwenden können

Client-ID erfassen

Sie können eine der folgenden Methoden verwenden, um Ihre Client-ID zu erfassen.

  1. Daten werden über gTag erhoben

Beide Optionen werden unten ausführlich erläutert.

Datenerfassung über gTag

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

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

Abhängig von Ihrer Infrastruktur finden Sie unten weitere Links

3. Aufbau des Aufrufs

Mit dem Event Builder können Sie in GA4 einen Beispielaufruf erstellen. Dazu müssen Sie sich anmelden und Cookies aktivieren. Die Ein/Aus-Schaltfläche muss auf „gtag.js“ gesetzt sein.

b904d2a053eb7817.png

Füllen Sie die folgenden Felder aus:

  • api_secret – Bereits in GA4 erstellt
  • Messungs-ID: Diese ID finden Sie unter „Verwaltung“ > Datenstreams > und wähle deinen Stream aus . Sie sollte wie folgt angezeigt werden:

d362992ff592c675.png

  • client_id: Sie haben diesen Wert bereits abgerufen.
  • user_id ist nicht erforderlich. Sie können das Feld vorerst leer lassen
  • Kategorie: in "Benutzerdefiniert" ändern aus und geben Sie einen beliebigen Ereignisnamen ein. Verwenden Sie kein automatisch erfasstes Ereignis. 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: die Schaltfläche „Ereignis validieren“.

71f120d550906298.png

Wenn Sie diesen Punkt erreicht haben, klicken Sie auf „EREIGNIS ÜBERPRÜFEN“. , die orange markierte Schaltfläche. Es sollte die unten stehende Meldung angezeigt werden, in der angegeben wird, dass das Ereignis gültig ist, und die Schaltfläche SEND TO GA (An Google Analytics senden) wird angezeigt. Wenn das Ereignis als ungültig eingestuft wird, teilt Ihnen das Tool das genaue Feld mit, in dem das Problem vorliegt, und Sie können es beheben und es noch einmal versuchen.

1d63d1e067c46294.png

Wenn Sie auf die Schaltfläche klicken, sollte ein Testereignis an GA4 gesendet werden.

4. Ereignisse in GA4 validieren

Nachdem Sie das Ereignis gesendet haben, können Sie Ihr GA4-Konto aufrufen und sich den Echtzeitbericht ansehen. Sie sollten sehen, dass das Ereignis über

7b9e9a0f74b64757.png

Es kann bis zu 24 Stunden dauern, bis die Ereignisse aus der Echtzeitansicht auf den Tab mit den Berichten zu Ereignissen übertragen werden. Es besteht also kein Grund zur Sorge, wenn dies nicht sofort in den normalen Ereignisberichten zu sehen ist.

5. Python-Skript erstellen

Nachdem Sie die Methode getestet haben, können Sie den API-Aufruf und die Ereignisnutzlast untersuchen, um eine ähnliche Architektur in Python (oder in einer beliebigen Sprache Ihrer Wahl) zu erstellen, die diesen Aufruf ausführen kann. Anschließend können Sie dies wie gewünscht planen und operationalisieren. Für diesen Teil können Sie entweder eine IDE Ihrer Wahl verwenden, die Python unterstützt, oder einfach ein Google Colab-Notebook verwenden, für das keine Installation auf Ihrem Gerät erforderlich ist.

In GA4 Event Builder sehen Sie folgenden Endpunkt:

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

Mit etwas wie diesem können Sie dies in Python ü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 dies mit den richtigen Werten ausführen, sollte das Ereignis in GA4 in Echtzeit angezeigt werden.

6. Glückwunsch

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 so Ihre Marketing- und Geschäftsanalysen zu verbessern. Damit Sie optimal davon profitieren, sollten Sie eine Verbindung mit Google Ads herstellen und diese Ereignisse als Conversions importieren.

Sie haben gelernt,

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

Referenzdokumente