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. Zanim zaczniesz wykonywać czynności opisane w tym artykule, wykonaj wstępną konfigurację tagowania po stronie serwera.

Tematy w tym artykule:

• Wysyłanie danych z witryny do kontenera po stronie serwera
• Odbieranie danych w kontenerze po stronie serwera
• Wczytywanie skryptów Google Analytics z własnego punktu końcowego
• Używanie tagu Google Analytics 4 do wysyłania dodatkowych danych do kontenera serwera
• Wysyłanie danych ze źródeł innych niż strony internetowe

Konfiguracja witryny

Dane możesz kierować przez implementację po stronie serwera za pomocą Menedżera tagów lub tagu Google (gtag.js).

Menedżer tagów

Możesz użyć obsługiwanych tagów, aby kierować dane przez konfigurację po stronie serwera z ustawieniem URL kontenera serwera. URL kontenera serwera określa własny punkt końcowy domeny.

Aby skonfigurować tag do przetwarzania po stronie serwera, dodaj adres URL kontenera serwera:

Google Analytics 4

1. W kontenerze internetowym dodaj tag konfiguracji GA4 lub edytuj istniejący.
2. Zaznacz pole wyboru Wyślij do kontenera serwera.
3. Wpisz URL kontenera serwera w odpowiednim polu tekstowym.
4. Zapisz tag i skonfiguruj regułę tak, aby była uruchamiana przez regułę Wszystkie strony.
5. Opublikuj kontener.

Uwaga: jeśli w sekcji Pola do ustawienia masz już skonfigurowane pole transport_url, możesz wyczyścić pole transport_url.

Universal Analytics

