Z tego artykułu dowiesz się, jak wysyłać zdarzenia do kontenera po stronie serwera. Jeśli potrzebujesz więcej ogólnych informacji, zobacz, jak działa tagowanie po stronie serwera.
Z tego artykułu dowiesz się, jak:
- Wysyłanie danych z witryny do kontenera po stronie serwera
- Wysyłanie dodatkowych danych do kontenera serwera
- Odbieranie danych w kontenerze po stronie serwera
- Wysyłanie danych 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 gtag.js. Wybierz opcję implementacji.
Opcjonalnie: wysyłaj dodatkowe parametry z każdym zdarzeniem
Możesz wysyłać 2 typy parametrów dodatkowych: parametry na poziomie konfiguracji i na poziomie zdarzenia. Parametry konfiguracji wpływają na działanie tagu Google i można je ustawiać tylko na poziomie tagu Google.
Parametry zdarzenia podają dodatkowe informacje o zdarzeniu i mogą być ustawiane w przypadku wszystkich zdarzeń, 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.
Kliknij nazwę klienta, aby wyświetlić lub edytować szczegóły.
Opcjonalne ustawienia klienta
W większości przypadków nie trzeba wprowadzać żadnych zmian. Twój przypadek użycia może być jednak inny i warto zmienić jedno z tych ustawień:
Priorytet: określa kolejność uruchamiania klientów. Uruchamianie zaczyna się od najwyższego priorytetu, a pierwszy klient, który pasuje do przychodzącego żądania, staje się aktywnym klientem w przypadku tego żądania.
Kryteria aktywacji: określają one, kiedy klient będzie odpowiadać na żądania:
- Domyślne ścieżki gtag.js dla poszczególnych 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.
- Domyślne ścieżki gtag.js dla poszczególnych 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.
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 przeanalizować dodatkowe parametry i utworzyć na ich podstawie dane zdarzenia.
Niektóre tagi serwera będą zawierać dodatkowe parametry w wysyłanych żądaniach bez konfiguracji. Aby wykluczyć te parametry, utwórz transformację, aby usunąć wartość.
Aby używać dodatkowych parametrów w innych tagach:
- W kontenerze serwera w panelu nawigacyjnym po lewej stronie kliknij Zmienne.
- 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 zapisz ją.
Możesz go teraz używać w dowolnym innym tagu w kontenerze serwera.
3. Opcjonalnie: wysyłanie danych ze źródeł innych niż strony internetowe
Za pomocą platformy Measurement Protocol w Google Analytics można włączyć obsługę tagowania po stronie serwera w przypadku takich źródeł jak aplikacje mobilne i aplikacje między serwerami.
Aplikacje mobilne
Aby aplikacja na Androida lub iOS mogła wysyłać dane do kontenera serwera, utwórz niestandardowy tag obrazu i skonfiguruj go pod kątem 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ść URL obrazu na obraz pikselowy w kontenerze serwera na ścieżce w kliencie protokołu Measurement Protocol, którą podano wcześniej.
Dodaj dowolne parametry 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 opcję Włącz omijanie pamięci podręcznej.
- Zapisz tag i opublikuj kontener.
- W kontenerze po stronie serwera kliknij Klienci > Nowy.
- W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
- Ustaw ścieżkę aktywacji na ścieżkę punktu końcowego zbierania danych w aplikacji.
- Zapisz konfigurację klienta i opublikuj kontener po stronie serwera.
Aplikacje serwer-serwer
Aby wysyłać dane protokołu pomiarowego 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ć trafienia Measurement Protocol, skonfiguruj instalację Menedżera tagów po stronie serwera za pomocą klienta Measurement Protocol:
- W kontenerze po stronie serwera kliknij Klienci > Nowy.
- 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 danych własnych, musisz wyświetlać skrypty Google, takie jak biblioteka Google Analytics, z własnych serwerów.