Wysyłanie danych do Menedżera tagów po stronie serwera

W tym artykule opisujemy różne sposoby wysyłania zdarzeń do kontenera po stronie serwera. Jeśli potrzebujesz dodatkowych informacji, zobacz, jak działa tagowanie po stronie serwera.

W tym artykule omówiono następujące tematy:

  • Wysyłanie danych z witryny do kontenera po stronie serwera
  • Wysyłaj dodatkowe dane do kontenera serwera
  • Odbieranie danych w kontenerze po stronie serwera
  • Wysyłaj dane ze źródeł innych niż witryny

Zanim zaczniesz

W tym przewodniku zakładamy, że masz już:

1. Wysyłanie danych z witryny do kontenera po stronie serwera

Dane możesz kierować przez implementację po stronie serwera za pomocą Menedżera tagów lub tagu Google (gtag.js). Wybierz opcję implementacji.

Wybierz opcję implementacji.

Opcjonalnie: wysyłaj dodatkowe parametry z każdym zdarzeniem

Możesz przesyłać dodatkowe 2 rodzaje parametrów dodatkowych: parametry na poziomie konfiguracji i parametry na poziomie zdarzenia. Parametry konfiguracji wpływają na działanie tagu Google i można je ustawiać tylko na poziomie tagu Google.

Parametry zdarzenia określają dodatkowe informacje o zdarzeniu i można je ustawić w przypadku wszystkich zdarzeń albo wybranych zdarzeń lub zdarzeń page_view.

Wybierz opcję implementacji.

2. Odbieranie danych w kontenerze po stronie serwera

Gdy wysyłasz żądanie HTTP do kontenera serwera, klient musi je zgłosić.

Aby wyświetlić listę dostępnych klientów:

  1. Otwórz Menedżera tagów Google

  2. Otwórz kontener serwera.

  3. Na pasku nawigacyjnym po lewej stronie kliknij Klienci. Klient GA4 jest domyślnie zainstalowany w kontenerze po stronie serwera. Jeśli musisz korzystać z Universal Analytics, skonfiguruj klienta Google Analytics: Universal Analytics.

  4. Kliknij nazwę klienta, aby wyświetlić lub edytować szczegóły.

Opcjonalne ustawienia klienta

W większości przypadków klient nie będzie wymagał żadnych modyfikacji. Twój przypadek użycia może się jednak różnić i chcesz zmienić jedno z tych ustawień:

  • Priorytet: określa kolejność uruchamiania klientów. Najpierw uruchamiane są wyższe numery, a pierwszy klient, który pasuje do przychodzącego żądania, staje się aktywnym klientem w ramach tego żądania.

  • Kryteria aktywacji: kryteria aktywacji określają, kiedy klient odpowiada na żądania:

    • Klienci korzystający z UA: Domyślne ścieżki Universal Analytics: klient zostanie aktywowany, gdy ścieżki żądań będą zawierać ścieżki /collect, /r/collect i inne podobne ścieżki używane przez pliki JavaScript wysyłające dane do Google Analytics. To ustawienie jest domyślnie aktywne.

    • Domyślne ścieżki gtag.js dla określonych identyfikatorów: użyj tego ustawienia, aby włączyć wyświetlanie skryptów JavaScript gtag.js poprzez adres URL kontenera serwera. Po włączeniu tej opcji ten klient zostanie aktywowany w odpowiedzi na żądania wysyłane do domyślnych ścieżek żądań gtag.js, np. /gtag/js?id=TAG_ID. Kliknij Dodaj identyfikator pomiaru, aby dodać co najmniej 1 identyfikator miejsca docelowego.

Opcjonalnie: odbieranie dodatkowych danych w Menedżerze tagów po stronie serwera

Jeśli wysyłasz dodatkowe parametry, musisz skonfigurować klienta Google Analytics 4 w kontenerze serwera, aby analizować dodatkowe parametry i tworzyć na ich podstawie dane zdarzeń.

Niektóre tagi serwera bez konieczności konfigurowania zawierają dodatkowe parametry w żądaniach wychodzących. Aby wykluczyć te parametry, utwórz Przekształcenie w celu usunięcia wartości.

Aby użyć dodatkowych parametrów w innych tagach:

  1. W kontenerze serwera kliknij Zmienne w menu nawigacyjnym po lewej stronie.
  2. Utwórz nową zmienną zdefiniowaną przez użytkownika.
  3. W sekcji Konfiguracja zmiennej wybierz typ zmiennej Dane zdarzenia.
  4. W polu Ścieżka klucza wpisz nazwę parametru.
  5. Nazwij zmienną i kliknij Zapisz.

Teraz możesz używać parametru zdarzenia w dowolnym tagu w kontenerze serwera.

3. Opcjonalnie: wysyłanie danych ze źródeł innych niż witryny

Korzystając z platformy Measurement Protocol w Google Analytics, można włączyć obsługę tagowania po stronie serwera ze źródeł takich jak aplikacje mobilne i aplikacje serwer-serwer.

Aplikacje mobilne

Aby aplikacja na Androida lub iOS wysyłała dane do kontenera serwera, utwórz niestandardowy tag graficzny i skonfiguruj go do korzystania z platformy Measurement Protocol:

  1. W kontenerze mobilnym (Android lub iOS) kliknij Tagi > Nowy.
  2. W sekcji Konfiguracja tagu wybierz typ tagu Obraz niestandardowy.
  3. Ustaw wartość Image URL na obraz pikselowy w kontenerze serwera na podanej wcześniej ścieżce klienta Measurement Protocol. Dodaj wybrane parametry platformy Measurement Protocol na końcu adresu URL piksela:
    https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. Odznacz Włącz pomijanie pamięci podręcznej.
  5. Zapisz tag i opublikuj kontener.
  6. W kontenerze po stronie serwera kliknij Klienci > Nowi.
  7. W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
  8. Ustaw Ścieżka aktywacji na ścieżkę do punktu końcowego kolekcji aplikacji.
  9. Zapisz konfigurację klienta i opublikuj kontener po stronie serwera.

Aplikacje między serwerami

Aby wysyłać dane protokołu Measurement Protocol do kontenera serwera, zastąp nazwę hosta www.google-analytics.com nazwą domeny swojego kontenera serwera. Na przykład:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Aby otrzymywać działania Measurement Protocol, skonfiguruj instalację Menedżera tagów po stronie serwera za pomocą klienta Measurement Protocol:

  1. W kontenerze po stronie serwera kliknij Klienci > Nowi.
  2. W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
  3. Ustaw Ścieżka aktywacji na ścieżkę punktu końcowego serwera.
  4. Zapisz konfigurację klienta i opublikuj kontener.

Dalsze kroki

Aby wysyłać dane w prawdziwym kontekście, musisz udostępniać skrypty Google, np. biblioteka Google Analytics, z własnych serwerów.

Wczytywanie skryptów Google przez serwer