Konfiguracja domeny niestandardowej

Ten artykuł jest przeznaczony dla programistów, którzy chcą hostować tagowanie po stronie serwera w tym samym kontekście własnym co ich witryna. Wyświetlanie z tej samej domeny to sprawdzona metoda, która pozwala wykorzystywać bezpieczeństwo i stabilność zapewniane przez pliki cookie ustawiane przez serwer. Instrukcje poniżej dotyczą konfigurowania obsługi z użyciem tego samego źródła niezależnie od tagu Google zaimplementowanego w Twojej witrynie (gtag.js lub gtm.js).

Gdy po raz pierwszy konfigurujesz serwer tagowania, jest on hostowany w domenie udostępnionej przez dostawcę chmury. Gdy używasz domyślnego punktu końcowego, dane są dostarczane do kontenera serwera, ale działają w kontekście zewnętrznym. Aby korzystać z zalet kontekstu własnego, np. trwałych plików cookie, serwer tagowania i witryna muszą działać w tej samej domenie.

Tabela poniżej pokazuje, jak możesz hostować serwer tagowania, gdy witryna nadrzędna jest hostowana na serwerze www.example.com:

Ta sama domena (sprawdzona metoda) Subdomena Domena domyślna
Przykładowy URL https://www.example.com/metrics https://metrics.example.com https://metrics.run.app
Dostęp do plików cookie ustawionych na serwerze Pełny dostęp do zabezpieczeń i korzyści związanych z trwałością. Pełny dostęp do zabezpieczeń i korzyści związanych z trwałością. Brak. Możesz ustawić tylko pliki cookie JavaScript.
Złożoność konfiguracji Skonfiguruj CDN lub system równoważenia obciążenia, aby przekierowywać żądania. Może być konieczna aktualizacja wpisów DNS. Zaktualizuj wpisy DNS. Jest wstępnie skonfigurowany.

Aby rozpocząć, wybierz opcję implementacji.

Wymagania wstępne

W tym przewodniku przyjęto założenie, że:

  • Konfigurowanie kontenera serwera w Menedżerze tagów
  • Konfigurowanie serwera tagowania
  • Sieć CDN lub system równoważenia obciążenia, który może przekazywać żądania.
  • Jeśli używasz App Engine: serwer tagowania musi działać w wersji 2.2.0 lub nowszej. Aby zapewnić bezpieczeństwo serwera tagowania na przyszłość, przenieś go do Cloud Run.

Konfigurowanie domeny niestandardowej

Możesz skonfigurować kontener serwera tak, aby wykorzystywał ścieżkę znajdującą się w tej samej domenie co Twoja witryna. Jeśli np. witryna obsługuje ruch internetowy pod adresem www.example.com, zarezerwuj na potrzeby kontenera serwera ścieżkę taką jak www.example.com/metrics.

Schemat tagowania po stronie serwera skonfigurowanego w tej samej domenie

1. Wybierz ścieżkę domeny, której chcesz użyć na potrzeby serwera tagowania

Ta ścieżka będzie zarezerwowana dla tej implementacji własnych plików cookie. Wybierz ścieżkę, której jeszcze nie używasz.

Przykłady ścieżek, których możesz użyć: /collect, /metrics, /data

Zanotuj ten ciąg ścieżki. Będziesz go używać w kolejnych krokach zamiast /metrics wszędzie tam, gdzie zobaczysz: /metrics

2. Kieruj ruch do serwera tagowania

Jeśli masz w witrynie skonfigurowaną sieć CDN lub system równoważenia obciążenia, który obsługuje kierowanie ruchu na podstawie ścieżek, przejdź do kroku 4.

  1. Dodaj punkt początkowy lub końcowy wskazujący Twoją witrynę.
  2. Zastąp nagłówek Host nazwą hosta witryny, np. example.com.
  3. Zezwalaj na przekazywanie wszystkich plików cookie i ciągów zapytań. Jeśli na danej platformie nie ma tej opcji, prawdopodobnie jest ona ustawiona domyślnie.
  4. Dodaj inny punkt początkowy lub końcowy wskazujący Twój serwer tagowania. Może to być domena udostępniona przez dostawcę chmury, na przykład metrics.run.app.
  5. Zastąp nagłówek Host tak, aby pasował do domeny podanej powyżej. Zezwalaj na przekazywanie wszystkich plików cookie i ciągów zapytań.
  6. Dodaj regułę ścieżki, np. /metrics/*, aby kierować ruch do serwera tagowania.
  7. Skonfiguruj zarezerwowaną ścieżkę tagowania po stronie serwera tak, aby miała wyższy priorytet niż reguła domyślna.
  8. Zaktualizuj DNS, aby wskazywał sieć CDN lub system równoważenia obciążenia, jeśli jeszcze nie zostało to zrobione. Zastosowanie aktualizacji DNS może trochę potrwać.
  9. Otwórz punkt końcowy /healthy w nowo skonfigurowanej domenie, na przykład https://example.com/metrics/healthy. Powinien pojawić się element ok.

3. Aktualizowanie adresu URL serwera w Menedżerze tagów Google

Musisz zaktualizować konfigurację kontenera serwera, aby mógł on poprawnie rozpoznawać prefiks ścieżki i przetwarzać żądania.

Aby zaktualizować punkt końcowy:

  1. Otwórz Menedżera tagów Google
  2. Otwórz kontener serwera skonfigurowany w tej samej domenie co witryna.
  3. Na karcie Administracja > Ustawienia kontenera usuń wszystkie poprzednie adresy URL. Jest to konieczne, ponieważ wszystkie adresy URL kontenera serwera muszą mieć tę samą ścieżkę.
  4. Kliknij Dodaj URL i wpisz adres URL wraz z prefiksem ścieżki.
  5. Zapisz i wróć do obszaru roboczego.
  6. Kliknij przycisk Podgląd, aby rozpocząć nową sesję debugowania i wysłać żądanie na osobnej karcie.
  7. Kliknij wysłaną prośbę. Upewnij się, że klient potwierdził otrzymanie prośby.

Rozwiązywanie typowych problemów

  1. Podgląd nie pokazuje przychodzących żądań
    1. Otwórz eksplorator logów projektu w chmurze. Sprawdź, czy tagowanie po stronie serwera otrzymuje ruch. Jeśli nie, wykonaj czynności opisane w kroku 1.
    2. Sprawdź, czy sieć CDN lub system równoważenia obciążenia przekierowuje pliki cookie.
    3. Sprawdź, czy masz 1 serwer podglądu i czy serwery tagowania mają ustawioną wartość PREVIEW_SERVER_URL.
    4. Aby sprawdzić, czy serwer podglądu działa, kliknij PREVIEW_SERVER_URL + /healthy. Powinien pojawić się element ok.
  2. Klienci nie odbierają żądań – zaktualizuj adres URL w ustawieniach kontenera, aby używać zarezerwowanej ścieżki. Jeśli adres URL nie zawiera ścieżki lub jeśli ścieżki są różne, klienci nie będą działać prawidłowo.