Dieser Artikel richtet sich an Entwickler, die Google-Skripts über ihren eigenen Server bereitstellen. Wir empfehlen, das regionsspezifische Verhalten für Tags zu aktivieren, um Funktionen wie den erweiterten Einwilligungsmodus zu nutzen und das Tag-Verhalten je nach Standort der Nutzer zu steuern.
Hinweis
In diesem Leitfaden wird davon ausgegangen, dass Sie Folgendes getan haben:
- Servercontainer in Tag Manager einrichten
- Tagging-Server einrichten
- Bereitstellung mit eigenen Skripts einrichten
Schritt 1: Anfrageheader einrichten
Sie müssen bestimmte Anfrageheader senden, die die Regionsinformationen des Nutzers enthalten, wie in den folgenden Abschnitten beschrieben.
Sie können direkt mit Schritt 2 beginnen, wenn:
- Sie verwenden App Engine. App Engine sendet automatisch Geo-Header.
- Sie verwenden einen anderen Infrastrukturanbieter als den unten aufgeführten. Sie müssen benutzerdefinierte Header einrichten.
Cloud Run mit GCP-Load-Balancer
Sie können Informationen zur Standortbestimmung entweder mit allen HTTP-Anfrageheadern oder für bestimmte Anfragen senden. Da für das Hinzufügen von benutzerdefinierten Anfrageheadern eine Gebühr pro 1 Million Anfragen anfällt, empfehlen wir, für Anfragen zur Bereitstellung von Google-Skripts nur geografische Informationen anzugeben. Diese Option erfordert zu Beginn mehr Einrichtung, hilft Ihnen aber dabei, Ihre Infrastruktur so kostengünstig wie möglich zu betreiben.
Skriptanfragen
Wenn Sie die geografischen Header nur für Skriptanfragen verwenden möchten, müssen Sie ein neues Backend einrichten und Routingregeln erstellen.
So erstellen Sie ein neues Back-End:
- GCP-Load-Balancer öffnen
- Öffnen Sie in Ihrem Load-Balancer den Abschnitt Back-End-Konfiguration. Erstellen Sie einen neuen Backend-Dienst.
- Konfigurieren Sie Ihren neuen Back-End-Dienst:
- Back-End-Typ: Wählen Sie den von Ihrer Anwendung verwendeten Netzwerk-Endpunktgruppentyp aus. Wenn Sie Cloud Run verwenden, wählen Sie Serverlose Netzwerk-Endpunktgruppe aus.
- Wählen Sie unter Neues Back-End die Netzwerk-Endpunktgruppe Ihrer serverseitigen Tag Manager-Bereitstellung aus.
- Öffnen Sie den Bereich Erweiterte Konfigurationen. Fügen Sie die benutzerdefinierten Anfrageheader hinzu.
Header-Name Header-Wert X-Gclb-Country {client_region} X-Gclb-Region {client_region_subdivision} - Speichern Sie den neuen Back-End-Dienst.
So konfigurieren Sie Routingregeln:
- Öffnen Sie in Ihrem Load-Balancer den Abschnitt Routingregeln. Wählen Sie den Modus Erweiterter Hostpfad und -regel aus.
- Aktualisieren Sie den Parameter
pathRules
, umgtm.js
,/gtag/js
und/gtag/destination
dem neuen Back-End-Dienst zuzuordnen.
pathRules: - paths: - /gtm.js - /gtag* service: projects/project_id/global/backendServices/new backend service - paths: - /* service: projects/project_id/global/backendServices/original backend service
- Speichern Sie die Änderungen.
Alle Anträge
Wenn Sie mit allen HTTP-Anfragen Informationen zur Standortbestimmung senden möchten, müssen Sie dem vorhandenen Back-End-Dienst benutzerdefinierte Anfrageheader hinzufügen. Weitere Informationen finden Sie in der Google Cloud-Dokumentation. Erstellen Sie für jeden der folgenden Header einen neuen benutzerdefinierten Anfrageheader:
Headername | Headerwert |
---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
GCP-Load-Balancer
Sie können Informationen zur Standortbestimmung entweder mit allen HTTP-Anfrageheadern oder für bestimmte Anfragen senden. Da für das Hinzufügen von benutzerdefinierten Anfrageheadern eine Gebühr pro 1 Million Anfragen anfällt, empfehlen wir, für Anfragen zur Bereitstellung von Google-Skripts nur geografische Informationen anzugeben. Diese Option erfordert zu Beginn mehr Einrichtung, hilft Ihnen aber dabei, Ihre Infrastruktur so kostengünstig wie möglich zu betreiben.
Skriptanfragen
Wenn Sie die geografischen Header nur für Skriptanfragen verwenden möchten, müssen Sie ein neues Backend einrichten und Routingregeln erstellen.
So erstellen Sie ein neues Back-End:
- GCP-Load-Balancer öffnen
- Öffnen Sie in Ihrem Load-Balancer den Abschnitt Back-End-Konfiguration. Erstellen Sie einen neuen Backend-Dienst.
- Konfigurieren Sie Ihren neuen Back-End-Dienst:
- Back-End-Typ: Wählen Sie den von Ihrer Anwendung verwendeten Netzwerk-Endpunktgruppentyp aus. Wenn Sie Cloud Run verwenden, wählen Sie Serverlose Netzwerk-Endpunktgruppe aus.
- Wählen Sie unter Neues Back-End die Netzwerk-Endpunktgruppe Ihrer serverseitigen Tag Manager-Bereitstellung aus.
- Öffnen Sie den Bereich Erweiterte Konfigurationen. Fügen Sie die benutzerdefinierten Anfrageheader hinzu.
Header-Name Header-Wert X-Gclb-Country {client_region} X-Gclb-Region {client_region_subdivision} - Speichern Sie den neuen Back-End-Dienst.
So konfigurieren Sie Routingregeln:
- Öffnen Sie in Ihrem Load-Balancer den Abschnitt Routingregeln. Wählen Sie den Modus Erweiterter Hostpfad und -regel aus.
- Aktualisieren Sie den Parameter
pathRules
, umgtm.js
,/gtag/js
und/gtag/destination
dem neuen Back-End-Dienst zuzuordnen.
pathRules: - paths: - /gtm.js - /gtag* service: projects/project_id/global/backendServices/new backend service - paths: - /* service: projects/project_id/global/backendServices/original backend service
- Speichern Sie die Änderungen.
Alle Anträge
Wenn Sie mit allen HTTP-Anfragen Informationen zur Standortbestimmung senden möchten, müssen Sie dem vorhandenen Back-End-Dienst benutzerdefinierte Anfrageheader hinzufügen. Weitere Informationen finden Sie in der Google Cloud-Dokumentation. Erstellen Sie für jeden der folgenden Header einen neuen benutzerdefinierten Anfrageheader:
Headername | Headerwert |
---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
CloudFront (Amazon Web Services)
Erstellen Sie eine Richtlinie für Ursprungsanfragen, um der Anfrage die Header CloudFront-Viewer-Country
und CloudFront-Viewer-Country-Region
hinzuzufügen.
Dadurch werden automatisch die folgenden Header mit ihren Werten hinzugefügt:
Header-Name | Header-Wert |
---|---|
CloudFront-Viewer-Land | Land des Nutzers |
CloudFront-Viewer-Country-Region | Die Untergruppe des Nutzers |
![Header-Einstellungen in AWS CloudFront](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/aws-headers.png?authuser=7&hl=de)
Haustür in Azure
Erstellen Sie mithilfe des Moduls für Regeln einen Regelsatz mit der Aktion Anfrageheader ändern mit der folgenden Zuordnung:
Header-Name | Header-Wert |
---|---|
X-Azure-Land | {geo_country} |
![Screenshot der Azure Front Door-Konfiguration](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/azure-headers.png?authuser=7&hl=de)
Cloudflare
Aktivieren Sie im Abschnitt Verwaltete Transformationen die Option „Header für Besucherstandort-Header hinzufügen“:
Dadurch wird automatisch der folgende Header mit seinem Wert hinzugefügt:
Header-Name | Header-Wert |
---|---|
CF-IPCountry | Land des Nutzers |
![Screenshot der Cloudflare-Konfiguration](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/cloudflare-headers.png?authuser=7&hl=de)
Schritt 2: Variable „Besucherregion“ einrichten
Wenn Sie wie oben beschrieben geografische Header eingerichtet haben, wird die Region oder das Land in Tag Manager automatisch anhand des HTTP-Anfrageheaders erkannt. Alternativ können Sie benutzerdefinierte Header einrichten.
Automatische Erkennung
- Google Tag Manager öffnen
- Öffnen Sie den Servercontainer.
- Klicken Sie im Menü Variablen für die Liste der integrierten Variablen auf Konfigurieren.
- Wählen Sie Besucherregion aus.
Die geografischen Header können jetzt in der Variablen Besucherregion verwendet werden.
Benutzerdefinierte Header
- Google Tag Manager öffnen
- Öffnen Sie den Servercontainer.
- Erstellen Sie im Menü Variablen eine benutzerdefinierte Variable vom Typ Besucherregion.
- Wählen Sie unter Variable konfigurieren die Option Benutzerdefinierte Variable aus.
Erstellen Sie im Menü Variablen zwei neue Variablen für Anfrageheader: eine für Ihr Land und eine für den Code der Untergruppe. Geben Sie in die Werte die Ländercodes aus den HTTP-Anfrageheadern ein.
Verwenden Sie die erstellten Variablen in der Variablen Besucherregion, wie im Screenshot dargestellt.
Geben Sie einen Namen für die Variable ein und klicken Sie auf Speichern.
Schritt 3: Regionsspezifische Einstellungen im Client aktivieren
Um die Besucherregion für die Verarbeitung eingehender HTTP-Anfragen zu verwenden, müssen Sie sie Ihrem Client hinzufügen.
Wählen Sie den Client aus oder erstellen Sie einen neuen, auf den Sie die Regionseinstellung anwenden möchten. Unterstützte Clients sind:
- Google Tag Manager: Web container
- Google Analytics: GA4
- Google Analytics: Universal Analytics
Wenn Sie GA4- oder UA-Clients konfigurieren, klicken Sie das Kästchen Standardmäßige gtag.js-Pfade für bestimmte IDs an und geben Sie die Mess-ID Ihres Webcontainers ein.
Klicken Sie das Kästchen Regionsspezifische Einstellungen aktivieren an. Fügen Sie die im vorherigen Schritt erstellte Variable {{Besucherregion}} in das Feld Region ein.
Speichern Sie den Client.
Schritt 4: Prüfen, ob die Regionseinstellungen angewendet werden
So testen Sie, ob Ihre Einstellungen funktionieren:
- Öffnen Sie den Vorschaumodus für Ihren Servercontainer.
- Laden Sie Ihre Website, während Sie die eigene Anzeigenbereitstellung verwenden.
- Klicken Sie im Vorschaufenster auf den Client Google Analytics GA4 oder Universal Analytics , auf den Anspruch erhoben wurde.
- Wenn Sie die tatsächliche Region sehen möchten, legen Sie für das Optionsfeld Display Variables (Variablen anzeigen) Werte fest.
- ✅ Ihre Implementierung ist korrekt, wenn in der Eigenschaft Region ein Ländercode angezeigt wird.
- ❌ Wenn für das Attribut Region
undefined
angezeigt wird oder fehlt, erhält Ihr Server keine Regionsdaten. Prüfen Sie, ob die HTTP-Header des Servers gemäß den vordefinierten Variablen eingerichtet sind, nach denen Google Tag Manager sucht. Weitere Informationen finden Sie unter Anfrageheader einrichten.