Regionsspezifisches Verhalten für Tags aktivieren

Dieser Artikel richtet sich an Entwickler, die Google-Scripts über ihren eigenen Server bereitstellen. Wir empfehlen, regionsspezifisches Verhalten für Tags zu aktivieren, um Funktionen wie den erweiterten Einwilligungsmodus zu nutzen und das Tag-Verhalten basierend auf dem Standort Ihrer Nutzer zu steuern.

Wenn Sie ein Script über eine eigene Domain bereitstellen, müssen Sie die Geolocation-Informationen des Nutzers im Anfrageheader angeben, damit Sie die Parameter event_location.country und event_location.region verwenden können. Wenn die IP-Adresse im Anfrageheader verfügbar ist, hat sie bei der Bestimmung der geografischen Position Vorrang. Andernfalls werden die Parameter event_location.country und event_location.region verwendet, um Informationen zu Land und Region zu senden.

Hinweis

In diesem Leitfaden wird davon ausgegangen, dass Sie bereits Folgendes getan haben:

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 die unten aufgeführten. Sie müssen benutzerdefinierte Header einrichten.

Cloud Run mit GCP Load Balancer

Sie können Geolocation-Informationen entweder mit allen HTTP-Anfrageheadern oder für bestimmte Anfragen senden. Da das Hinzufügen benutzerdefinierter Anfrageheader kostenpflichtig ist (pro 1 Million Anfragen), empfehlen wir, geografische Informationen nur für Anfragen zum Bereitstellen von Google-Scripts anzugeben. Diese Option erfordert anfangs mehr Einrichtung, hilft Ihnen aber, Ihre Infrastruktur so kostengünstig wie möglich zu betreiben.

Skriptanfragen

Wenn Sie die geografischen Header nur für Scriptanfragen einfügen möchten, müssen Sie ein neues Backend einrichten und Routingregeln erstellen.

So erstellen Sie ein neues Backend:

  1. GCP-Load-Balancer öffnen
  2. Öffnen Sie in Ihrem Load-Balancer den Abschnitt Back-End-Konfiguration. Erstellen Sie einen neuen Backend-Dienst.
    Screenshot der Backend-Konfigurationseinstellungen
  3. Konfigurieren Sie den neuen Backend-Dienst:
    • Back-End-Typ: Wählen Sie den Typ der Netzwerk-Endpunktgruppe aus, die von Ihrer Anwendung verwendet wird. Wenn Sie Cloud Run verwenden, wählen Sie Endpunktgruppe in serverlosem Netzwerk aus.
    • Wählen Sie unter Neues Backend die Netzwerk-Endpunktgruppe Ihrer serverseitigen Tag Manager-Bereitstellung aus.
      Screenshot des neuen Backend-Dienstes
  4. Öffnen Sie den Bereich Erweiterte Konfigurationen. Fügen Sie die benutzerdefinierten Anfrageheader hinzu.
    Headername Headerwert
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Speichern Sie den neuen Backend-Dienst.

So konfigurieren Sie Routingregeln:

  1. Öffnen Sie in Ihrem Load Balancer den Bereich Routingregeln. Wählen Sie den Modus Erweiterte Host-, Pfad- und Regel aus.
  2. Aktualisieren Sie den Parameter pathRules, um gtm.js, /gtag/js und /gtag/destination dem neuen Backend-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
  3. Speichern Sie die Änderungen.

Alle Anfragen

Wenn Sie Geolocation-Informationen mit allen HTTP-Anfragen senden möchten, müssen Sie dem vorhandenen Backend-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 Geolocation-Informationen entweder mit allen HTTP-Anfrageheadern oder für bestimmte Anfragen senden. Da das Hinzufügen benutzerdefinierter Anfrageheader kostenpflichtig ist (pro 1 Million Anfragen), empfehlen wir, geografische Informationen nur für Anfragen zum Bereitstellen von Google-Scripts anzugeben. Diese Option erfordert anfangs mehr Einrichtung, hilft Ihnen aber, Ihre Infrastruktur so kostengünstig wie möglich zu betreiben.

Skriptanfragen

Wenn Sie die geografischen Header nur für Scriptanfragen einfügen möchten, müssen Sie ein neues Backend einrichten und Routingregeln erstellen.

So erstellen Sie ein neues Backend:

  1. GCP-Load-Balancer öffnen
  2. Öffnen Sie in Ihrem Load-Balancer den Abschnitt Back-End-Konfiguration. Erstellen Sie einen neuen Backend-Dienst.
    Screenshot der Backend-Konfigurationseinstellungen
  3. Konfigurieren Sie den neuen Backend-Dienst:
    • Back-End-Typ: Wählen Sie den Typ der Netzwerk-Endpunktgruppe aus, die von Ihrer Anwendung verwendet wird. Wenn Sie Cloud Run verwenden, wählen Sie Endpunktgruppe in serverlosem Netzwerk aus.
    • Wählen Sie unter Neues Backend die Netzwerk-Endpunktgruppe Ihrer serverseitigen Tag Manager-Bereitstellung aus.
      Screenshot des neuen Backend-Dienstes
  4. Öffnen Sie den Bereich Erweiterte Konfigurationen. Fügen Sie die benutzerdefinierten Anfrageheader hinzu.
    Headername Headerwert
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Speichern Sie den neuen Backend-Dienst.

