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

W tym artykule 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 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

Ten przewodnik zakłada, że masz już:

• skonfigurowany kontener serwera w Menedżerze tagów,
• skonfigurowany serwer 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 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.

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 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)

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 przejąć to żądanie.

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. Domyślnie w kontenerze po stronie serwera jest wstępnie zainstalowany klient Google Analytics.

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

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:

1. W kontenerze serwera kliknij Zmienne w menu po lewej stronie.
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. 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 graficzny i skonfiguruj go tak, aby używał 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ść Adres URL obrazu na obraz pikselowy w kontenerze serwera w ścieżce określonej wcześniej w kliencie Measurement Protocol. 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
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 aplikacji.
9. 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:

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

Wczytywanie skryptów Google przez mój serwerarrow_forward