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

Ten artykuł jest przeznaczony dla programistów, którzy udostępniają skrypty Google z własnego serwera. Zalecamy włączenie dla tagów działania zależnego od regionu, aby odblokować funkcje takie jak zaawansowany tryb uzyskiwania zgody oraz kontrolować działanie tagów na podstawie lokalizacji użytkowników.

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 wysyłać określone nagłówki żądań, które zawierają informacje o regionie użytkownika, zgodnie z opisem w sekcjach poniżej.

Możesz przejść bezpośrednio do kroku 2, jeśli:

  • używasz App Engine, App Engine wysyła nagłówki geolokalizacyjne automatycznie.
  • Używasz innego dostawcy infrastruktury niż wymienione poniżej. Musisz skonfigurować nagłówki niestandardowe.

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

Informacje o lokalizacji geograficznej możesz wysyłać w wszystkich nagłówkach żądań HTTP lub w przypadku konkretnych żądań. Dodawanie niestandardowych nagłówków żądań wiąże się z opłatą za 1 milion żądań, dlatego zalecamy uwzględnianie informacji geograficznych tylko w przypadku żądań służących do obsługi skryptów Google. Ta opcja wymaga początkowo więcej konfiguracji, ale pozwala na jak najbardziej ekonomiczne działanie infrastruktury.

Prośby o skrypt

Aby uwzględnić nagłówki geolokalizacji tylko w przypadku żądań skryptu, musisz skonfigurować nowe zaplecze i utworzyć reguły routingu.

Aby utworzyć nowy backend:

  1. Otwórz system równoważenia obciążenia GCP
  2. W urządzeniu równoważącym obciążenie otwórz sekcję Konfiguracja zaplecza. 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órej używa Twoja aplikacja. Jeśli używasz Cloud Run, wybierz grupę bezserwerowych punktów końcowych sieci.
    • W sekcji Nowy backend wybierz grupę punktów końcowych sieci w wdrożeniu Menedżera tagów po stronie serwera.
      Zrzut ekranu przedstawiający nową usługę backendu
  4. Otwórz sekcję Konfiguracje zaawansowane. Dodaj niestandardowe nagłówki żądania.
    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 zaporze równoważenia obciążenia otwórz sekcję Reguły routingu. Wybierz tryb Zaawansowana reguła hosta i ścieżki.
  2. Zaktualizuj parametr pathRules, aby mapować wartości 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 o geolokalizacji ze wszystkimi żądaniami HTTP, musisz dodać niestandardowe nagłówki żądania do istniejącej usługi backendowej. Więcej informacji znajdziesz w dokumentacji Google Cloud. Utwórz nowe niestandardowe nagłówki żądań 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 o lokalizacji geograficznej możesz wysyłać w wszystkich nagłówkach żądań HTTP lub w przypadku konkretnych żądań. Dodawanie niestandardowych nagłówków żądań wiąże się z opłatą za 1 milion żądań, dlatego zalecamy uwzględnianie informacji geograficznych tylko w przypadku żądań służących do obsługi skryptów Google. Ta opcja wymaga początkowo więcej konfiguracji, ale pozwala na jak najbardziej ekonomiczne działanie infrastruktury.

Prośby o skrypt

Aby uwzględnić nagłówki geolokalizacji tylko w przypadku żądań skryptu, musisz skonfigurować nowe zaplecze i utworzyć reguły routingu.

Aby utworzyć nowy backend:

  1. Otwórz system równoważenia obciążenia GCP
  2. W urządzeniu równoważącym obciążenie otwórz sekcję Konfiguracja zaplecza. 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órej używa Twoja aplikacja. Jeśli używasz Cloud Run, wybierz grupę bezserwerowych punktów końcowych sieci.
    • W sekcji Nowy backend wybierz grupę punktów końcowych sieci w wdrożeniu Menedżera tagów po stronie serwera.
      Zrzut ekranu przedstawiający nową usługę backendu
  4. Otwórz sekcję Konfiguracje zaawansowane. Dodaj niestandardowe nagłówki żądania.
    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 zaporze równoważenia obciążenia otwórz sekcję Reguły routingu. Wybierz tryb Zaawansowana reguła hosta i ścieżki.
  2. Zaktualizuj parametr pathRules, aby mapować wartości 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 o geolokalizacji ze wszystkimi żądaniami HTTP, musisz dodać niestandardowe nagłówki żądania do istniejącej usługi backendowej. Więcej informacji znajdziesz w dokumentacji Google Cloud. Utwórz nowe niestandardowe nagłówki żądań 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}

CloudFront Amazon Web Services (AWS)

Utwórz zasadę dotyczącą żą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
CloudFront-Viewer-Country kraj użytkownika,
CloudFront-Viewer-Country-Region Pododdział użytkownika
Ustawienia nagłówka w AWS CloudFront

Azure Front Door

Za pomocą reguł silnika utwórz zestaw reguł z działaniem modyfikuj nagłówek żądania z tym mapowaniem:

Nazwa nagłówka Wartość nagłówka
X-Azure-Country {geo_country}
Zrzut ekranu z konfiguracją Azure Front Door

Cloudflare

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

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 z konfiguracją Cloudflare

Krok 2. Skonfiguruj zmienną Region użytkownika

Jeśli masz skonfigurowane nagłówki geograficzne zgodnie z opisem powyżej, Menedżer tagów automatycznie wykrywa region lub kraj na podstawie odczytu nagłówka żą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, aby wyświetlić listę wbudowanych zmiennych.
  4. Wybierz Region użytkownika.

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

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 użytkownika.
  4. W sekcji Konfiguracja zmiennej kliknij Zmienna niestandardowa.

  5. W menu Zmienna utwórz 2 nowe zmienne Nagłówek żądania: jedną dla kraju, a drugą dla kodu podjednostki. Wpisz w nich kody krajów w nagłówkach żądań HTTP.

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

    Zrzut ekranu z ustawieniami zmiennej

  7. Nazwij zmienną i zapisz ją.

Krok 3. Włącz w kliencie ustawienia dostosowane do regionu

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

  1. Wybierz klienta lub utwórz nowego, dla którego chcesz zastosować ustawienie regionu. Obsługiwane klienty:

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

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

  3. Zaznacz Włącz ustawienia dostosowane do regionu. Dodaj zmienną {{Visitor Region}} utworzoną w poprzednim kroku do pola Region.

  4. Zapisz klienta.

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

Aby sprawdzić, czy ustawienia działają:

  1. Otwórz Tryb podglądu w kontenerze serwera.
  2. Wczytaj witrynę, korzystając z wyświetlania reklam własnych.
  3. W oknie podglądu kliknij klienta Google Analytics GA4 zarezerwowanego. Zrzut ekranu z klienta
  4. Aby zobaczyć rzeczywisty region, ustaw suwak Wyświetlanie zmiennych w pozycji wartości. Zrzut ekranu z polem regionu użytkownika
    • ✅ Implementacja jest prawidłowa, jeśli usługa Region wyświetla kod kraju.
    • ❌ Jeśli w polu właściwości Region jest wartość undefined lub pole to jest puste, Twój serwer nie otrzymuje żadnych danych o regionie. Sprawdź, czy nagłówki HTTP serwera są skonfigurowane zgodnie z wstępnie zdefiniowanymi zmiennymi, których szuka Menedżer tagów Google. Aby dowiedzieć się, jak skonfigurować nagłówek żądania, przeczytaj artykuł Konfigurowanie nagłówka żądania.

Dalsze kroki