Do wysyłania zalecanych i niestandardowych zdarzeń Google Analytics używaj interfejsu Data Manager API.
Więcej informacji znajdziesz w artykule Wysyłanie zdarzeń.
Jeśli przechodzisz z platformy Measurement Protocol w Google Analytics, zapoznaj się z instrukcjami w artykule Przechodzenie z platformy Measurement Protocol na interfejs Data Manager API.
Przypadki użycia
Oto kilka zastosowań wysyłania zalecanych i niestandardowych zdarzeń za pomocą interfejsu Data Manager API:
Skojarz działania online z działaniami offline.
Mierzenie interakcji po stronie klienta i po stronie serwera.
Wysyłanie zdarzeń występujących poza standardowymi interakcjami użytkowników, takich jak konwersje offline.
wysyłanie zdarzeń z urządzeń i aplikacji, takich jak kioski i zegarki, w których nie jest dostępne automatyczne zbieranie danych.
Dane przekazywane przez użytkowników
W polu userData elementu Event możesz wysyłać własne dane o klientach, takie jak zahaszowane adresy e-mail, numery telefonów i adresy pocztowe. Pomaga to ulepszać pomiar konwersji, atrybucję i tworzenie list odbiorców w Google Analytics.
Podczas wysyłania danych przekazywanych przez użytkowników pamiętaj o tych kwestiach:
Wysyłane ze zdarzeniami: w interfejsie Data Manager API dane przekazywane przez użytkowników muszą być wysyłane jako część
Event. Samodzielne przesyłanie bez zdarzenia nie jest obsługiwane.Formatowanie i szyfrowanie: przed przesłaniem identyfikatory osobiste (takie jak adres e-mail, numer telefonu, imię i nazwisko oraz adres pocztowy) muszą zostać znormalizowane i zaszyfrowane za pomocą algorytmu SHA-256. Inne pola (takie jak miasto, stan lub prowincja, kod pocztowy i kod kraju) są normalizowane, ale nie są szyfrowane. Aby poznać szczegółowe wymagania, zapoznaj się z przewodnikiem Formatowanie danych użytkowników.
Szyfrowanie: możesz opcjonalnie zaszyfrować zahaszowane dane użytkownika.
Identyfikator użytkownika: zalecamy podawanie parametru
userIdwraz z parametremuserData, gdy tylko dostępny jest spójny identyfikator użytkownika.Implementacja: instrukcje tworzenia żądań znajdziesz w artykule Dodawanie danych przekazywanych przez użytkowników.
Uwagi dotyczące integracji
Korzystając z interfejsu Data Manager API, pamiętaj o tych kwestiach.
Remarketing
Google Analytics obsługuje remarketing na tym samym urządzeniu, gdy włączysz Google Signals. W przypadku remarketingu na różnych urządzeniach wymagany jest parametr userId.
Dodatkowo możesz wysyłać dane przekazywane przez użytkowników, aby włączyć dopasowywanie własnych list odbiorców.
Identyfikatory reklamowe
Google Analytics automatycznie łączy identyfikatory reklamowe (np. GBRAID lub WBRAID) zbierane podczas interakcji online ze zdarzeniami interfejsu Data Manager API za pomocą parametrów clientId lub appInstanceId.
Ustawienia prywatności
Google Analytics łączy zdarzenia z interfejsu Data Manager API z interakcjami online za pomocą clientId lub appInstanceId, aby uwzględniać ustawienia prywatności użytkowników, takie jak „reklamy niespersonalizowane” i „ogranicz śledzenie reklam”.
Ustawienia zgody użytkownika możesz też określać bezpośrednio w każdym zdarzeniu za pomocą obiektu
consent.
Informacje geograficzne i o urządzeniu
Google Analytics automatycznie łączy najnowsze informacje geograficzne i o urządzeniach pochodzące z tagowania ze zdarzeniami interfejsu Data Manager API za pomocą clientId lub appInstanceId.
Dzięki temu zdarzenia interfejsu Data Manager API będą odzwierciedlane w raportach zawierających wymiary geograficzne i wymiary urządzeń.
Jeśli chcesz, aby zdarzenie interfejsu Data Manager API odzwierciedlało informacje geograficzne i o urządzeniu z określonej sesji, a nie najnowsze informacje o clientId lub appInstanceId, uwzględnij wpis w additionalEventParameters z wartością parameterName ustawioną na session_id i wartością value ustawioną na identyfikator określonej sesji, a zdarzenie wyślij w ciągu 24 godzin od rozpoczęcia sesji.
Możesz podawać informacje geograficzne i informacje o urządzeniu dotyczące zdarzeń za pomocą interfejsu Data Manager API.
Pełna integracja typu „serwer-serwer”
Zdarzenia można wysyłać do Google Analytics wyłącznie za pomocą interfejsu Data Manager API, ale w takim przypadku dostępne mogą być tylko częściowe raporty. Interfejs Data Manager API służy do rozszerzania istniejących zdarzeń zbieranych za pomocą gtag, Menedżera tagów lub Firebase. Niektóre nazwy zdarzeń i parametrów są zarezerwowane do użytku w ramach automatycznego zbierania danych i nie można ich wysyłać za pomocą interfejsu Data Manager API.
Generowanie zdarzeń i zmiana ich nazw
Zdarzenia wysyłane za pomocą interfejsu Data Manager API nie wywołują reguł generowania ani zmiany nazwy zdarzeń. Aplikacja powinna implementować logikę wysyłania zdarzeń niestandardowych za pomocą interfejsu Data Manager API, podobnie jak reguły skonfigurowane w interfejsie Google Analytics.