Ten dokument jest przeznaczony dla użytkowników, którzy chcą wdrożyć bramę tagu Google dla reklamodawców. Aby uzyskać najbardziej trwałą konfigurację tagów, zalecamy korzystanie z bramy tagów Google dla reklamodawców.
Przegląd
Brama tagów Google dla reklamodawców umożliwia wdrażanie tagu Google w Twojej własnej infrastrukturze, która jest hostowana w domenie Twojej witryny. Ta infrastruktura znajduje się między Twoją witryną a usługami Google. Konfiguracja opisana w tej dokumentacji pomoże Ci dokładniej mierzyć skuteczność witryny. Możesz go skonfigurować za pomocą istniejącej sieci dostarczania treści (CDN), systemu równoważenia obciążenia lub serwera WWW.
W standardowych konfiguracjach tagu Google strona internetowa wywołuje tag Google z domeny Google. Gdy tag zostanie uruchomiony, wysyła żądania pomiarowe bezpośrednio do usługi Google. Dzięki bramie tagów Google dla reklamodawców witryna wczytuje tag Google z domeny własnej. Gdy tag zostanie uruchomiony, niektóre żądania pomiarowe będą wysyłane do Google z użyciem Twojej domeny własnej.
Ten diagram przedstawia przepływ informacji w bramie tagów Google dla reklamodawców:
Zanim zaczniesz
W tym przewodniku zakładamy, że Twoja witryna ma już skonfigurowane:
- Tag Google lub kontener Menedżera tagów.
- Sieć dostarczania treści (CDN) lub system równoważenia obciążenia, który może przekazywać żądania do zewnętrznych punktów końcowych.
Aby rozpocząć, wybierz typ konfiguracji.
1. Wybieranie ścieżek pomiaru
Musisz zarezerwować unikalną ścieżkę pomiaru w domenie witryny na potrzeby wyświetlania każdego tagu lub kontenera Menedżera tagów Google.
Wymagania dotyczące ścieżki pomiaru:
- Ścieżki nie mogą być już używane w Twojej domenie.
- Żadna ścieżka nie może być ścieżką główną /.
- Długość każdej ścieżki nie może przekraczać 100 znaków.
Menedżer tagów Google:
Jeśli korzystasz z Menedżera tagów Google, musisz tylko podać identyfikator kontenera (np. GTM-XXXXXX). Ta pojedyncza konfiguracja wystarczy w przypadku wszystkich tagów (np. Google Analytics, Google Ads itp.), które zostały już dodane do tego kontenera.
Każdy unikalny kontener lub samodzielny tag musi mieć unikalną ścieżkę wyświetlania i odpowiadający jej identyfikator.
Aby skonfigurować bramę tagów Google dla reklamodawców, wybierz dowolną ścieżkę, która nie jest jeszcze używana w Twojej witrynie. Aby zmniejszyć prawdopodobieństwo konfliktu ze ścieżką, która już istnieje w witrynie, możesz wybrać dowolną kombinację liter i cyfr. Jeśli chcesz, aby ścieżka była bardziej czytelna, możesz użyć słowa, np. /gtm, /metrics, /analytics lub dowolnego innego.
Na przykład:
| Przypadek użycia | Identyfikator | Ścieżka wyświetlania tagu | Punkt końcowy pochodzenia |
|---|---|---|---|
| Tag samodzielny 1 | G-12345 |
/abjfo |
g-12345.fps.goog |
| Tag samodzielny 2 | G-67890 |
/fjdso |
g-67890.fps.goog |
| Kontener Menedżera tagów Google | GTM-ABCDEF |
/cvfjk |
gtm-abcdef.fps.goog |
Wypełnij poniższe pola, aby wypełnić przykłady w tym dokumencie.
Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics
Jak obsługiwać wiele tagów lub kontenerów:
Jeśli tagi znajdują się w tym samym kontenerze Menedżera tagów Google, nie musisz powtarzać tej konfiguracji. Wystarczy dodać jeden kontener Menedżera tagów Google, a wszystkie tagi w nim zostaną obsłużone.
Jeśli tagi znajdują się w osobnych kontenerach Menedżera tagów Google LUB nie są połączone... Musisz powtórzyć tę konfigurację dla każdego wystąpienia. Dotyczy to kampanii:
- Wiele osobnych kontenerów Menedżera tagów Google.
- Poszczególne tagi (np. G-XXXXXX), które nie znajdują się w kontenerze.
W takim przypadku musisz przypisać do każdego kontenera lub tagu unikalną ścieżkę wyświetlania tagu.
2. Kierowanie ruchu
W tej sekcji założyliśmy, że Twoja witryna korzysta już z sieci CDN lub systemu równoważenia obciążenia, który obsługuje kierowanie ruchu na podstawie ścieżek.
Google Cloud
Musisz skonfigurować nowy backend, który wyszukuje przybliżoną lokalizację geograficzną osoby odwiedzającej witrynę, i utworzyć reguły routingu w istniejącym zewnętrznym systemie równoważenia obciążenia aplikacji.
Tworzenie nowego backendu
W usłudze równoważenia obciążenia otwórz sekcję Konfiguracja backendu. Utwórz nową usługę backendu.

