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 nutzen und das Tag-Verhalten basierend auf dem Standort Ihrer Nutzer steuern zu können.

Hinweis

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

Schritt 1: Anfrageheader einrichten

Du musst bestimmte Anfrage-Header senden, die die Informationen zur Region des Nutzers enthalten, wie in den folgenden Abschnitten beschrieben.

Sie können direkt mit Schritt 2 fortfahren, wenn:

  • Sie verwenden die App Engine. Die App Engine sendet geografische Header automatisch.
  • 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 Informationen zur Standortermittlung entweder mit allen HTTP-Anfrageheadern oder für bestimmte Anfragen senden. Da das Hinzufügen benutzerdefinierter Anfrageheader mit einer Gebühr pro 1 Million Anfragen verbunden ist, empfehlen wir, Geoinformationen nur für Anfragen zum Bereitstellen von Google-Scripts anzugeben. Diese Option erfordert zwar anfangs mehr Einrichtungsaufwand, ermöglicht es Ihnen aber, Ihre Infrastruktur so wirtschaftlich wie möglich zu betreiben.

Scriptanfragen

Wenn Sie die Geo-Header nur für Scriptanfragen einschließen möchten, müssen Sie ein neues Back-End einrichten und Routingregeln erstellen.

So erstellen Sie ein neues Back-End:

  1. Offener GCP-Load Balancer
  2. Öffnen Sie in Ihrem Load Balancer den Abschnitt Back-End-Konfiguration. Erstellen Sie einen neuen Back-End-Dienst.
    Screenshot der Back-End-Konfigurationseinstellungen
  3. Konfigurieren Sie den neuen Backend-Dienst:
    • Back-End-Typ: Wählen Sie den Typ der Netzwerk-Endpunktgruppe aus, die Ihre Anwendung verwendet. Wenn Sie Cloud Run verwenden, wählen Sie Endpunktgruppe in serverlosem Netzwerk aus.
    • Wählen Sie unter Neues Backend die Netzwerkendpunktgruppe Ihrer serverseitigen Tag Manager-Implementierung 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 Back-End-Dienst.

So konfigurieren Sie Routingregeln:

  1. Öffnen Sie im Load Balancer den Bereich Routingregeln. Wählen Sie den Modus Erweiterter Hostpfad 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 Informationen zur Standortermittlung mit allen HTTP-Anfragen senden möchten, müssen Sie dem vorhandenen Back-End-Dienst benutzerdefinierte Anfrage-Header hinzufügen. Weitere Informationen finden Sie in der Google Cloud-Dokumentation. Erstellen Sie für jeden der folgenden Header einen neuen benutzerdefinierten Anfrageheader:

Headername Header-Wert
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

GCP Load Balancer

Sie können Informationen zur Standortermittlung entweder mit allen HTTP-Anfrageheadern oder für bestimmte Anfragen senden. Da das Hinzufügen benutzerdefinierter Anfrageheader mit einer Gebühr pro 1 Million Anfragen verbunden ist, empfehlen wir, Geoinformationen nur für Anfragen zum Bereitstellen von Google-Scripts anzugeben. Diese Option erfordert zwar anfangs mehr Einrichtungsaufwand, ermöglicht es Ihnen aber, Ihre Infrastruktur so wirtschaftlich wie möglich zu betreiben.

Scriptanfragen

Wenn Sie die Geo-Header nur für Scriptanfragen einschließen möchten, müssen Sie ein neues Back-End einrichten und Routingregeln erstellen.

So erstellen Sie ein neues Back-End:

  1. Offener GCP-Load Balancer
  2. Öffnen Sie in Ihrem Load Balancer den Abschnitt Back-End-Konfiguration. Erstellen Sie einen neuen Back-End-Dienst.
    Screenshot der Back-End-Konfigurationseinstellungen
  3. Konfigurieren Sie den neuen Backend-Dienst:
    • Back-End-Typ: Wählen Sie den Typ der Netzwerk-Endpunktgruppe aus, die Ihre Anwendung verwendet. Wenn Sie Cloud Run verwenden, wählen Sie Endpunktgruppe in serverlosem Netzwerk aus.
    • Wählen Sie unter Neues Backend die Netzwerkendpunktgruppe Ihrer serverseitigen Tag Manager-Implementierung 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 Back-End-Dienst.

