Daten an serverseitiges Tag Manager senden

In diesem Dokument werden die verschiedenen Möglichkeiten beschrieben, Ereignisse an einen serverseitigen Container zu senden. Weitere Hintergrundinformationen finden Sie unter Serverseitiges Tagging.

In diesem Dokument 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 Ihre Implementierungsoption aus.

Wählen Sie Ihre Implementierungsoption aus.

Optional: Zusätzliche Parameter mit jedem Ereignis senden

Sie können zwei Arten zusätzlicher Parameter senden: Parameter auf Konfigurationsebene und Parameter auf Ereignisebene. Konfigurationsparameter beeinflussen das Verhalten Ihres Google-Tags oder Google Analytics-Ziel-Tags und können nur auf der Ebene des Google-Tags oder Google Analytics-Ziel-Tags 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.

Wählen Sie Ihre Implementierungsoption aus.

Empfehlungen für die Einrichtung

Wir empfehlen, auf einer Webseite das Google Analytics-Tag zu verwenden, um Daten an den Servercontainer zu senden. Dieses Tag kann verschiedene Transportmethoden verwenden, um die bestmögliche Zustellrate der Ereignisse zu gewährleisten. Zu diesen Methoden gehören unter anderem:

  • Bildpixel
  • Fetch API
  • XHR
  • Service Worker, der in einem iFrame ausgeführt wird, das von der Servercontainer-Domain geladen wurde

Prüfen Sie Folgendes, um sicherzustellen, dass alle Methoden unterstützt werden:

Content Security Policy (CSP)

Anweisung Inhalt Zweck
img-src [SERVER_CONTAINER_URL] Messanfragen
connect-src [SERVER_CONTAINER_URL] Messanfragen
frame-src [SERVER_CONTAINER_URL] Implementierung des Service Workers

Außerdem dürfen X-Frame-Options nicht verhindern, dass iFrames von der Servercontainer-URL geladen werden.

Unter https://developers.google.com/tag-platform/security/guides/csp finden Sie spezifische Richtlinien für jedes Produkt.

2. Daten in Ihrem serverseitigen Container empfangen

Wenn Sie eine HTTP-Anfrage an einen Servercontainer senden, muss ein Client diese Anfrage annehmen.

So rufen Sie die Liste der verfügbaren Clients auf:

  1. Öffnen Sie Google Tag Manager.

  2. Öffnen Sie Ihren Servercontainer.

  3. Klicken Sie in der Navigationsleiste auf der linken Seite auf Clients. Der Google Analytics-Client ist standardmäßig in Ihrem serverseitigen Container vorinstalliert.

  4. Klicken Sie auf den Namen des Clients, 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. Höhere Zahlen werden zuerst ausgeführt. Der erste Client, der mit der eingehenden Anfrage übereinstimmt, wird zum aktiven Client für diese Anfrage.

  • Aktivierungskriterien:Aktivierungskriterien definieren, wann der Client auf Anfragen reagiert:

    • gtag.js-Standardpfade für bestimmte IDs:Sie können diese Einstellung verwenden, um die JavaScript-Bereitstellung für das gtag.js-Tag über die Servercontainer-URL zu 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 Hinzufügen Mess-ID , 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 -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 ohne Einrichtung in ihren ausgehenden Anfragen. 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:

  1. Klicken Sie in Ihrem Servercontainer in der linken Navigationsleiste auf Variablen.
  2. Erstellen Sie eine neue benutzerdefinierte Variable.
  3. Wählen Sie unter Variable konfigurieren den Variablentyp Ereignisdaten aus.
  4. Geben Sie unter Schlüsselpfad den Namen des Parameters ein.
  5. Geben Sie der Variablen einen Namen 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 Google Analytics Measurement Protocol können Sie serverseitiges Tagging aus Quellen wie mobilen 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 geografischen Informationen und Geräteinformationen aus Tagging-Ereignissen.

Mobile Apps

Wenn Sie möchten, dass Ihre Android- oder iOS-App Daten an Ihren Servercontainer sendet, erstellen Sie ein benutzerdefiniertes Bild-Tag und konfigurieren Sie es so, dass das Measurement Protocol verwendet wird:

  1. Klicken Sie in Ihrem mobilen Container (Android oder iOS) auf Tags > Neu.
  2. Wählen Sie unter Tag-Konfiguration den Tag-Typ Benutzerdefiniertes Bild aus.
  3. Legen Sie für Bild-URL 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 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
  4. Deaktivieren Sie Cache-Busting aktivieren.
  5. Speichern Sie das Tag und veröffentlichen Sie den Container.
  6. Klicken Sie in Ihrem serverseitigen Container auf Clients > Neu.
  7. Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
  8. Legen Sie für Aktivierungspfad den Pfad des Erfassungsendpunkts Ihrer App fest.
  9. 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 empfangen möchten, konfigurieren Sie Ihre serverseitige Tag Manager-Installation mit einem Measurement Protocol-Client:

  1. Klicken Sie in Ihrem serverseitigen Container auf Clients > Neu.
  2. Wählen Sie unter Clientkonfiguration den Clienttyp Measurement Protocol aus.
  3. Legen Sie für Aktivierungspfad den Pfad des Endpunkts Ihres Servers fest.
  4. Speichern Sie die Clientkonfiguration und veröffentlichen Sie den Container.

Nächste Schritte

Wenn Sie Daten in einem echten First-Party-Kontext senden möchten, müssen Sie Google-Skripts wie die Google Analytics-Bibliothek von Ihren eigenen Servern bereitstellen.

Google-Skripts über meinen Server laden