Z tego artykułu dowiesz się, jak wysyłać zdarzenia do kontenera po stronie serwera. Jeśli chcesz dowiedzieć się więcej, przeczytaj artykuł o tagowaniu 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ż strony internetowe
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 mogą być ustawiane 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 zaakceptować.
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 wstępnie 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 klient nie będzie musiał wprowadzać żadnych zmian. Jednak Twój przypadek użycia może być inny i możesz chcieć 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. Aby dodać co najmniej 1 identyfikator miejsca docelowego, kliknij Dodaj identyfikator pomiaru.
- 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: otrzymywanie dodatkowych danych w Menedżer 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 menu 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ą.
Teraz możesz używać parametru zdarzenia w dowolnym innym tagu w kontenerze serwera.
3. Opcjonalnie: wysyłanie danych ze źródeł innych niż strony internetowe
Platformy Measurement Protocol Google Analytics można używać do włączania obsługi tagowania po stronie serwera z źródeł takich jak aplikacje mobilne i aplikacje serwer-serwer. Ta opcja umożliwia wysyłanie zdarzeń do kontenera w formacie Measurement Protocol. Kontener wysyła te zdarzenia do Google Analytics za pomocą tego samego mechanizmu co wszystkie inne zdarzenia tagowania stron.
Ta opcja nie obsługuje wszystkich funkcji interfejsu Measurement Protocol, np. wyodrębniania informacji geograficznych i informacje o urządzeniu ze zdarzeń z tagowaniem.
Aplikacje mobilne
Aby aplikacja na Androida lub iOS mogła wysyłać dane do kontenera serwera, musisz utworzyć niestandardowy tag obrazu i skonfigurować 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 (Adres 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 zbioru danych 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ć rekordy Measurement Protocol, skonfiguruj 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żkę 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.