Włącz działanie tagów zależne od regionu

Ten artykuł jest przeznaczony dla programistów, którzy wyświetlają skrypty Google z własnego serwera. Zalecamy włączenie działania tagów zależnie od regionu. Pozwoli to odblokować funkcje takie jak zaawansowany tryb uzyskiwania zgody i kontrolować działanie tagów na podstawie tego, gdzie znajdują się użytkownicy.

Zanim zaczniesz

W tym przewodniku przyjęto założenie, że zostały już przez Ciebie wykonane te czynności:

Krok 1. Skonfiguruj nagłówek żądania

Musisz wysłać określone nagłówki żądań zawierające informacje o regionie użytkownika, zgodnie z opisem w sekcjach poniżej.

Możesz bezpośrednio zacząć od kroku 2, jeśli:

  • Używasz App Engine. App Engine automatycznie wysyła nagłówki geograficzne.
  • Korzystasz z innego dostawcy infrastruktury niż wymienieni poniżej. Musisz skonfigurować nagłówki niestandardowe.

Cloud Run z systemem równoważenia obciążenia GCP

Informacje geolokalizacyjne możesz wysyłać ze wszystkimi nagłówkami żądań HTTP lub z konkretnymi żądaniami. Dodanie niestandardowych nagłówków żądań będzie powodować naliczanie opłaty za 1 milion żądań, dlatego zalecamy podawanie w żądaniach obsługi skryptów Google tylko informacji geograficznych. Ta opcja początkowo wymaga bardziej skomplikowanej konfiguracji, ale pomaga maksymalnie ekonomiczne zarządzanie infrastrukturą.

Żądania skryptu

Aby uwzględniać nagłówki geograficzne tylko w przypadku żądań skryptu, musisz skonfigurować nowy backend i utworzyć reguły routingu.

Aby utworzyć nowy backend:

  1. Otwórz system równoważenia obciążenia GCP
  2. W systemie równoważenia obciążenia otwórz sekcję Konfiguracja backendu. Utwórz nową usługę backendu.
    Zrzut ekranu z ustawieniami konfiguracji backendu
  3. Skonfiguruj nową usługę backendu:
    • Typ backendu: wybierz typ grupy punktów końcowych sieci, których używa Twoja aplikacja. Jeśli korzystasz z Cloud Run, wybierz Bezserwerowa grupa punktów końcowych sieci.
    • W sekcji Nowy backend wybierz grupę punktów końcowych sieci dla wdrożenia Menedżera tagów po stronie serwera.
      Zrzut ekranu przedstawiający nową usługę backendu
  4. Otwórz sekcję Ustawienia zaawansowane. Dodaj niestandardowe nagłówki żądania.
    Nazwa nagłówka Wartość nagłówka
    Kraj X-Gclb {client_region}
    Region X-Gclb {client_region_subdivision}
  5. Zapisz nową usługę backendu.

Aby skonfigurować reguły routingu:

  1. W systemie równoważenia obciążenia otwórz sekcję Reguły routingu. Wybierz tryb Zaawansowana ścieżka hosta i reguła.
  2. Zaktualizuj parametr pathRules, aby zmapować gtm.js, /gtag/js i /gtag/destination na nową usługę backendu.
    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. Zapisz zmiany.

Wszystkie prośby

Aby wysyłać informacje geolokalizacyjne ze wszystkimi żądaniami HTTP, musisz dodać niestandardowe nagłówki żądań do istniejącej usługi backendu. Więcej informacji znajdziesz w dokumentacji Google Cloud. Utwórz po 1 nowym nagłówku żądania niestandardowego dla każdego z tych nagłówków:

Nazwa nagłówka Wartość nagłówka
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

System równoważenia obciążenia GCP

Informacje geolokalizacyjne możesz wysyłać ze wszystkimi nagłówkami żądań HTTP lub z konkretnymi żądaniami. Dodanie niestandardowych nagłówków żądań będzie powodować naliczanie opłaty za 1 milion żądań, dlatego zalecamy podawanie w żądaniach obsługi skryptów Google tylko informacji geograficznych. Ta opcja początkowo wymaga bardziej skomplikowanej konfiguracji, ale pomaga maksymalnie ekonomiczne zarządzanie infrastrukturą.

Żądania skryptu

Aby uwzględniać nagłówki geograficzne tylko w przypadku żądań skryptu, musisz skonfigurować nowy backend i utworzyć reguły routingu.

Aby utworzyć nowy backend:

  1. Otwórz system równoważenia obciążenia GCP
  2. W systemie równoważenia obciążenia otwórz sekcję Konfiguracja backendu. Utwórz nową usługę backendu.
    Zrzut ekranu z ustawieniami konfiguracji backendu
  3. Skonfiguruj nową usługę backendu:
    • Typ backendu: wybierz typ grupy punktów końcowych sieci, których używa Twoja aplikacja. Jeśli korzystasz z Cloud Run, wybierz Bezserwerowa grupa punktów końcowych sieci.
    • W sekcji Nowy backend wybierz grupę punktów końcowych sieci dla wdrożenia Menedżera tagów po stronie serwera.
      Zrzut ekranu przedstawiający nową usługę backendu
  4. Otwórz sekcję Ustawienia zaawansowane. Dodaj niestandardowe nagłówki żądania.
    Nazwa nagłówka Wartość nagłówka
    Kraj X-Gclb {client_region}
    Region X-Gclb {client_region_subdivision}
  5. Zapisz nową usługę backendu.