So konfigurieren Sie Routingregeln:

  1. Öffnen Sie in Ihrem Load Balancer den Bereich Routingregeln. Wählen Sie den Modus Erweiterte Host-, Pfad- und Regel aus.
  2. Aktualisieren Sie den Parameter pathRules, um gtm.js, /gtag/js und /gtag/destination dem neuen Backend-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
  3. Speichern Sie die Änderungen.

Alle Anfragen

Wenn Sie Geolocation-Informationen mit allen HTTP-Anfragen senden möchten, müssen Sie dem vorhandenen Backend-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}

Amazon Web Services (AWS) CloudFront

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:

Headername Headerwert
CloudFront-Viewer-Country Das Land des Nutzers
CloudFront-Viewer-Country-Region Die Unterteilung des Nutzers
Headereinstellungen in AWS CloudFront

Azure Front Door

Erstellen Sie mit der Rules Engine ein Regelset mit der Aktion Anfrageheader ändern und der folgenden Zuordnung:

Headername Headerwert
X-Azure-Country {geo_country}
Screenshot der Azure Front Door-Konfiguration

Cloudflare

Aktivieren Sie im Bereich für verwaltete Transformationen die Option „Besucherstandort-Header hinzufügen“:

Dadurch wird automatisch der folgende Header mit seinem Wert hinzugefügt:

Headername Headerwert
CF-IPCountry Das Land des Nutzers
Screenshot der Cloudflare-Konfiguration

Schritt 2: Variable „Besucherregion“ einrichten 

Wenn Sie geografische Header wie oben beschrieben eingerichtet haben, erkennt Tag Manager die Region oder das Land automatisch, indem der HTTP-Anfrageheader gelesen wird. Alternativ können Sie benutzerdefinierte Header einrichten.

Automatische Erkennung

  1. Google Tag Manager öffnen
  2. Öffnen Sie Ihren Servercontainer.
  3. Klicken Sie im Menü Variablen auf Konfigurieren, um die Liste der integrierten Variablen zu konfigurieren.
  4. Wählen Sie Besucherregion aus.

Die geografischen Header können jetzt in der Variablen Besucherregion verwendet werden.

Benutzerdefinierte Header

  1. Google Tag Manager öffnen
  2. Öffnen Sie Ihren Servercontainer.
  3. Erstellen Sie im Menü Variablen eine Neue benutzerdefinierte Variable vom Typ Besucherregion.
  4. Wählen Sie unter Variable konfigurieren die Option Benutzerdefinierte Variable aus.

  5. Erstellen Sie im Menü Variablen zwei neue Variablen vom Typ Anfrageheader: eine für Ihr Land und eine für den Unterteilungscode. Füllen Sie die Werte mit den Ländercodes in Ihren HTTP-Anfrageheadern aus.

  6. Verwenden Sie die erstellten Variablen in der Variablen Besucherregion, wie im Screenshot gezeigt.

    Screenshot der Variableneinstellungen

  7. Geben Sie einen Namen für die Variable ein und klicken Sie auf Speichern.

Schritt 3: Regionsspezifische Einstellungen in Ihrem Client aktivieren

Wenn Sie die Besucherregion für die Verarbeitung eingehender HTTP-Anfragen verwenden möchten, müssen Sie sie Ihrem Client hinzufügen.

  1. Wählen Sie den Client Google Tag Manager: Webcontainer aus.

  2. Klicken Sie das Kästchen neben Regionsspezifische Einstellungen aktivieren an. Fügen Sie dem Feld Region die Variable {{Visitor Region}} hinzu, die Sie im vorherigen Schritt erstellt haben.

  3. Speichern Sie den Client.

Schritt 4: Überprüfen, ob die Regionseinstellungen angewendet werden

So testen Sie, ob Ihre Einstellungen funktionieren:

  1. Öffnen Sie den Vorschaumodus für Ihren Servercontainer.
  2. Laden Sie Ihre Website, während Sie die Bereitstellung über eigene Server verwenden.
  3. Klicken Sie im Vorschaufenster auf den beanspruchten Google Analytics GA4-Client. Screenshot des Clients
  4. Wenn Sie die tatsächliche Region sehen möchten, ändern Sie das Optionsfeld Display Variables (Variablen anzeigen) in „values“ (Werte). Screenshot des Felds „Besucherregion“
    • ✅ Ihre Implementierung ist korrekt, wenn in der Property Region ein Ländercode angezeigt wird.
    • ❌ Wenn in der Property Region undefined angezeigt wird oder sie fehlt, empfängt 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.

Nächste Schritte