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

Ten artykuł jest przeznaczony dla deweloperów, którzy udostępniają skrypty Google z własnego serwera. Zalecamy włączenie zachowania tagów zależnego od regionu, aby odblokować funkcje takie jak zaawansowany tryb uzyskiwania zgody, i kontrolować działanie tagów w zależności od tego, gdzie znajdują się użytkownicy.

Jeśli udostępniasz skrypt z domeny własnej, musisz podać informacje o geolokalizacji użytkownika w nagłówku żądania, aby móc używać parametrów event_location.country i event_location.region. Jeśli adres IP jest dostępny w nagłówku żądania, ma on pierwszeństwo przy określaniu geolokalizacji. W przeciwnym razie do wysyłania odpowiednio informacji o kraju i regionie używane są parametry event_location.country i event_location.region.

Zanim zaczniesz

Ten przewodnik zakłada, że masz już:

Krok 1. Skonfiguruj nagłówek żądania

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

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

  • używasz App Engine, App Engine automatycznie wysyła nagłówki geograficzne;
  • używasz innego dostawcy infrastruktury niż wymienieni poniżej, musisz skonfigurować nagłówki niestandardowe.

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

Informacje o geolokalizacji możesz wysyłać za pomocą wszystkich nagłówków żądań HTTP lub w przypadku określonych żądań. Dodawanie niestandardowych nagłówków żądań wiąże się z opłatą za każde 1 mln żądań, dlatego zalecamy uwzględnianie informacji geograficznych tylko w przypadku żądań udostępniania skryptów Google. Ta opcja wymaga początkowo bardziej złożonej konfiguracji, ale pomaga w jak najbardziej ekonomicznym zarządzaniu infrastrukturą.

Żądania skryptów

Aby uwzględnić nagłówki geograficzne tylko w przypadku żądań skryptów, 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 ustawień konfiguracji backendu
  3. Skonfiguruj nową usługę backendu:
    • Typ backendu: wybierz typ grupy punktów końcowych sieci którego używa Twoja aplikacja. Jeśli używasz Cloud Run, wybierz Serverless network endpoint group (Grupa bezserwerowych punktów końcowych sieci).
    • W sekcji Nowy backend wybierz grupę punktów końcowych sieci wdrożenia Menedżera tagów po stronie serwera.
      Zrzut ekranu nowej usługi backendu
  4. Otwórz sekcję Ustawienia zaawansowane. Dodaj niestandardowe nagłówki żądań.
    Nazwa nagłówka Wartość nagłówka
    X-Gclb-Country {client_region}
    X-Gclb-Region {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 Zaawansowane reguły hosta, ścieżki i trasy.
  2. Zaktualizuj parametr pathRules, aby przypisać gtm.js, /gtag/js i /gtag/destination do nowej usługi 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 o geolokalizacji 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 niestandardowym nagłówku żądania dla każdego z nagłówków poniżej:

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 o geolokalizacji możesz wysyłać za pomocą wszystkich nagłówków żądań HTTP lub w przypadku określonych żądań. Dodawanie niestandardowych nagłówków żądań wiąże się z opłatą za każde 1 mln żądań, dlatego zalecamy uwzględnianie informacji geograficznych tylko w przypadku żądań udostępniania skryptów Google. Ta opcja wymaga początkowo bardziej złożonej konfiguracji, ale pomaga w jak najbardziej ekonomicznym zarządzaniu infrastrukturą.

Żądania skryptów

Aby uwzględnić nagłówki geograficzne tylko w przypadku żądań skryptów, 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 ustawień konfiguracji backendu
  3. Skonfiguruj nową usługę backendu:
    • Typ backendu: wybierz typ grupy punktów końcowych sieci którego używa Twoja aplikacja. Jeśli używasz Cloud Run, wybierz Serverless network endpoint group (Grupa bezserwerowych punktów końcowych sieci).
    • W sekcji Nowy backend wybierz grupę punktów końcowych sieci wdrożenia Menedżera tagów po stronie serwera.
      Zrzut ekranu nowej usługi backendu
  4. Otwórz sekcję Ustawienia zaawansowane. Dodaj niestandardowe nagłówki żądań.
    Nazwa nagłówka Wartość nagłówka
    X-Gclb-Country {client_region}
    X-Gclb-Region {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 Zaawansowane reguły hosta, ścieżki i trasy.
  2. Zaktualizuj parametr pathRules, aby przypisać gtm.js, /gtag/js i /gtag/destination do nowej usługi 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 o geolokalizacji 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 niestandardowym nagłówku żądania dla każdego z nagłówków poniżej:

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 pochodzenia w celu dodania do żądania nagłówków 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
CloudFront-Viewer-Country Kraj użytkownika
CloudFront-Viewer-Country-Region Podział administracyjny użytkownika
Ustawienia nagłówka w AWS CloudFront

Azure Front Door

Za pomocą Rules Engine utwórz zestaw reguł z działaniem modify request header (zmodyfikuj nagłówek żądania) z tym mapowaniem:

Nazwa nagłówka Wartość nagłówka
X-Azure-Country {geo_country}
Zrzut ekranu konfiguracji usługi Azure Front Door

Cloudflare

Włącz opcję "Add visitor location headers" (Dodaj nagłówki lokalizacji odwiedzającego) w sekcji managed transforms (zarządzane transformacje):

Spowoduje to automatyczne dodanie tego nagłówka wraz z jego wartością:

Nazwa nagłówka Wartość nagłówka
CF-IPCountry Kraj użytkownika
Zrzut ekranu konfiguracji Cloudflare

Krok 2. Skonfiguruj zmienną Region odwiedzającego

Jeśli skonfigurujesz nagłówki geograficzne zgodnie z powyższymi instrukcjami, Menedżer tagów automatycznie wykryje region lub kraj, odczytując nagłówek żądania HTTP. Możesz też skonfigurować nagłówki niestandardowe.

Wykrywanie automatyczne

  1. Otwórz Menedżera tagów Google.
  2. Otwórz kontener serwera.
  3. W menu Zmienne skonfiguruj listę zmiennych wbudowanych.
  4. Wybierz Region odwiedzającego.

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

Niestandardowe nagłówki

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

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

  6. Użyj utworzonych zmiennych w zmiennej Region odwiedzającego , jak pokazano na zrzucie ekranu.

    Zrzut ekranu ustawień zmiennej

  7. Nazwij zmienną i kliknij Zapisz.

Krok 3. Włącz w kliencie ustawienia zależne od regionu

Aby używać regionu odwiedzającego do przetwarzania przychodzących żądań HTTP, musisz dodać go do klienta.

  1. Wybierz klienta Menedżer tagów Google: kontener sieciowy.

  2. Zaznacz opcję Włącz ustawienia zależne od regionu. Dodaj zmienną {{Region odwiedzającego}} utworzoną w poprzednim kroku do pola Region.

  3. Zapisz klienta.

Krok 4. Sprawdź, czy ustawienia regionu są stosowane

Aby sprawdzić, czy ustawienia działają:

  1. Otwórz tryb podglądu kontenera serwera.
  2. Wczytaj witrynę, korzystając z udostępniania z domeny własnej.
  3. W oknie podglądu kliknij klienta Google Analytics GA4 odebranego. Zrzut ekranu klienta
  4. Aby zobaczyć rzeczywisty region, zmień przycisk opcji Wyświetl zmienne na wartości. Zrzut ekranu pola regionu odwiedzającego
    • ✅ Jeśli właściwość Region wyświetla kod kraju, implementacja jest prawidłowa.
    • ❌ Jeśli właściwość Region wyświetla wartość undefined lub jej brakuje, 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