So konfigurieren Sie Routingregeln:

  1. Öffnen Sie im Load Balancer den Bereich Routingregeln. Wählen Sie den Modus Erweiterter Hostpfad 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 Informationen zur Standortermittlung mit allen HTTP-Anfragen senden möchten, müssen Sie dem vorhandenen Back-End-Dienst benutzerdefinierte Anfrage-Header hinzufügen. Weitere Informationen finden Sie in der Google Cloud-Dokumentation. Erstellen Sie für jeden der folgenden Header einen neuen benutzerdefinierten Anfrageheader:

Headername Header-Wert
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-Betrachter-Land Das Land des Nutzers
CloudFront-Viewer-Country-Region Die Unterabteilung des Nutzers
Kopfzeileneinstellungen in AWS CloudFront

Azure Front Door

Erstellen Sie mit der Regeln-Engine einen Regelsatz 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 Abschnitt „Verwaltete Transformationen“ die Option „Header für Besucherstandort 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 „Region des Besuchers“ einrichten

Wenn Sie die geografischen 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 den Servercontainer.
  3. Konfigurieren Sie im Menü Variablen die Liste der integrierten Variablen.
  4. Wählen Sie Region der Besucher aus.

Die geografischen Header können jetzt in der Variablen Region des Besuchers verwendet werden.

Benutzerdefinierte Header

  1. Google Tag Manager öffnen
  2. Öffnen Sie den Servercontainer.
  3. Klicken Sie im Menü Variablen auf Neu, um eine benutzerdefinierte Variable vom Typ Region des Besuchers zu erstellen.
  4. Wählen Sie unter Variable konfigurieren die Option Benutzerdefinierte Variable aus.

  5. Erstellen Sie im Menü Variablen zwei neue Variablen für den Anfrageheader: eine für Ihr Land und eine für den Untergliederungscode. Fülle die Werte mit den Ländercodes in deinen HTTP-Anfrage-Headern aus.

  6. Verwenden Sie die von Ihnen erstellten Variablen in der Variablen Region des Besuchers, wie im Screenshot dargestellt.

    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 Kunden aus oder erstellen Sie einen neuen Kunden, auf den Sie die Regionseinstellung anwenden möchten. Folgende Clients werden unterstützt:

    • Google Tag Manager: Web container
    • Google Analytics: GA4

  2. Wenn Sie GA4-Clients konfigurieren, klicken Sie das Kästchen gtag.js-Standardpfade für bestimmte IDs an und geben Sie die Mess-ID Ihres Webcontainers ein.

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

  4. Speichern Sie den Client.

Schritt 4: Prüfen, ob die Regionseinstellungen gelten

So testen Sie, ob Ihre Einstellungen funktionieren:

  1. Öffnen Sie den Vorschaumodus für Ihren Servercontainer.
  2. Laden Sie Ihre Website mit der Anzeigenbereitstellung mit selbst erhobenen Daten.
  3. Klicken Sie im Vorschaufenster auf den Google Analytics GA4-Client, für den Sie die Anspruchsrechte geltend gemacht haben. Screenshot des Clients
  4. Wenn Sie die tatsächliche Region sehen möchten, ändern Sie das Optionsfeld Variablen anzeigen in „Werte“. Screenshot des Felds für die Region der Besucher
    • ✅ Die Implementierung ist korrekt, wenn für das Attribut Region ein Ländercode angezeigt wird.
    • ❌ Wenn für die Property Region undefined angezeigt wird oder sie 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 Anfrage-Header einrichten.

Nächste Schritte