Aby skonfigurować reguły routingu:

  1. W systemie równoważenia obciążenia otwórz sekcję Reguły routingu. Wybierz tryb Zaawansowana ścieżka hosta i reguła.
  2. Zaktualizuj parametr pathRules, aby zmapować gtm.js, /gtag/js i /gtag/destination na nową usługę backendu.
    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. Zapisz zmiany.

Wszystkie prośby

Aby wysyłać informacje geolokalizacyjne ze wszystkimi żądaniami HTTP, musisz dodać niestandardowe nagłówki żądań do istniejącej usługi backendu. Więcej informacji znajdziesz w dokumentacji Google Cloud. Utwórz po 1 nowym nagłówku żądania niestandardowego dla każdego z tych nagłówków:

Nazwa nagłówka Wartość nagłówka
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

Amazon Web Services (AWS) CloudFront

Utwórz zasadę żądania źródła, aby dodać do żądania nagłówki CloudFront-Viewer-Country i CloudFront-Viewer-Country-Region.

Spowoduje to automatyczne dodanie tych nagłówków wraz z ich wartościami:

Nazwa nagłówka Wartość nagłówka
Kraj wyświetlający CloudFront Kraj użytkownika
CloudFront-Viewer-Country-Region Podział użytkownika
Ustawienia nagłówka w AWS CloudFront

Azure Front Do

Korzystając z Mechanizmu reguł, utwórz zestaw reguł z działaniem modyfikuj nagłówek żądania z tym mapowaniem:

Nazwa nagłówka Wartość nagłówka
Kraj X-Azure {geo_country}
Zrzut ekranu przedstawiający konfigurację Azure Front Door

Cloudflare

Włącz opcję „Dodaj nagłówki lokalizacji użytkownika” w sekcji przekształceń zarządzanych:

Spowoduje to automatyczne dodanie następującego nagłówka z jego wartością:

Nazwa nagłówka Wartość nagłówka
Kraj CF-IP Kraj użytkownika
Zrzut ekranu przedstawiający konfigurację Cloudflare

Krok 2. Skonfiguruj zmienną Region użytkownika

Jeśli nagłówki geograficzne zostaną skonfigurowane w sposób opisany powyżej, Menedżer tagów automatycznie wykryje region lub kraj, odczytując nagłówek żądania HTTP. Możesz też skonfigurować nagłówki niestandardowe.

Automatyczne wykrywanie

  1. Otwórz Menedżera tagów Google
  2. Otwórz kontener serwera.
  3. W menu Zmienne kliknij Skonfiguruj i wybierz listę zmiennych wbudowanych.
  4. Wybierz Region użytkownika.

Nagłówki geograficzne będą teraz dostępne do użycia w zmiennej Region użytkownika.

Nagłówki niestandardowe

  1. Otwórz Menedżera tagów Google
  2. Otwórz kontener serwera.
  3. W menu Zmienne utwórz Nowa zmienną zdefiniowaną przez użytkownika typu Region użytkownika.
  4. W sekcji Konfiguracja zmiennej kliknij Zmienna niestandardowa.

  5. W menu Zmienne utwórz 2 nowe zmienne Nagłówek żądania: jedną dla swojego kraju i jedną dla kodu podgrupy. Wypełnij wartości kodami krajów w nagłówkach żądań HTTP.

  6. Użyj utworzonych zmiennych w zmiennej Region użytkownika, jak pokazano na zrzucie ekranu.

    Zrzut ekranu przedstawiający ustawienia zmiennej

  7. Nazwij zmienną i zapisz ją.

Krok 3. Włącz w kliencie ustawienia właściwe dla regionu

Aby używać regionu użytkownika do przetwarzania przychodzących żądań HTTP, musisz dodać ten region do swojego klienta.

  1. Wybierz klienta lub utwórz nowego klienta, do którego chcesz zastosować ustawienie regionu. Obsługiwani klienci to:

    • Menedżer tagów Google: kontener internetowy
    • Google Analytics: GA4
    • Google Analytics – Universal Analytics

  2. Jeśli konfigurujesz klientów GA4 lub UA, zaznacz pole Domyślne ścieżki tagu gtag.js dla określonych identyfikatorów i wpisz identyfikator pomiaru swojego kontenera internetowego.

  3. Zaznacz Włącz ustawienia zależne od regionu. Dodaj do pola Region zmienną {{Region użytkownika}} utworzoną w poprzednim kroku.

  4. Zapisz klienta.

Krok 4. Sprawdź, czy ustawienia regionu mają zastosowanie

Aby sprawdzić, czy ustawienia działają:

  1. Otwórz tryb podglądu kontenera serwera.
  2. Wczytywanie witryny podczas korzystania z własnego wyświetlania.
  3. W oknie podglądu kliknij klienta Google Analytics 4 objęty roszczeniem lub Universal Analytics. Zrzut ekranu przedstawiający klienta
  4. Aby zobaczyć rzeczywisty region, zmień opcję Zmienne wyświetlane na wartości. Zrzut ekranu przedstawiający pole regionu użytkownika
    • ✅ Implementacja jest prawidłowa, jeśli właściwość Region zawiera kod kraju.
    • ❌ Jeśli w polu właściwości Region brakuje wartości undefined lub jej brak, serwer nie otrzymuje żadnych danych o regionie. Sprawdź, czy nagłówki HTTP serwera są skonfigurowane zgodnie ze wstępnie zdefiniowanymi zmiennymi, których szuka Menedżer tagów Google. Więcej informacji znajdziesz w artykule Konfigurowanie nagłówka żądania.

Dalsze kroki