1. W kontenerze internetowym dodaj tag Universal Analytics ze zmienną „Ustawienia Google Analytics” lub użyj istniejącej konfiguracji Universal Analytics.
2. Wybierz Więcej ustawień > Konfiguracja zaawansowana.
3. Zaznacz pole wyboru Ustaw transport.
4. Dodaj adres URL kontenera serwera w polu Transport URL (np. https://<DOMAIN_NAME> to gdzie DOMAIN_NAME to nazwa domeny kontenera serwera).
5. Zapisz tag i skonfiguruj regułę tak, aby uruchamiała się na wszystkich stronach.
6. Opublikuj kontener.

Tag Google (gtag.js)

Jeśli używasz w witrynie tagu gtag.js, zaktualizuj polecenie config, aby wysyłać zdarzenia do kontenera serwera. Dodaj parametr transport_url do istniejącego tagu:

W przypadku tagów Google Analytics 4 i Universal Analytics dodaj do istniejącego tagu parametr transport_url w taki sposób:

gtag('config', 'TARGET-ID', {
  'transport_url': 'https://analytics.example.com',
  'first_party_collection': true,
});

Zastąp TARGET-ID swoim identyfikatorem tagu lub identyfikatorem śledzenia Universal Analytics. Zastąp https://analytics.example.com adresem URL kontenera serwera.

Konfiguracja klienta po stronie serwera

Po ustawieniu adresu URL kontenera serwera dane są wysyłane do klienta w kontenerze po stronie serwera Menedżera tagów. W kontenerze po stronie serwera domyślnie zainstalowane są klienty GA4 i UA, które są domyślnie zainstalowane.

Kluczowy termin: „klienty” to adaptery między oprogramowaniem działającym na urządzeniu użytkownika a kontenerem Menedżera tagów po stronie serwera. Otrzymują dane pomiarowe z urządzenia, przekształcają je w co najmniej jedno zdarzenie, przetwarzają dane w kontenerze i pakują wyniki do zwrócenia na urządzenie.

W kontenerze serwera Menedżera tagów kliknij Klienci po lewej stronie, aby wyświetlić listę klientów. Kliknij nazwę klienta, aby wyświetlić lub edytować szczegóły. W większości przypadków klient nie wymaga wprowadzania żadnych zmian. Istnieją jednak ustawienia, które w niektórych przypadkach mogą wymagać wprowadzenia zmian:

• Priorytet: określa kolejność uruchamiania klientów. Wyższe liczby są uruchamiane jako pierwsze, a pierwszy klient, który pasuje do przychodzącego żądania, jest aktywnym klientem dla tego żądania.

• Kryteria aktywacji: kryteria aktywacji określają, kiedy klient odpowie na żądania:

  • Domyślne ścieżki Universal Analytics: klient aktywuje się, gdy ścieżki żądania zawierają /collect, /r/collect i inne podobne ścieżki używane przez pliki JavaScript, które wysyłają dane do Google Analytics. To ustawienie jest domyślnie aktywne.

  • Domyślne ścieżki gtag.js dla konkretnych identyfikatorów: użyj tego ustawienia, aby włączyć wyświetlanie kodu JavaScript gtag.js przez adres URL kontenera serwera. Po włączeniu 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.

Wczytaj skrypty Google

Aby w pełni wykorzystać możliwości tagowania po stronie serwera, możesz załadować obsługiwane skrypty za pomocą kontenera serwera. To pozwala ograniczyć zaufanie do domeny zewnętrznej.

Aktualizowanie domeny źródłowej tagu gtag.js

Gdy zainstalujesz tag gtag.js, domyślna konfiguracja wczyta biblioteki Analytics z www.googletagmanager.com. Aby wczytać kod Analytics w kontenerze serwera, zmień tę nazwę domeny na domenę kontenera serwera:

<!-- Google tag (gtag.js) -->
<script async src="https://<DOMAIN NAME>/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID');
</script>

Konfiguracja klienta

Aby Twój kontener serwera odpowiadał na żądania wczytania skryptów Google Analytics, musisz wprowadzić w swoich klientach kilka niewielkich modyfikacji:

1. W kontenerze po stronie serwera kliknij Klienci, aby wyświetlić listę klientów.
2. Kliknij nazwę klienta, którego chcesz edytować.
3. Wybierz Domyślne ścieżki gtag.js dla konkretnych identyfikatorów.
4. Kliknij Dodaj identyfikator pomiaru i wpisz go.
5. Zapisz konfigurację klienta i opublikuj kontener.

Aktualizowanie domeny źródłowej gtm.js

Gdy instalujesz gtm.js w swojej witrynie, domyślna konfiguracja wczytuje biblioteki Menedżera tagów Google z www.googletagmanager.com. Aby wczytywać kod Menedżera tagów Google za pomocą kontenera serwera, zmień nazwę tej domeny na domenę kontenera serwera dla skryptu gtm.js i pliku ns.html:

Uwaga: gdy wysyłasz do kontenera serwera dane za pomocą tagu Universal Analytics lub GA4 w kontenerze internetowym Menedżera tagów i udostępniasz ten kontener Menedżera tagów z kontenera serwera, z kontenera serwera wczytywany jest też kod JavaScriptu Universal Analytics lub GA4 (np. analytics.js).

Przed wczytaniem kontenera internetowego Menedżera tagów z kontenera serwera wykonaj czynności opisane powyżej, aby aktywować domyślne ścieżki gtag.js dla określonych identyfikatorów w klientach Google Analytics: GA4 lub Google Analytics: Universal Analytics. Dzięki temu skrypty poszczególnych usług wczytają się poprawnie z kontenera serwera.

Konfiguracja klienta

Aby Twój kontener serwera odpowiadał na żądania wczytywania skryptów Menedżera tagów Google, musisz dodać klienta Menedżera tagów Google: kontener internetowy i wprowadzić zmiany w konfiguracji:

1. W kontenerze po stronie serwera kliknij Klienci, aby wyświetlić listę klientów.
2. W sekcji Klienci kliknij Nowy.
3. Kliknij sekcję Konfiguracja klienta, aby wybrać typ klienta.
4. Z listy dostępnych klientów wybierz Menedżer tagów Google: kontener internetowy.
5. Kliknij Dodaj identyfikator kontenera i wpisz identyfikator kontenera internetowego Menedżera tagów Google. Ten identyfikator musi być zgodny z identyfikatorem użytym we fragmencie kodu HTML widocznym powyżej.
6. Zapisz konfigurację klienta i opublikuj kontener.

Dołącz dodatkowe dane do innych tagów

Na stronie może być wiele tagów, które wysyłają podobne dane do serwera. Zamiast używać osobnych tagów, zalecamy kierowanie danych do kontenera serwera za pomocą tagów Google Analytics 4 za pomocą Menedżera tagów lub gtag.js. W tagu możesz określić dodatkowe parametry zdarzenia, a potem użyć ich w kontenerze po stronie serwera do wyodrębnienia parametrów. Pozwala to zmniejszyć ilość kodu JavaScript na stronie i zminimalizować liczbę żądań HTTP, a co za tym idzie, może zwiększyć wydajność witryny.

Menedżer tagów

Jeśli chcesz przesyłać wszystkie zdarzenia (np. unikalny identyfikator), dodaj je do pól „Pola do ustawienia” w tagu Google Analytics 4:

1. W kontenerze internetowym dodaj tag konfiguracji Google Analytics 4 lub edytuj istniejący.
2. Kliknij Pola do ustawienia > Dodaj wiersz.
3. Dodaj do tabeli nazwa/wartość parametru, który chcesz wyświetlać w każdym zdarzeniu.
4. Skonfiguruj regułę, która będzie uruchamiana na wszystkich stronach, a następnie zapisz tag.

Jeśli chcesz wysyłać parametry związane ze zdarzeniami, dodaj je w sekcji Parametry zdarzenia w tagu zdarzenia Google Analytics 4.

1. W kontenerze internetowym dodaj tag zdarzenia Google Analytics 4 lub edytuj istniejący.
2. Kliknij Parametry zdarzenia > Dodaj wiersz.
3. Dodaj parametr do tabeli nazwa/wartość parametru.
4. Skonfiguruj regułę i zapisz tag.

Uwaga: jeśli chcesz wysyłać niektóre parametry tylko w przypadku zdarzenia page_view, odznacz opcję Wyślij zdarzenie wyświetlenia strony po załadowaniu tej konfiguracji w tagu konfiguracji Google Analytics 4, a potem utwórz tag Google Analytics 4 z nazwą zdarzenia page_view.

gtag.js

Przy użyciu interfejsu API gtag.js możesz określać dodatkowe parametry, dodając je jako parametry poleceń. Więcej informacji znajdziesz w dokumentacji interfejsu API gtag.js.

Aby skonfigurować parametry wszystkich zdarzeń:

gtag('config', 'TAG_ID', {
  'transport_url': 'https://analytics.example.com',
  'first_party_collection': true,
  'custom_parameter': 'value',
});

Aby skonfigurować parametry niektórych zdarzeń:

gtag('event', 'event_name', {
  'custom_parameter': 'value',
});

Aby skonfigurować wysyłanie parametrów tylko do zdarzeń page_view, dodaj parametr send_page_view z wartością false w poleceniu config i dodaj osobne zdarzenie page_view.

gtag('config', 'TAG_ID', {
  'transport_url': 'https://analytics.example.com',
  'first_party_collection': true,
  'send_page_view': false,
});
gtag('event', 'page_view', {
  'custom_parameter': 'value',
});

Odbieranie dodatkowych danych w Menedżerze tagów po stronie serwera

Klient Google Analytics 4 w kontenerze serwera przeanalizuje dodatkowe parametry i skonfiguruje je w danych zdarzenia. Aby użyć tych danych w innych tagach, zalecamy utworzenie zmiennej Dane zdarzenia i podanie nazwy parametru w ścieżce klucza. Możesz teraz używać tej zmiennej w każdym tagu, który potrzebuje tego parametru.

Wysyłanie danych z innych źródeł

Korzystając z platformy Measurement Protocol w Google Analytics, możesz obsługiwać tagowanie po stronie serwera pochodzące np. z aplikacji mobilnych i aplikacji serwer-serwer.

Aplikacje mobilne

Aby Twoja aplikacja na Androida lub iOS mogła wysyłać dane do kontenera serwera, musisz utworzyć niestandardowy tag graficzny i skonfigurować go do korzystania z platformy Measurement Protocol:

1. W kontenerze na urządzenia mobilne (z Androidem lub iOS) kliknij Tagi > Nowy.
2. W sekcji Konfiguracja tagu wybierz typ tagu Obraz niestandardowy.
3. Jako Adres URL obrazu ustaw obraz piksela na kontener serwera w określonej wcześniej ścieżce klienta Measurement Protocol. Dodaj odpowiednie parametry Measurement Protocol na końcu 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 Włącz pomijanie 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żka aktywacji na ścieżkę punktu końcowego kolekcji aplikacji.
9. Zapisz konfigurację klienta i opublikuj kontener po stronie serwera.

Aplikacje między serwerami

Aby wysłać dane platformy Measurement Protocol do kontenera serwera, zastąp nazwę hosta www.google-analytics.com nazwą domeny kontenera serwera. 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 klienta 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ę do punktu końcowego serwera.
4. Zapisz konfigurację klienta i opublikuj kontener.