Regionsspezifisches Verhalten für Tags aktivieren

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:

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:

  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 Back-End-Konfigurationseinstellungen
  3. 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.
      Screenshot des neuen Back-End-Dienstes
  4. Ö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}
  5. Speichern Sie den neuen Back-End-Dienst.

So konfigurieren Sie Routingregeln:

  1. Öffnen Sie in Ihrem Load-Balancer den Abschnitt 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 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
  3. 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:

  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 Back-End-Konfigurationseinstellungen
  3. 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.
      Screenshot des neuen Back-End-Dienstes
  4. Ö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}
  5. Speichern Sie den neuen Back-End-Dienst.

So konfigurieren Sie Routingregeln:

  1. Öffnen Sie in Ihrem Load-Balancer den Abschnitt 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 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
  3. 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

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

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

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

  1. Google Tag Manager öffnen
  2. Öffnen Sie den Servercontainer.
  3. Klicken Sie im Menü Variablen für die Liste der integrierten Variablen auf 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 den Servercontainer.
  3. Erstellen Sie im Menü Variablen eine 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 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.

  6. Verwenden Sie die erstellten Variablen in der Variablen Besucherregion, 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 im Client aktivieren

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

  1. 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

  2. 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.

  3. Klicken Sie das Kästchen Regionsspezifische Einstellungen aktivieren an. Fügen Sie die im vorherigen Schritt erstellte Variable {{Besucherregion}} in das Feld Region ein.

  4. Speichern Sie den Client.

Schritt 4: Prü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 eigene Anzeigenbereitstellung verwenden.
  3. Klicken Sie im Vorschaufenster auf den Client Google Analytics GA4 oder Universal Analytics , auf den Anspruch erhoben wurde. Screenshot des Clients
  4. Wenn Sie die tatsächliche Region sehen möchten, legen Sie für das Optionsfeld Display Variables (Variablen anzeigen) Werte fest. Screenshot des Felds „Besucherregion“
    • ✅ 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.

Weitere Informationen