In diesem Artikel werden die verschiedenen Möglichkeiten zum Senden von Ereignissen an einen serverseitigen Container beschrieben. Weitere Informationen finden Sie unter Funktionsweise des serverseitigen Taggings.
In diesem Artikel erfahren Sie, wie Sie Folgendes tun:
- Daten von einer Website an Ihren serverseitigen Container senden
- Zusätzliche Daten an einen Servercontainer senden
- Daten in Ihrem serverseitigen Container empfangen
- Daten von anderen Quellen als Websites senden
Hinweis
In diesem Leitfaden wird Folgendes vorausgesetzt:
1. Daten von einer Website an den serverseitigen Container senden
Sie können Daten über eine serverseitige Implementierung über Tag Manager oder gtag.js weiterleiten. Wählen Sie die gewünschte Implementierungsoption aus.
Wenn Sie ein Google-Tag für die serverseitige Verarbeitung einrichten möchten, müssen Sie die URL Ihres Servercontainers hinzufügen.
Konfigurationsvariable für die Servercontainer-URL erstellen
Wählen Sie den Webcontainer aus, den Sie konfigurieren möchten.
Öffnen Sie das Menü Variablen.
Wählen Sie Neu aus, um eine benutzerdefinierte Variable vom Typ Google-Tag: Konfigurationseinstellungen zu erstellen.
Fügen Sie die folgenden Parameter hinzu:
- Name:
server_container_url
- Wert: Geben Sie hier die Servercontainer-URL Ihres Tag Manager-Servercontainers an.
- Name:
Geben Sie der Variablen einen Namen, z. B. „Server-URL“, und speichern Sie sie.
Servercontainer-URL einem Google-Tag zuweisen
- Öffnen Sie das Menü
Tags.
- Fügen Sie ein neues Google-Tag hinzu oder bearbeiten Sie ein vorhandenes.
- Wählen Sie unter Konfigurationseinstellungen die Servercontainervariable aus, die Sie gerade erstellt haben.
- Damit das Google-Tag vor anderen Triggern ausgelöst wird, klicken Sie auf Trigger und verwenden Sie den Trigger Initialisierung – Alle Seiten. Weitere Informationen zu Seiten-Triggern
- Klicken Sie auf Speichern, um das Tag zu speichern, und auf Veröffentlichen, um den Container zu veröffentlichen.
Optional: Zusätzliche Parameter mit jedem Ereignis senden
Sie können zwei weitere Arten von Parametern senden: Parameter auf Konfigurationsebene und Parameter auf Ereignisebene. Konfigurationsparameter wirken sich auf das Verhalten Ihres Google-Tags aus und können nur auf Google-Tag-Ebene festgelegt werden.
Ereignisparameter geben zusätzliche Informationen zu einem Ereignis an und können für alle Ereignisse, ausgewählte Ereignisse oder page_view
-Ereignisse festgelegt werden.
Weitere Informationen zur Wiederverwendung von Konfigurationseinstellungen in Google Tag Manager
Wenn Sie zusätzliche Parameter für alle Ereignisse senden möchten, verwenden Sie die Ereigniseinstellungen in Google Tag Manager wieder.
So senden Sie zusätzliche Parameter mit einem Google Analytics 4-Ereignis:
- Fügen Sie in einem Webcontainer ein Google Analytics 4-Ereignis-Tag hinzu oder bearbeiten Sie ein vorhandenes.
- Klicken Sie auf Ereignisparameter > Zeile hinzufügen.
- Fügen Sie den Parameter hinzu, der mit dem Ereignis gesendet werden soll. Vordefinierte Ereignisparameter finden Sie in der Referenz zu empfohlenen Ereignissen.
- Fügen Sie unter Feldname den Namen des Parameters hinzu, z. B.
language
. - Geben Sie unter Wert den Wert Ihres Parameters ein.
- Fügen Sie unter Feldname den Namen des Parameters hinzu, z. B.
- Konfigurieren Sie einen Trigger, der bei Initialisierung – Alle Seiten ausgelöst wird.
- Klicken Sie auf Speichern, um das Tag zu speichern, und auf Veröffentlichen, um den Container zu veröffentlichen.
So senden Sie einen Parameter für ein page_view
-Ereignis:
- Bearbeiten Sie in einem Webcontainer ein vorhandenes Google-Tag.
Deaktivieren Sie die Standard-
page_view
in den Konfigurationseinstellungen, indem Sie einen neuen Parameter hinzufügen:- Name:
send_page_view
- Wert:
false
- Name:
Erstellen Sie ein neues Tag vom Typ Google Analytics: GA4-Ereignis.
- Wählen Sie das Konfigurations-Tag aus, das Sie in Schritt 1 geändert haben.
- Legen Sie als Ereignisname
page_view
fest.
Fügen Sie den Parameter hinzu, der mit dem Ereignis gesendet werden soll. Vordefinierte Ereignisparameter finden Sie in der Referenz zu empfohlenen Ereignissen. – Geben Sie unter Feldname den Namen des Parameters ein, z. B.
language
.- Geben Sie unter Wert den Wert Ihres Parameters ein.
- Konfigurieren Sie einen Trigger, der bei Initialisierung – Alle Seiten ausgelöst wird.
- Klicken Sie auf Speichern, um das Tag zu speichern, und auf Veröffentlichen, um den Container zu veröffentlichen.
2. Daten in Ihrem serverseitigen Container empfangen
Wenn Sie eine HTTP-Anfrage an einen Servercontainer senden, muss ein Client diese Anfrage beanspruchen.
So rufen Sie eine Liste der verfügbaren Kunden auf:
Öffnen Sie den Servercontainer.
Klicken Sie in der Navigationsleiste links auf Kunden. Der GA4-Client ist standardmäßig in Ihrem serverseitigen Container vorinstalliert.
Klicken Sie auf den Namen des Kunden, um Details aufzurufen oder zu bearbeiten.
Optionale Clienteinstellungen
In den meisten Fällen sind für den Kunden keine Änderungen erforderlich. Ihr Anwendungsfall kann jedoch anders sein und Sie möchten eine der folgenden Einstellungen bearbeiten:
Priorität:Bestimmt die Reihenfolge, in der Clients ausgeführt werden. Diejenigen mit den höheren Nummern haben Vorrang. Der erste Client, der der eingehenden Anfrage entspricht, wird zum aktiven Client für diese Anfrage.
Aktivierungskriterien:Mit den Aktivierungskriterien wird festgelegt, wann der Client auf Anfragen antwortet:
- gtag.js-Standardpfade für bestimmte IDs:Mit dieser Einstellung können Sie die JavaScript-Bereitstellung für das gtag.js-Tag über die Servercontainer-URL aktivieren. Wenn Sie das Kästchen anklicken, wird dieser Client aufgrund von Anfragen an die gtag.js-Standardanfragepfade aktiviert. Beispiel:
/gtag/js?id=TAG_ID
. Klicken Sie auf Mess-ID hinzufügen, um eine oder mehrere Ziel-IDs hinzuzufügen.
- gtag.js-Standardpfade für bestimmte IDs:Mit dieser Einstellung können Sie die JavaScript-Bereitstellung für das gtag.js-Tag über die Servercontainer-URL aktivieren. Wenn Sie das Kästchen anklicken, wird dieser Client aufgrund von Anfragen an die gtag.js-Standardanfragepfade aktiviert. Beispiel:
Optional: Zusätzliche Daten mit serverseitigem Tag Manager abrufen
Wenn Sie zusätzliche Parameter senden, müssen Sie den Google Analytics 4-Client in Ihrem Servercontainer einrichten, um die zusätzlichen Parameter zu parsen und daraus Ereignisdaten zu erstellen.
Einige Server-Tags enthalten die zusätzlichen Parameter in ihren ausgehenden Anfragen ohne Einrichtung. Wenn Sie diese Parameter ausschließen möchten, erstellen Sie eine Transformation, um den Wert zu entfernen.
So verwenden Sie zusätzliche Parameter in anderen Tags:
- Klicken Sie in Ihrem Servercontainer im linken Navigationsbereich auf Variablen.
- Klicken Sie unter „Benutzerdefinierte Variablen“ auf Neu.
- Wählen Sie unter Variable konfigurieren den Variablentyp Ereignisdaten aus.
- Geben Sie unter Schlüsselpfad den Namen des Parameters ein.
- Geben Sie einen Namen für die Variable ein und klicken Sie auf Speichern.
Sie können den Ereignisparameter jetzt in jedem anderen Tag in Ihrem Servercontainer verwenden.
3. Optional: Daten aus anderen Quellen als Websites senden
Mit dem Measurement Protocol von Google Analytics können Sie das serverseitige Tagging für Quellen wie mobile Apps und Server-zu-Server-Anwendungen aktivieren.
Mobile Apps
Damit Ihre Android- oder iOS-App Daten an den Servercontainer senden kann, müssen Sie ein benutzerdefiniertes Bild-Tag erstellen und für die Verwendung des Measurement Protocol konfigurieren:
- Klicken Sie in Ihrem mobilen Container (Android oder iOS) auf Tags > Neu.
- Wählen Sie unter Tag-Konfiguration den Tag-Typ Benutzerdefiniertes Bild aus.
- Legen Sie als Wert für Image URL ein Pixelbild im Servercontainer unter dem Pfad im Measurement Protocol-Client fest, den Sie zuvor angegeben haben.
Hängen Sie die gewünschten Measurement Protocol-Parameter an das Ende der Pixel-URL an:
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
- Heben Sie die Auswahl von Cache-Busting aktivieren auf.
- Speichern Sie das Tag und veröffentlichen Sie den Container.
- Klicken Sie in Ihrem serverseitigen Container auf Clients > New (Clients > Neu).
- Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
- Legen Sie für Aktivierungspfad den Pfad des Sammlungsendpunkts Ihrer App fest.
- Speichern Sie die Clientkonfiguration und veröffentlichen Sie den serverseitigen Container.
Server-zu-Server-Apps
Wenn Sie Measurement Protocol-Daten an Ihren Servercontainer senden möchten, ersetzen Sie den Hostnamen www.google-analytics.com
durch den Domainnamen Ihres Servercontainers. Beispiel:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
Wenn Sie Measurement Protocol-Treffer erhalten möchten, konfigurieren Sie Ihre serverseitige Tag Manager-Installation mit einem Measurement Protocol-Client:
- Klicken Sie in Ihrem serverseitigen Container auf Clients > New (Clients > Neu).
- Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
- Legen Sie für Aktivierungspfad den Pfad zum Endpunkt Ihres Servers fest.
- Speichern Sie die Clientkonfiguration und veröffentlichen Sie den Container.
Nächste Schritte
Wenn Sie Daten in einem echten selbst erhobenen Kontext senden möchten, müssen Sie Google-Scripts wie die Google Analytics-Bibliothek von Ihren eigenen Servern aus bereitstellen.