In diesem Artikel werden die verschiedenen Möglichkeiten zum Senden von Ereignissen an einen serverseitigen Container beschrieben. Weitere Hintergrundinformationen finden Sie unter Serverseitiges Tagging.
In diesem Artikel wird Folgendes behandelt:
- Daten von einer Website an Ihren serverseitigen Container senden
- Zusätzliche Daten an einen Servercontainer senden
- Daten in Ihrem serverseitigen Container empfangen
- Daten aus anderen Quellen als Websites senden
Hinweis
In diesem Leitfaden wird Folgendes vorausgesetzt:
1. Daten von einer Website an Ihren serverseitigen Container senden
Sie können Daten über eine serverseitige Implementierung über Tag Manager oder gtag.js weiterleiten. Wählen Sie eine Implementierungsoption aus.
Optional: Zusätzliche Parameter mit jedem Ereignis senden
Sie können zwei zusätzliche 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.
Empfehlungen zur Einrichtung
Wir empfehlen, ein GA4-Tag auf einer Webseite zu verwenden, um Daten an den Servercontainer zu senden. Für dieses Tag können verschiedene Transportmethoden verwendet werden, um die bestmögliche Übermittlungsrate der Ereignisse zu gewährleisten. Zu diesen Methoden gehören unter anderem:
- Bild-Pixel
- Fetch API
- XHR
- Service Worker, der in einem iFrame ausgeführt wird, der von der Domain Ihres Servercontainers geladen wird.
So prüfen Sie, ob alle Methoden unterstützt werden:
Content Security Policy (CSP)
| Anweisung | Inhalt | Purpose |
| img-src | [SERVER_CONTAINER_URL] | Anfragen zur Analyse |
| connect-src | [SERVER_CONTAINER_URL] | Anfragen zur Analyse |
| frame-src | [SERVER_CONTAINER_URL] | Service Worker-Implementierung |
Außerdem darf X-Frame-Options nicht verhindern, dass iFrames von der Servercontainer-URL geladen werden.
Informationen zu produktspezifischen Richtlinien finden Sie unter https://developers.google.com/tag-platform/security/guides/csp.
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 die Liste der verfügbaren Clients auf:
Öffnen Sie Ihren Servercontainer.
Klicken Sie in der Navigationsleiste links auf Clients. 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 keine Änderungen am Client erforderlich. Ihr Anwendungsfall kann jedoch anders sein und Sie möchten möglicherweise 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 Aktivierungskriterien wird definiert, wann der Client auf Anfragen reagiert:
- 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 in serverseitigem Tag Manager empfangen
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 dass eine Einrichtung erforderlich ist. 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 in der linken Navigationsleiste auf Variablen.
- Erstellen Sie eine neue benutzerdefinierte Variable.
- 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 für Google Analytics lässt sich die serverseitige Tagging-Unterstützung für Quellen wie mobile Apps und Server-zu-Server-Anwendungen aktivieren. Mit dieser Option können Sie Ereignisse im Measurement Protocol-Format an Ihren Container senden. Der Container sendet diese Ereignisse mit demselben Mechanismus wie alle anderen SGTM-Ereignisse an Google Analytics.
Diese Option unterstützt nicht alle Funktionen des Measurement Protocol-Endpunkts, z. B. das Ableiten von Informationen zu geografischem Standort und Gerät aus Tagging-Ereignissen.
Mobile Apps
Damit Ihre Android- oder iOS-App Daten an Ihren Servercontainer sendet, müssen Sie ein benutzerdefiniertes Image-Tag erstellen und es 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 den Wert von Bild-URL auf ein Pixelbild im Servercontainer unter dem Pfad im Measurement Protocol-Client fest, den Sie zuvor angegeben haben.
Hängen Sie alle 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 - Deaktivieren Sie Cache-Busting aktivieren.
- Speichern Sie das Tag und veröffentlichen Sie den Container.
- Klicken Sie in Ihrem serverseitigen Container auf Clients > Neu.
- Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
- Legen Sie Aktivierungspfad auf den Pfad des Erfassungs-Endpunkts 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-Hits empfangen möchten, müssen Sie Ihre serverseitige Tag Manager-Installation mit einem Measurement Protocol-Client konfigurieren:
- Klicken Sie in Ihrem serverseitigen Container auf Clients > Neu.
- Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
- Legen Sie Aktivierungspfad auf den Pfad des Endpunkts Ihres Servers fest.
- Speichern Sie die Clientkonfiguration und veröffentlichen Sie den Container.
Nächste Schritte
Wenn Sie Daten im Kontext selbst erhobener Daten senden möchten, müssen Sie Google-Scripts wie die Google Analytics-Bibliothek von Ihren eigenen Servern bereitstellen.