Skonfiguruj nową usługę backendu z informacjami o geolokalizacji:
- Określ nazwę, np.
measurement-be-svc. - Ustaw Typ backendu na Internetowa grupa punktów końcowych sieci.
- Ustaw Protokół na HTTPS i pozostaw wstępnie wypełnioną wartość w polu Limit czasu.
- W sekcji Backendy kliknij menu Internetowa grupa punktów końcowych sieci i utwórz nową internetową grupę punktów końcowych sieci:
- Ustaw Typ grupy punktów końcowych sieci na Internetowa grupa punktów końcowych sieci (globalna, regionalna).
- Ustaw Zakres na Globalny.
- Ustaw opcję Dodaj przez na Pełna i jednoznaczna nazwa domeny i port.
- Ustaw Pełna i jednoznaczna nazwa domeny na
G-12345.fps.goog. - Aby utworzyć punkt końcowy, kliknij UTWÓRZ.
- Zamknij kartę Grupa punktów końcowych sieci, aby wrócić do karty Nowa usługa backendu.
- Wyszukaj nazwę nowej grupy punktów końcowych sieci i wybierz ją.
- Otwórz sekcję Konfiguracje zaawansowane. Dodaj te niestandardowe nagłówki żądania.
Nazwa nagłówka Wartość nagłówka HostG-12345.fps.googX-Forwarded-Country{client_region}X-Forwarded-Region{client_region_subdivision} - Sprawdź pozostałe ustawienia. Do tej integracji nie są wymagane ani Cloud CDN, ani Cloud Armor, więc możesz je bezpiecznie wyłączyć.
- Zapisz nową usługę backendu.
- Określ nazwę, np.
Konfigurowanie reguł routingu
W usłudze równoważenia obciążenia otwórz sekcję Reguły routingu.
Dodaj te reguły hostów i ścieżek:
Host Ścieżka Backend */metrics/*measurement-be-svcZaktualizuj konfigurację systemu równoważenia obciążenia.
W przeglądarce sprawdź konfigurację, otwierając stronę
https://example.com/metrics/healthy. Na stronie powinien znajdować się tekstok. Sprawdź, czy informacje geograficzne są uwzględniane. W tym celu otwórz stronęhttps://example.com/metrics/?validate_geo=healthy. Strona powinna zawierać tekstok.
Cloudflare
Aby wyświetlać tag w bramie tagów Google dla reklamodawców, musisz utworzyć wpis CNAME dla nowej subdomeny, utworzyć regułę pochodzenia, która będzie przekazywać żądania, oraz utworzyć regułę przekształcania, która będzie zawierać informacje o geolokalizacji. Aby dokończyć konfigurację, musisz mieć abonament Cloudflare Enterprise. Jeśli nie masz planu Enterprise, rozważ skorzystanie z automatycznej konfiguracji Cloudflare.
Tworzenie rekordu CNAME
Wybierz subdomenę, którą chcesz zarezerwować dla wpisu CNAME. Wypełnij poniższe pola, aby wypełnić przykłady w tym dokumencie. Ten rekord CNAME nigdy nie jest udostępniany poza konfiguracją Cloudflare, więc jego nazwa jest dowolna.
CNAME subdomain: fps
- Na karcie DNS otwórz sekcję Rekordy.
- Dodaj nowy rekord o tej konfiguracji:
- Jako Typ wybierz CNAME.
- Ustaw Nazwę na
fps. - Ustaw Cel na
G-12345.fps.goog.
- Zapisz rekord CNAME.
Tworzenie reguły źródła
- Na karcie Reguły otwórz Reguły dotyczące źródła i utwórz regułę.
- Wpisz nazwę reguły, np.
Route measurement. - Dopasuj przychodzące żądania na podstawie niestandardowego wyrażenia filtra i kliknij Edytuj wyrażenie.
- Wklej w kreatorze to wyrażenie:
(http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics")) - Zmień Nagłówek hosta na Przepisz na....
G-12345.fps.goog. - Zmień rekord DNS na Zastąp przez….
fps.example.com. - Zapisz regułę dotyczącą źródła.
- Jeśli istnieją inne reguły pochodzenia, zwiększ pozycję nowo utworzonej reguły, aby była ona wykonywana po wszystkich innych ścieżkach z wieloznacznikiem.
- W przeglądarce sprawdź konfigurację, otwierając stronę
https://example.com/metrics/healthy. Na stronie powinno być widoczneok.
Dołączanie informacji o geolokalizacji
- Na karcie Reguły otwórz Ustawienia.
- Włącz opcję Dodaj nagłówki lokalizacji odwiedzającego.
- Zaczekaj kilka minut, aż reguła się rozpowszechni. W przeglądarce sprawdź konfigurację, otwierając stronę
https://example.com/metrics/?validate_geo=healthy. Strona powinna zawierać tekstok.
Akamai
Aby tag był obsługiwany w bramie tagów Google dla reklamodawców, musisz dodać w usłudze nową regułę, która będzie przekazywać żądania i dodawać informacje o geolokalizacji.
Tworzenie reguły przekierowania
- Utwórz nową wersję konfiguracji dostarczania w Menedżerze usług
- W sekcji Ustawienia konfiguracji usługi dodaj nowy
Rule.- Wpisz nazwę, np.
Route measurement
- Wpisz nazwę, np.
- Dodawanie nowego dopasowania
- W menu dopasowania wybierz kolejno Ścieżka i jest jedną z tych.
- Ustaw wartość dopasowania na
/metrics/*
- Dodaj nowe zachowanie.
- Wybierz Standard Property Behavior (Standardowe zachowanie usługi) i kliknij Origin Server (Serwer źródłowy).
- Ustaw Nazwa hosta serwera źródłowego na
G-12345.fps.goog. - Ustaw opcję Forward Host Header (Przekaż nagłówek hosta) na Origin Hostname (Nazwa hosta źródłowego).
- Zapisz nową regułę i wdróż zmiany.
- Przed wdrożeniem w środowisku produkcyjnym przetestuj nową regułę przekierowania w środowisku testowym.
- Wskazówka: upewnij się, że nie masz żadnych reguł, które modyfikują lub usuwają nagłówki odpowiedzi wychodzących. Może to spowodować niepowodzenie skryptów Google, jeśli brakuje nagłówka odpowiedzi
Content-Type.
Dołączanie informacji o geolokalizacji
W sekcji Ustawienia konfiguracji usługi wybierz regułę przekierowania (utworzoną powyżej).
Dodawanie nowego zachowania
- Wybierz Standard Property Behavior (Standardowe działanie usługi) i Content Targeting (EdgeScape) (Kierowanie na treść (EdgeScape)).
- Ustaw opcję Włącz na
true.
Zapisz nowe działanie i wdroż zmiany.
- Przed wdrożeniem w środowisku produkcyjnym przetestuj nową regułę przekierowania w środowisku testowym.
W przeglądarce sprawdź konfigurację, otwierając stronę
https://example.com/metrics/healthy. Na stronie powinien znajdować się tekstok. Sprawdź, czy informacje geograficzne są uwzględniane. W tym celu otwórz stronęhttps://example.com/metrics/?validate_geo=healthy. Strona powinna zawierać tekstok.
Inne
Aby wyświetlać tag w bramie tagu Google dla reklamodawców, musisz skonfigurować sieć CDN lub moduł równoważenia obciążenia, aby kierować żądania do punktu końcowego bramy tagu Google dla reklamodawców.
- Dodaj punkt początkowy lub końcowy wskazujący
G-12345.fps.goog. - Zastąp nagłówek Host wartością
G-12345.fps.goog. Zezwalaj na przekazywanie wszystkich plików cookie i ciągów zapytań. - Przekaż informacje o geolokalizacji użytkownika, dodając jeden z tych nagłówków:
X-Forwarded-CountryRegion– kraj i region użytkownika w postaci pojedynczego kodu ISO 3166-2 (np.US-CA).X-Forwarded-CountryiX-Forwarded-Region:X-Forwarded-Country– kraj użytkownika w formacie kodu ISO 3166-1 alfa-2 (np.US).- (Opcjonalnie)
X-Forwarded-Region– kod podziału administracyjnego regionu użytkownika (np.CA).
- Jeśli dołączysz oba zestawy nagłówków, zostanie użyty nagłówek
X-Forwarded-CountryRegion.
- Dodaj regułę ścieżki dla
/metrics/*, aby kierować ruch do bramy tagów Google dla reklamodawców. - Skonfiguruj zarezerwowaną ścieżkę tak, aby miała wyższy priorytet niż reguła domyślna.
- W przeglądarce sprawdź konfigurację, otwierając stronę
https://example.com/metrics/healthy. Na stronie powinno być widoczneok.
Krok 3. Zaktualizuj skrypty w witrynie, aby korzystać ze ścieżki pomiaru
Zastąp skrypty na każdej stronie witryny jednym z tych skryptów:
gtag.js
U góry sekcji <head> znajdź 2 wiersze skryptu z identyfikatorem tagu Google:
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>
i zastąp je ścieżką pomiaru:
<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>
gtm.js
U góry sekcji <head> zastąp fragment kodu Menedżera tagów tym kodem:
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->
Testowanie konfiguracji pomiaru
Aby przetestować konfigurację pomiarów, skonfiguruj kontener tak, aby zawierał co najmniej 1 tag, który się uruchamia.
- Otwórz Tag Assistant i wyświetl podgląd kontenera.
- Poruszaj się po witrynie, aby wywołać zdarzenia.
Na karcie Podsumowanie > Dane wyjściowe > Wysłane działania sprawdź, czy działania są kierowane na adres
/metrics.