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:
- Konfigurowanie kontenera serwera w Menedżerze tagów
- Konfigurowanie serwera tagowania
- Konfigurowanie udostępniania skryptów własnych
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:
- Otwórz system równoważenia obciążenia GCP
- W systemie równoważenia obciążenia otwórz sekcję Konfiguracja backendu. Utwórz nową usługę backendu.
- 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.
- 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} - Zapisz nową usługę backendu.
Aby skonfigurować reguły routingu:
- W systemie równoważenia obciążenia otwórz sekcję Reguły routingu. Wybierz tryb Zaawansowana ścieżka hosta i reguła.
- 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
- 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:
- Otwórz system równoważenia obciążenia GCP
- W systemie równoważenia obciążenia otwórz sekcję Konfiguracja backendu. Utwórz nową usługę backendu.
- 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.
- 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} - Zapisz nową usługę backendu.
Aby skonfigurować reguły routingu:
- W systemie równoważenia obciążenia otwórz sekcję Reguły routingu. Wybierz tryb Zaawansowana ścieżka hosta i reguła.
- 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
- 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](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/aws-headers.png?authuser=19&hl=pl)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/azure-headers.png?authuser=19&hl=pl)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/server-side/img/cloudflare-headers.png?authuser=19&hl=pl)
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
- Otwórz Menedżera tagów Google
- Otwórz kontener serwera.
- W menu Zmienne kliknij Skonfiguruj i wybierz listę zmiennych wbudowanych.
- Wybierz Region użytkownika.
Nagłówki geograficzne będą teraz dostępne do użycia w zmiennej Region użytkownika.
Nagłówki niestandardowe
- Otwórz Menedżera tagów Google
- Otwórz kontener serwera.
- W menu Zmienne utwórz Nowa zmienną zdefiniowaną przez użytkownika typu Region użytkownika.
- W sekcji Konfiguracja zmiennej kliknij Zmienna niestandardowa.
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.
Użyj utworzonych zmiennych w zmiennej Region użytkownika, jak pokazano na zrzucie ekranu.
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.
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
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.
Zaznacz Włącz ustawienia zależne od regionu. Dodaj do pola Region zmienną {{Region użytkownika}} utworzoną w poprzednim kroku.
Zapisz klienta.
Krok 4. Sprawdź, czy ustawienia regionu mają zastosowanie
Aby sprawdzić, czy ustawienia działają:
- Otwórz tryb podglądu kontenera serwera.
- Wczytywanie witryny podczas korzystania z własnego wyświetlania.
- W oknie podglądu kliknij klienta Google Analytics 4 objęty roszczeniem lub Universal Analytics.
- Aby zobaczyć rzeczywisty region, zmień opcję Zmienne wyświetlane na wartości.
- ✅ 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.