Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Konfigurowanie bramy tagów Google dla reklamodawców

Ten dokument jest przeznaczony dla użytkowników, którzy chcą wdrożyć bramę tagów 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 za pomocą własnej infrastruktury, 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 wysyła żądanie tagu Google do 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 zostaną wysłane do Google z użyciem Twojej domeny własnej.

Ten diagram przedstawia przepływ informacji w bramie tagów Google dla reklamodawców:

Przepływ informacji o architekturze bramy tagów Google dla reklamodawców.

Zanim zaczniesz

W tym przewodniku przyjęto założenie, że w Twojej witrynie są 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ę pomiarową w domenie swojej witryny, aby obsługiwać każdy tag lub kontener 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 używasz 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 tagów	Punkt końcowy pochodzenia
Tag samodzielny 1	`G-12345`	`/abjfo/`	`g-12345.fps.goog`
Samodzielny lokalizator Tag 2	`G-67890`	`/fjdso/`	`g-67890.fps.goog`
Kontener GTM	`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ć pojedynczy 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ę w przypadku każdego wystąpienia. Dotyczy to sytuacji, gdy prowadzisz:

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ć unikalną ścieżkę obsługi tagów do każdego kontenera lub 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żone położenie geograficzne osoby odwiedzającej witrynę oraz utworzyć reguły routingu w dotychczasowym zewnętrznym systemie równoważenia obciążenia aplikacji.

Tworzenie nowego backendu

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 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 Czas oczekiwania.
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 opcję Pełna i jednoznaczna nazwa domeny na G-12345.fps.goog.
- Kliknij UTWÓRZ, aby utworzyć punkt końcowy.
- Zamknij kartę Grupa punktów końcowych sieci, aby wrócić do karty Nowa usługa backendu.
Odszukaj nazwę nowej grupy punktów końcowych sieci i wybierz ją.

Otwórz sekcję Konfiguracje zaawansowane. Dodaj te niestandardowe nagłówki żądań.

Nazwa nagłówka	Wartość nagłówka
`Host`	`G-12345.fps.goog`
`X-Forwarded-CountryRegion`	`{client_region_subdivision}`
`X-Forwarded-Geolocation`	`latlong={client_city_lat_long};city={client_city}`

Sprawdź pozostałe ustawienia. Ta integracja nie wymaga ani Cloud CDN, ani Cloud Armor, więc możesz bezpiecznie wyłączyć obie te usługi.
Zapisz nową usługę backendu.

Konfigurowanie reguł routingu

W systemie równoważenia obciążenia otwórz sekcję Reguły routingu.
Dodaj te reguły hosta i ścieżki:

Host Ścieżka Backend

* /metrics/* measurement-be-svc
Zaktualizuj konfigurację systemu równoważenia obciążenia.
W przeglądarce sprawdź konfigurację, otwierając stronę https://example.com/metrics/healthy. Strona powinna zawierać tekst ok. Sprawdź, czy informacje geograficzne są uwzględniane. W tym celu otwórz stronę https://example.com/metrics/?validate_geo=healthy. Strona powinna zawierać tekst ok.

Host	Ścieżka	Backend
`*`	`/metrics/*`	`measurement-be-svc`

Cloudflare

Aby tag był wyświetlany w bramie tagów Google dla reklamodawców, możesz użyć fragmentów kodu Cloudflare do przekazywania żądań.

Tworzenie fragmentu kodu

W panelu Cloudflare kliknij Strona główna konta > example.com > Reguły > Fragmenty kodu.
Kliknij Utwórz krótki opis.
Wpisz nazwę fragmentu kodu, która zawiera identyfikator tagu (np.google_tag_gateway_gtm_1234). Nazwa może zawierać tylko małe litery, cyfry i podkreślenia, więc zastąp wszystkie łączniki (-) w identyfikatorze tagu podkreśleniami (_).
Zastąp symbol zastępczy G-12345 konkretnym identyfikatorem tagu Google.

Wklej podany fragment kodu do edytora:

export default {
  async fetch(request) {
    const newRequest = new Request(request);
    const url = new URL(request.url);
    url.hostname = 'fps.goog';
    newRequest.headers.set('X-Gtg-Implementation', 'Snippet');
    newRequest.headers.set('X-Gtg-Tag-Id', 'G-12345');
    newRequest.headers.append('X-Forwarded-For', request.headers.get('CF-Connecting-IP'));
    newRequest.headers.set('X-Forwarded-Country', request.cf.country);
    newRequest.headers.set('X-Forwarded-Region', request.cf.regionCode);
    newRequest.headers.set(
      'X-Forwarded-Geolocation',
      `latlong=${request.cf.latitude},${request.cf.longitude};` +
        `city=${request.cf.city}`,
    );
    return await fetch(url, newRequest);
  },
};

Kliknij Reguła dotycząca fragmentu kodu, aby przejść na stronę konfiguracji.

Konfigurowanie reguły dotyczącej fragmentu kodu

Na stronie reguły dotyczącej fragmentu kodu wybierz Niestandardowe wyrażenie filtra.
Kliknij Edytuj wyrażenie i wklej to wyrażenie:(starts_with(http.request.uri.path, "/metrics/"))
Aby zapisać regułę dotyczącą fragmentu kodu, kliknij Gotowe.
Aby aktywować fragment kodu, kliknij Wdróż.
W przeglądarce sprawdź konfigurację, otwierając stronę https://example.com/metrics/healthy. Strona powinna zawierać tekst ok. Sprawdź, czy informacje geograficzne są uwzględniane. W tym celu otwórz stronę https://example.com/metrics/?validate_geo=healthy. Strona powinna zawierać tekst ok.

Akamai

Aby tag był wyświetlany 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 wyświetlania w menedżerze usługi (Property Manager).
W sekcji Ustawienia konfiguracji usługi dodaj nowy parametr Rule.
- Wpisz nazwę, np. Route measurement
Dodaj nowe dopasowanie (Match)
- Ustaw menu dopasowania na opcje Ścieżka i jest jednym z.
- Ustaw wartość dopasowania na /metrics/*
Dodawanie nowego zachowania (Behavior)
- Wybierz opcję Standard Property Behavior (Standardowe zachowanie usługi) oraz zachowanie Origin Server (Serwer źródłowy).
- Ustaw opcję Origin Server Hostname (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 wprowadź zmiany
- Przed wdrożeniem w środowisku produkcyjnym przetestuj nową regułę przekierowania w środowisku testowym.
- Wskazówka: upewnij się, że masz żadnych reguł, które modyfikują lub usuwają nagłówki odpowiedzi wychodzących. Jeśli w nagłówku odpowiedzi brakuje wartości Content-Type, skrypty Google mogą nie działać prawidłowo.

Dołączanie informacji o geolokalizacji

W sekcji Ustawienia konfiguracji usługi wybierz utworzoną wyżej regułę przekierowywania.
Dodawanie nowego zachowania (Behavior)
- Wybierz opcję Standard Property Behavior (Standardowe zachowanie usługi), a następnie zachowanie Content Targeting (EdgeScape) (Kierowanie na treść (EdgeScape)).
- Ustaw opcję Włącz na true.
Zapisz nowe zachowanie i wprowadź 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. Strona powinna zawierać tekst ok. Sprawdź, czy informacje geograficzne są uwzględniane. W tym celu otwórz stronę https://example.com/metrics/?validate_geo=healthy. Strona powinna zawierać tekst ok.

Amazon CloudFront

Aby tag był wyświetlany w bramie tagów Google dla reklamodawców, musisz skonfigurować swoją dystrybucję tak, aby przekazywała żądania i dodawała informacje o geolokalizacji.

Dodawanie nowego pochodzenia

Otwórz stronę CloudFront w Amazon Web Services (AWS).
Wybierz dystrybucję (Distribution) CloudFront.
Na karcie Origins (Pochodzenie) utwórz pochodzenie z tymi ustawieniami:
- Ustaw opcję Origin domain (Domena pochodzenia) na G-12345.fps.goog.
- Ustaw opcję Protocol (Protokół) na HTTPS Only (Tylko HTTPS).

Tworzenie zachowania przekierowania

Otwórz stronę CloudFront w AWS.
Wybierz dystrybucję (Distribution) CloudFront.
Na karcie Behaviors (Zachowania) utwórz nowe zachowanie z tymi ustawieniami:
- Ustaw opcję Path pattern (Wzorzec ścieżki) na /metrics/*.
- Ustaw opcję Origin and origin groups (Pochodzenie i grupy pochodzenia) na G-12345.fps.goog.
- Ustaw opcję Compress objects automatically (Automatycznie kompresuj obiekty) na No (Nie).
- Ustaw opcję Viewer protocol policy (Zasady protokołu użytkownika) na HTTPS only (Tylko HTTPS).
- Ustaw opcję Allowed HTTP Methods (Dozwolone metody HTTP) na GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE.
- W sekcji Cache key and origin requests (Klucz pamięci podręcznej i żądania pochodzenia) wybierz opcję Cache policy and origin request policy (Zasada pamięci podręcznej i zasada żądania pochodzenia).
  - Ustaw opcję Cache policy (Zasady pamięci podręcznej) na CachingDisabled.
  - Ustaw opcję Origin request policy (Zasady żądania pochodzenia) na AllViewerExceptHostHeader.
Na liście Behavior (Zachowanie) sprawdź, czy wartość Precedence nowego zachowania jest wyższa niż wszystkich pozostałych zachowań.
- Aby zmienić wartość Precedence, wybierz zachowanie i klikaj przycisk Przesuń w górę, aż znajdzie się ono powyżej wszystkich innych zachowań.
W przeglądarce sprawdź konfigurację, otwierając stronę https://example.com/metrics/healthy. Na stronie powinien znajdować się tekst ok.

Dołączanie informacji o geolokalizacji

Aby przekazać niezbędne informacje o geolokalizacji, w zachowaniu przekierowania ustaw wartość Headers (Nagłówki) na AllViewerExceptHostHeader.
- Pełna lista nagłówków lokalizacji użytkownika CloudFront znajduje się w tym artykule.
Poczekaj kilka minut na wdrożenie dystrybucji. W przeglądarce sprawdź konfigurację, otwierając stronę:https://example.com/metrics/?validate_geo=healthy. Na stronie powinien znajdować się tekst ok.

Fastly

Aby tag był wyświetlany w bramie tagów Google dla reklamodawców, musisz skonfigurować usługę CDN Fastly tak, aby przekazywała żądania i dodawała informacje o geolokalizacji. Proces ten obejmuje utworzenie 1 warunku, 1 hosta i 2 fragmentów kodu VCL.

Tworzenie warunku i hosta

Najpierw skonfiguruj warunek, który będzie identyfikować żądania dotyczące bramy oraz hosta, który będzie kierować je do Google.

Utwórz nowy Condition (Warunek) z tym ustawieniem:
- Type (Typ): Request
- Name (Nazwa): Google Tag Gateway Path (lub inna wybrana nazwa)
- Zastosuj, jeśli…:req.url.path ~ "^/metrics"
Utwórz nowego Hosta z tymi ustawieniami:
- Nazwa/adres hosta: fps.goog
Skonfiguruj nowego Hosta z tymi ustawieniami dodatkowymi:
- Kliknij Dołącz warunek i wybierz warunek utworzony w kroku 1.
- Ustaw opcję Override host (Zastąp hosta) na fps.goog.
- W pozostałych ustawieniach pozostaw wartości domyślne.
- Aby zapisać hosta, kliknij Aktualizuj.

Dodawanie identyfikatora tagu Google i nagłówków geolokalizacji

W kolejnym kroku dodajesz fragmenty kodu VCL (Varnish Configuration Language), aby dołączyć identyfikator tagu Google i dane geolokalizacyjne klienta. Musisz utworzyć 2 osobne fragmenty kodu – jeden dla vcl_miss i jeden dla vcl_pass – używając dokładnie tego samego kodu.

W usłudze otwórz opcję VCL Snippets (Fragmenty kodu VCL) i utwórz fragment kodu z tymi polami:

Name (Nazwa): Geo_MISS (lub inna wybrana nazwa)
Miejsce docelowe: Within Subroutine
Subroutine: vcl_miss

VCL:

if (req.url.path ~ "^/metrics") {
  set bereq.http.X-Gtg-Tag-Id = "G-12345";
  set bereq.http.X-Forwarded-Country = client.geo.country_code;
  set bereq.http.X-Forwarded-Region = client.geo.region;
  set bereq.http.X-Forwarded-Geolocation = "latlong=" +
    client.geo.latitude + "," + client.geo.longitude + ";city=" +
    client.geo.city;
}

Utwórz kolejny fragment kodu z tymi polami:
- Name (Nazwa): Geo_PASS (lub inna wybrana nazwa)
- Type (Typ): vcl_pass
- VCL:
```
if (req.url.path ~ "^/metrics") {
  set bereq.http.X-Gtg-Tag-Id = "G-12345";
  set bereq.http.X-Forwarded-Country = client.geo.country_code;
  set bereq.http.X-Forwarded-Region = client.geo.region;
  set bereq.http.X-Forwarded-Geolocation = "latlong=" +
    client.geo.latitude + "," + client.geo.longitude + ";city=" +
    client.geo.city;
}
```
Powinny pojawić się 2 nowe, oddzielne fragmenty kodu. Dzięki temu nagłówki geolokalizacji są dodawane do każdego żądania, które musi zostać pobrane z Twojego hosta, niezależnie od tego, czy wystąpił brak w pamięci podręcznej („cache miss”) (vcl_miss), czy pominięcie pamięci podręcznej („cache pass”) (vcl_pass).

Aktywowanie i weryfikowanie pełnej konfiguracji

Po utworzeniu hosta, warunku i fragmentów kodu VCL możesz aktywować i przetestować kompletną konfigurację.

Aby wdrożyć wszystkie nowe zmiany, kliknij Activate (Aktywuj).
Sprawdź konfigurację, uruchamiając oba testy w przeglądarce:
- Test 1 (Tag & Routing): otwórz stronę https://example.com/metrics/healthy
- Test 2 (Geolocation): otwórz stronę https://example.com/metrics/?validate_geo=healthy
Obie strony powinny zawierać tekst ok.

Inne

Aby tag był wyświetlany w bramie tagów Google dla reklamodawców, musisz skonfigurować sieć CDN lub system równoważenia obciążenia tak, aby kierować żądania do punktu końcowego bramy tagów 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-Country i X-Forwarded-Region:
  - X-Forwarded-Country – kraj użytkownika w formacie kodu ISO 3166-1 alfa-2 (np. US).
  - X-Forwarded-Region – kod regionu administracyjnego użytkownika (np. CA).
- Jeśli dołączysz oba zestawy nagłówków, użyty zostanie parametr 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 powinien znajdować się tekst ok. Sprawdź, czy informacje geograficzne są uwzględniane. W tym celu otwórz stronę https://example.com/metrics/?validate_geo=healthy. Na stronie powinien znajdować się tekst ok.

Krok 3. Zaktualizuj skrypty w witrynie, aby korzystały ze ścieżki pomiaru

Zastąp skrypty na każdej stronie witryny jednym z tych kodów:

gtag.js

W górnej części sekcji <head> znajdź 2 wiersze skryptu z identyfikatorem tagu Google:

<!-- Google tag (gtag.js) -->
<script async src="//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

W górnej części 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ę pomiaru, 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 do /metrics.

Konfigurowanie bramy tagów Google dla reklamodawców Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Przegląd

Zanim zaczniesz

1. Wybieranie ścieżek pomiaru

Menedżer tagów Google:

Jak obsługiwać wiele tagów lub kontenerów:

2. Kierowanie ruchu

Google Cloud

Tworzenie nowego backendu

Konfigurowanie reguł routingu

Cloudflare

Tworzenie fragmentu kodu

Konfigurowanie reguły dotyczącej fragmentu kodu

Akamai

Tworzenie reguły przekierowania

Dołączanie informacji o geolokalizacji

Amazon CloudFront

Dodawanie nowego pochodzenia

Tworzenie zachowania przekierowania

Dołączanie informacji o geolokalizacji

Fastly

Tworzenie warunku i hosta

Dodawanie identyfikatora tagu Google i nagłówków geolokalizacji

Aktywowanie i weryfikowanie pełnej konfiguracji

Inne

Krok 3. Zaktualizuj skrypty w witrynie, aby korzystały ze ścieżki pomiaru

gtag.js

gtm.js

Testowanie konfiguracji pomiaru

Konfigurowanie bramy tagów Google dla reklamodawców