Wysyłanie danych do Menedżera tagów po stronie serwera

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ż:

• Konfigurowanie w Menedżerze tagów kontenera serwera
• Konfigurowanie serwera tagowania

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.

Menedżer tagów gtag.js

Tag Google: GA 4

Aby skonfigurować tag Google do przetwarzania po stronie serwera, musisz dodać adres URL swojego kontenera serwera.

Tworzenie zmiennej konfiguracji dla adresu URL kontenera serwera

1. Otwórz Menedżera tagów Google

2. Wybierz kontener internetowy, który chcesz skonfigurować.

3. Otwórz menu Zmienne.

4. Utwórz nową zmienną zdefiniowaną przez użytkownika typu Tag Google: ustawienia konfiguracji.

5. Dodaj te parametry:

   • Nazwa: server_container_url
   • Wartość: ustaw adres URL kontenera serwera Menedżera tagów.

6. Nazwij zmienną, np. „Adres URL serwera”, i zapisz ją.

Przypisywanie adresu URL kontenera serwera do tagu Google

1. Otwórz menu Tagi .
2. Dodaj nowy tag Google lub zmień istniejący.
3. W sekcji Ustawienia konfiguracji wybierz utworzoną przed chwilą zmienną kontenera serwera.
   Wskazówka: aby zobaczyć, które parametry zostały odziedziczone ze zmiennej ustawień, kliknij Pokaż ustawienia dziedziczone.
4. Aby mieć pewność, że tag Google będzie się uruchamiać przed innymi regułami, kliknij Reguły i użyj reguły Zdarzenie inicjujące – wszystkie strony. Dowiedz się więcej o regułach wyświetlania stron.
5. Zapisz tag i opublikuj kontener.

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.

Parametry konfiguracjiWszystkie zdarzeniaWybierz zdarzeniapage_view zdarzenia

Dowiedz się, jak ponownie używać ustawień konfiguracji w Menedżerze tagów Google.

Aby wysyłać dodatkowe parametry ze wszystkimi zdarzeniami, używaj tych samych ustawień zdarzenia w Menedżerze tagów Google.

Aby wysyłać dodatkowe parametry ze zdarzeniem Google Analytics 4:

1. Do kontenera internetowego dodaj tag zdarzenia Google Analytics 4 lub zmień istniejący tag.
2. Kliknij Parametry zdarzenia > Dodaj wiersz.
3. Dodaj parametr, który ma być wysyłany ze zdarzeniem. Zdefiniowane wstępnie parametry zdarzenia znajdziesz w przewodniku Zalecane zdarzenia.
   • W polu Nazwa pola dodaj nazwę parametru, np. language.
   • W polu Wartość dodaj wartość parametru.

Wskazówka: jeśli wartość powinna być określona podczas wczytywania Menedżera tagów, użyj zmiennej zamiast wartości zakodowanej na stałe.

1. Skonfiguruj regułę tak, aby uruchamiała się w trybie Zdarzenie inicjujące – Wszystkie strony.
2. Zapisz tag i opublikuj kontener.

Aby wysłać parametr w zdarzeniu page_view:

1. W kontenerze internetowym zmodyfikuj istniejący tag Google.

2. Wyłącz domyślną wartość page_view w ustawieniach konfiguracji, dodając nowy parametr:

   • Nazwa: send_page_view
   • Wartość: false

3. Utwórz nowy tag Google Analytics: zdarzenie GA4.

   • Wybierz tag konfiguracji zmodyfikowany w kroku 1.
   • W polu Nazwa zdarzenia wpisz page_view.

4. Dodaj parametr, który ma być wysyłany ze zdarzeniem. Zdefiniowane wstępnie parametry zdarzenia znajdziesz w przewodniku Zalecane zdarzenia. – W polu Nazwa pola dodaj nazwę parametru, np. language.

   • W polu Wartość dodaj wartość parametru.

Wskazówka: jeśli wartość powinna być określona podczas wczytywania Menedżera tagów, użyj zmiennej zamiast wartości zakodowanej na stałe.

1. Skonfiguruj regułę tak, aby uruchamiała się w trybie Zdarzenie inicjujące – Wszystkie strony.
2. Zapisz tag i opublikuj kontener.

2. Odbieranie danych w kontenerze po stronie serwera

Gdy wysyłasz żądanie HTTP do kontenera serwera, klient musi je zgłosić.

Termin kluczowy: „Klienci” to adaptery między oprogramowaniem na urządzeniu użytkownika a kontenerem Menedżera tagów po stronie serwera. Otrzymuje ona dane pomiarowe z urządzenia, przekształca je w jedną lub więcej zdarzeń, przetwarza w kontenerze i pakuje wyniki, aby wysłać je z powrotem na urządzenie.

Aby wyświetlić listę dostępnych klientów:

1. Otwórz Menedżera tagów Google

2. Otwórz kontener serwera.

3. Na pasku nawigacyjnym po lewej stronie kliknij Klienci. Klient GA4 jest domyślnie zainstalowany w kontenerze po stronie serwera.

4. 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.

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:

1. W kontenerze serwera w panelu nawigacyjnym po lewej stronie kliknij Zmienne.
2. Utwórz nową zmienną zdefiniowaną przez użytkownika.
3. W sekcji Konfiguracja zmiennej wybierz typ zmiennej Dane zdarzenia.
4. W polu Ścieżka klucza wpisz nazwę parametru.
5. 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:

1. W kontenerze mobilnym (Android lub iOS) kliknij Tagi > Nowy.
2. W sekcji Konfiguracja tagu wybierz typ tagu Obraz niestandardowy.
3. 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
4. Odznacz opcję Włącz omijanie pamięci podręcznej.
5. Zapisz tag i opublikuj kontener.
6. W kontenerze po stronie serwera kliknij Klienci > Nowy.
7. W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
8. Ustaw ścieżkę aktywacji na ścieżkę punktu końcowego zbierania danych w aplikacji.
9. 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:

1. W kontenerze po stronie serwera kliknij Klienci > Nowy.
2. W sekcji Konfiguracja klienta wybierz typ klienta Measurement Protocol.
3. Ustaw Ścieżka aktywacji na ścieżkę punktu końcowego serwera.
4. 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.

Ładowanie skryptów Google przez mój serwer