Z tego artykułu dowiesz się, jak wysyłać zdarzenia do kontenera po stronie serwera. Jeśli potrzebujesz więcej informacji, przeczytaj artykuł Jak działa tagowanie po stronie serwera.
Z tego artykułu dowiesz się, jak:
- wysyłać dane z witryny do kontenera po stronie serwera,
- wysyłać dodatkowe dane do kontenera serwera,
- otrzymywać dane w kontenerze po stronie serwera,
- wysyłać dane ze źródeł innych niż witryny.
Zanim zaczniesz
Z tego przewodnika dowiesz się, ż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 gtag.js. Wybierz opcję implementacji.
Opcjonalnie: wysyłanie dodatkowych parametrów z każdym zdarzeniem
Możesz wysyłać 2 typy dodatkowych parametrów: parametry na poziomie konfiguracji i parametry na poziomie zdarzenia. Parametry konfiguracji wpływają na działanie tagu Google i można je ustawić tylko na poziomie tagu Google.
Parametry zdarzenia określają dodatkowe informacje o zdarzeniu i można je ustawić dla wszystkich zdarzeń, wybranych zdarzeń lub zdarzeń page_view.
Zalecenia dotyczące konfiguracji
Aby wysyłać dane do kontenera serwera, zalecamy używanie tagu GA4 na stronie internetowej. Ten tag może używać różnych metod transportu, aby zapewnić najlepszy współczynnik dostarczania zdarzeń. Metody te obejmują m.in.:
- piksel obrazu,
- Fetch API,
- XHR
- skrypt service worker, który działa w elemencie iframe wczytanym z domeny kontenera serwera.
Aby mieć pewność, że wszystkie metody są obsługiwane, sprawdź te kwestie:
Content Security Policy (CSP)
| Dyrektywa | Treść | Purpose |
| img-src | [SERVER_CONTAINER_URL] | Żądania pomiaru |
| connect-src | [SERVER_CONTAINER_URL] | Żądania pomiaru |
| frame-src | [SERVER_CONTAINER_URL] | Implementacja skryptu service worker |
Ponadto X-Frame-Options nie może ograniczać wczytywania elementów iframe z adresu URL kontenera serwera.
Szczegółowe zasady dotyczące poszczególnych usług znajdziesz na stronie https://developers.google.com/tag-platform/security/guides/csp.
2. Otrzymywanie danych w kontenerze po stronie serwera
Gdy wysyłasz żądanie HTTP do kontenera serwera, klient musi odebrać to żądanie.
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 klient nie będzie wymagał modyfikacji. Może się jednak zdarzyć, że Twój przypadek użycia będzie inny i zechcesz edytować 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ą, kiedy klient będzie odpowiadać na żądania:
- 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.
- 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.
Opcjonalnie: otrzymywanie 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ł z nich dane zdarzenia.
Niektóre tagi serwera będą zawierać dodatkowe parametry w żądaniach wychodzących bez konfiguracji. Aby wykluczyć te parametry, utwórz transformację , która usunie wartość.
Aby używać dodatkowych parametrów w innych tagach:
- W kontenerze serwera kliknij Zmienne w menu 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.
- Nadaj zmiennej nazwę 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ż witryny
Platforma Google Analytics Measurement Protocol umożliwia obsługę tagowania po stronie serwera ze ź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 SGTM.
Ta opcja nie obsługuje wszystkich funkcji punktu końcowego Measurement Protocol, takich jak wyodrębnianie informacji geograficznych i informacji o urządzeniu ze zdarzeń tagowania.
Aplikacje mobilne
Aby aplikacja na Androida lub iOS wysyłała dane do kontenera serwera, utwórz niestandardowy tag obrazu i skonfiguruj go tak, aby używał Measurement Protocol:
- W kontenerze mobilnym (Android lub iOS) kliknij Tagi > Nowy.
- W sekcji Konfiguracja tagu wybierz typ tagu Obraz niestandardowy.
- Ustaw wartość Adres URL obrazu na obraz pikselowy w kontenerze serwera w ścieżce klienta Measurement Protocol określonej wcześniej.
Dołącz do końca adresu URL piksela dowolne parametry Measurement Protocol:
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 aplikacji.
- Zapisz konfigurację klienta i opublikuj kontener po stronie serwera.
Aplikacje serwer-serwer
Aby wysyłać dane Measurement Protocol do kontenera serwera, zastąp nazwę hosta www.google-analytics.com nazwą domeny 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 > 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 kontekście własnym, musisz wyświetlać skrypty Google, takie jak biblioteka Google Analytics, z własnych serwerów.