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.
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
.
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:
Otwórz kontener serwera.
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.
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:
- W kontenerze serwera kliknij Zmienne w menu nawigacyjnym po lewej stronie.
- Utwórz nową zmienną zdefiniowaną przez użytkownika.
- W sekcji Konfiguracja zmiennej wybierz typ zmiennej Dane zdarzenia.
- W polu Ścieżka klucza wpisz nazwę parametru.
- 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:
- W kontenerze mobilnym (Android lub iOS) kliknij Tagi > Nowy.
- W sekcji Konfiguracja tagu wybierz typ tagu Obraz niestandardowy.
- 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
- Odznacz Włącz pomijanie pamięci podręcznej.
- Zapisz tag i opublikuj kontener.
- W kontenerze po stronie serwera kliknij Klienci > Nowi.
- W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
- Ustaw Ścieżka aktywacji na ścieżkę do punktu końcowego kolekcji aplikacji.
- 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:
- W kontenerze po stronie serwera kliknij Klienci > Nowi.
- W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
- Ustaw Ścieżka aktywacji na ścieżkę punktu końcowego serwera.
- 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.