W tym dokumencie opisujemy różne sposoby wysyłania zdarzeń do kontenera po stronie serwera. Jeśli potrzebujesz więcej informacji, dowiedz się, jak działa tagowanie po stronie serwera.
Z tego dokumentu 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
W tym przewodniku przyjmujemy założenie, ż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ł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 lub tagu miejsca docelowego Google Analytics i można je ustawić tylko na poziomie tagu Google lub tagu miejsca docelowego Google Analytics.
Parametry zdarzenia określają dodatkowe informacje o zdarzeniu i można je ustawić dla wszystkich zdarzeń, wybranych zdarzeń lub zdarzeń page_view.
Rekomendacje dotyczące konfiguracji
Do wysyłania danych do kontenera serwera zalecamy używanie tagu Google Analytics na stronie internetowej. Ten tag może używać różnych metod transportu, aby zapewnić jak najlepszą dostarczalność zdarzeń. Metody te obejmują m.in.:
- piksel obrazu;
- interfejs 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ść | Cel |
| 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.
Informacje o konkretnych zasadach dotyczących 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 je przejąć.
Aby wyświetlić listę dostępnych klientów:
Otwórz kontener serwera.
Na pasku nawigacyjnym po lewej stronie kliknij Klienci. Klient Google Analytics jest domyślnie fabrycznie 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 modyfikować klienta. Jednak Twój przypadek użycia może być inny i możesz chcieć edytować jedno z tych ustawień:
Priorytet: określa kolejność uruchamiania klientów. Najpierw uruchamiają się klienci z wyższymi numerami, a pierwszy klient, który pasuje do przychodzącego żądania, staje się aktywnym klientem dla tego żądania.
Kryteria aktywacji: kryteria aktywacji określają, 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żerze tagów po stronie serwera
Jeśli wysyłasz dodatkowe parametry, musisz skonfigurować klienta Google Analytics 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 w menu 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 kliknij Zapisz.
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.
Na końcu adresu URL piksela dodaj 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 pole 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 prawdziwym kontekście danych własnych, musisz wyświetlać skrypty Google, takie jak biblioteka Google Analytics, z własnych serwerów.