Konfigurowanie bramy tagów Google dla reklamodawców

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:

Przepływ informacji o architekturze bramy 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

  1. Otwórz system równoważenia obciążenia GCP

  2. W usłudze równoważenia obciążenia otwórz sekcję Konfiguracja backendu. Utwórz nową usługę backendu. ustawienia konfiguracji backendu,

  3. 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
      Host G-12345.fps.goog
      X-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.

Konfigurowanie reguł routingu

  1. W usłudze równoważenia obciążenia otwórz sekcję Reguły routingu.

  2. Dodaj te reguły hostów i ścieżek:

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

  3. Zaktualizuj konfigurację systemu równoważenia obciążenia.

  4. 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. Strona powinna zawierać tekst ok.

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
  1. Na karcie DNS otwórz sekcję Rekordy.
  2. Dodaj nowy rekord o tej konfiguracji:
    • Jako Typ wybierz CNAME.
    • Ustaw Nazwę na fps.
    • Ustaw Cel na G-12345.fps.goog.
  3. Zapisz rekord CNAME.

Tworzenie reguły źródła

  1. Na karcie Reguły otwórz Reguły dotyczące źródła i utwórz regułę.
  2. Wpisz nazwę reguły, np. Route measurement.
  3. Dopasuj przychodzące żądania na podstawie niestandardowego wyrażenia filtra i kliknij Edytuj wyrażenie.
  4. Wklej w kreatorze to wyrażenie: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
  5. Zmień Nagłówek hosta na Przepisz na.... G-12345.fps.goog.
  6. Zmień rekord DNS na Zastąp przez…. fps.example.com.
  7. Zapisz regułę dotyczącą źródła.
  8. 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.
  9. W przeglądarce sprawdź konfigurację, otwierając stronę https://example.com/metrics/healthy. Na stronie powinno być widoczne ok.

Dołączanie informacji o geolokalizacji

  1. Na karcie Reguły otwórz Ustawienia.
  2. Włącz opcję Dodaj nagłówki lokalizacji odwiedzającego.
  3. 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ć tekst ok.

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

  1. Utwórz nową wersję konfiguracji dostarczania w Menedżerze usług
  2. W sekcji Ustawienia konfiguracji usługi dodaj nowy Rule.
    • Wpisz nazwę, np. Route measurement
  3. Dodawanie nowego dopasowania
    • W menu dopasowania wybierz kolejno Ścieżkajest jedną z tych.
    • Ustaw wartość dopasowania na /metrics/*
  4. 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).
  5. 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

  1. W sekcji Ustawienia konfiguracji usługi wybierz regułę przekierowania (utworzoną powyżej).

  2. 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.
  3. Zapisz nowe działanie i wdroż zmiany.

    • Przed wdrożeniem w środowisku produkcyjnym przetestuj nową regułę przekierowania w środowisku testowym.
  4. 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. Strona powinna zawierać tekst ok.

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.

  1. Dodaj punkt początkowy lub końcowy wskazujący G-12345.fps.goog.
  2. Zastąp nagłówek Host wartością G-12345.fps.goog. Zezwalaj na przekazywanie wszystkich plików cookie i ciągów zapytań.
  3. 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-CountryX-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.
  4. Dodaj regułę ścieżki dla /metrics/*, aby kierować ruch do bramy tagów Google dla reklamodawców.
  5. Skonfiguruj zarezerwowaną ścieżkę tak, aby miała wyższy priorytet niż reguła domyślna.
  6. W przeglądarce sprawdź konfigurację, otwierając stronę https://example.com/metrics/healthy. Na stronie powinno być widoczne ok.

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.

  1. Otwórz Tag Assistant i wyświetl podgląd kontenera.
  2. Poruszaj się po witrynie, aby wywołać zdarzenia.
  3. Na karcie Podsumowanie > Dane wyjściowe > Wysłane działania sprawdź, czy działania są kierowane na adres /metrics.

    zrzut ekranu potwierdzający konfigurację.