In diesem Artikel werden die verschiedenen Möglichkeiten zum Senden von Ereignissen an einen serverseitigen Container beschrieben. Weitere Hintergrundinformationen finden Sie unter Funktionsweise des serverseitigen Taggings.
In diesem Artikel werden folgende Themen behandelt:
- Daten von einer Website an den serverseitigen Container senden
- Zusätzliche Daten an einen Servercontainer senden
- Daten im serverseitigen Container empfangen
- Daten aus 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 mithilfe von Tag Manager oder dem Google-Tag (gtag.js) weiterleiten. Wählen Sie die gewünschte Implementierungsoption aus.
Optional: Bei jedem Ereignis zusätzliche Parameter senden
Sie können zwei weitere Typen zusätzlicher Parameter senden: Parameter auf Konfigurationsebene und Parameter auf Ereignisebene. Konfigurationsparameter wirken sich auf das Verhalten des 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.
2. Daten im 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 den Servercontainer.
Klicken Sie links in der Navigationsleiste auf Kunden. Der GA4-Client ist standardmäßig auf Ihrem serverseitigen Container vorinstalliert. Wenn Sie mit Universal Analytics arbeiten müssen, richten Sie einen Google Analytics: Universal Analytics-Client ein.
Klicken Sie auf den Namen des Kunden, um Details aufzurufen oder zu bearbeiten.
Optionale Clienteinstellungen
In den meisten Fällen sind keine Änderungen erforderlich. Ihr Anwendungsfall kann jedoch anders aussehen und Sie sollten eine der folgenden Einstellungen bearbeiten:
Priorität:Bestimmt die Reihenfolge, in der Clients ausgeführt werden. Höhere Nummern werden zuerst ausgeführt und der erste Client, der mit der eingehenden Anfrage übereinstimmt, wird zum aktiven Client für diese Anfrage.
Aktivierungskriterien: Mit Aktivierungskriterien wird festgelegt, wann der Client auf Anfragen antwortet:
Für UA-Clients: Standard-Universal Analytics-Pfade: Der Client wird aktiviert, wenn die Anfragepfade
/collect,/r/collectund andere ähnliche Pfade enthalten, die von JavaScript-Dateien verwendet werden, die Daten an Google Analytics senden. Diese Einstellung ist standardmäßig aktiviert.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 diese Option aktiviert ist, wird dieser Client als Antwort auf Anfragen an die standardmäßigen gtag.js-Anfragepfade aktiviert, z.B.
/gtag/js?id=TAG_ID. Klicken Sie auf Mess-ID hinzufügen, um eine oder mehrere Ziel-IDs hinzuzufügen.
Optional: Zusätzliche Daten im serverseitigen 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.
So verwenden Sie zusätzliche Parameter in einem Server-Tag:
- Klicken Sie im Servercontainer im linken Navigationsbereich 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.
Jetzt können Sie den Ereignisparameter in jedem anderen Tag in Ihrem Servercontainer verwenden.
3. Optional: Daten aus anderen Quellen als Websites senden
Mit dem Measurement Protocol von Google Analytics kann serverseitiges Tagging von Quellen wie mobilen Apps und Server-zu-Server-Anwendungen unterstützt werden.
Mobile Apps
Damit Ihre Android- oder iOS-App Daten an Ihren Servercontainer sendet, müssen Sie ein benutzerdefiniertes Image-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 für Image URL ein Pixelbild im Servercontainer im Pfad im Measurement Protocol-Client fest, den Sie zuvor angegeben haben.
Hängen Sie alle gewünschten Measurement Protocol-Parameter an das Ende Ihrer 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 die Option 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 für Aktivierungspfad den Pfad des Endpunkts für die Datenerfassung Ihrer Anwendung fest.
- Speichern Sie die Clientkonfiguration und veröffentlichen Sie den serverseitigen Container.
Server-zu-Server-Anwendungen
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 > Neu.
- Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
- Legen Sie für Aktivierungspfad den Pfad des Serverendpunkts fest.
- Speichern Sie die Clientkonfiguration und veröffentlichen Sie den Container.
Nächste Schritte
Wenn Sie Daten in einem echten Erstanbieterkontext senden möchten, müssen Sie Google-Skripts wie die Google Analytics-Bibliothek über Ihre eigenen Server bereitstellen.