Zdarzenia zalecane i niestandardowe w Google Analytics

Interfejsu Data Manager API możesz używać do wysyłania zalecanych i niestandardowych zdarzeń Google Analytics.

Wysyłanie zdarzeń zalecanych i niestandardowycharrow_forward

Jeśli przechodzisz z platformy Measurement Protocol w Google Analytics, instrukcje znajdziesz w artykule Przejście z platformy Measurement Protocol na interfejs Data Manager API.

Omówienie procesu

Aby wysyłać dane zdarzeń za pomocą interfejsu Data Manager API, wykonaj te czynności:

1. Przygotuj miejsca docelowe: zdefiniuj obiekty Destination dla pola destinations żądania pozyskiwania, aby określić konto docelowe i miejsce docelowe konwersji lub zdarzenia. Szczegółowe informacje znajdziesz w artykule Przygotowywanie miejsc docelowych.

2. Przygotuj dane zdarzeń i identyfikatory: wypełnij pola Event szczegółami zdarzeń i wymaganymi identyfikatorami (np. identyfikatorami kliknięć reklam, klientów lub instancji aplikacji). Jeśli w obiekcie userData podajesz informacje kontaktowe użytkownika, znormalizuj i zaszyfruj identyfikatory za pomocą algorytmu SHA-256 zgodnie z wytycznymi dotyczącymi formatowania, a opcjonalnie możesz je też zaszyfrować. Szczegółowe informacje znajdziesz w artykule Przygotowywanie danych zdarzeń.

3. Utwórz i wyślij żądanie pozyskania: prześlij żądanie events.ingest zawierające destinations, rekordy Event i encryptionInfo, jeśli zaszyfrowano userData. Zanim wyślesz dane produkcyjne, użyj validateOnly: true, aby przetestować ładunek pod kątem błędów typu fast-fail. Wymagania dotyczące pól i przykładowe kody znajdziesz w artykule Wysyłanie zdarzeń.

4. Sprawdzanie diagnostyki: pobierz diagnostykę przetwarzania asynchronicznego i sprawdź stan pozyskiwania za pomocą requestStatus.retrieve.

Przypadki użycia

Oto kilka przypadków użycia, w których warto wysyłać zalecane i niestandardowe zdarzenia 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łasne dane o klientach, takie jak zaszyfrowane adresy e-mail, numery telefonów i adresy pocztowe, możesz wysyłać w polu userData obiektu Event. 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 haszowanie: identyfikatory osobiste (takie jak adres e-mail, numer telefonu, imię i nazwisko oraz adres pocztowy) muszą zostać przed przesłaniem znormalizowane i zahaszowane 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żytkownika.

• Szyfrowanie: możesz opcjonalnie zaszyfrować zaszyfrowane dane użytkownika.

• Identyfikator użytkownika: zalecamy podawanie parametru userId razem z parametrem userData, 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.

Możesz też wysyłać dane przekazywane przez użytkowników, aby włączyć dopasowywanie własnych list odbiorców.

Identyfikatory reklamowe

Google Analytics automatycznie łączy identyfikatory wyświetlania reklam (takie jak 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 interfejsu Data Manager API z interakcjami online za pomocą parametru clientId lub appInstanceId, aby stosować ustawienia prywatności użytkownika, 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 informacje o urządzeniu,

Google Analytics automatycznie łączy najnowsze informacje geograficzne i informacje o urządzeniu z tagowania ze zdarzeniami interfejsu Data Manager API za pomocą clientId lub appInstanceId. Dzięki temu zdarzenia interfejsu Data Manager API będą uwzględniane w raportach zawierających wymiary geograficzne i wymiary dotyczące urządzeń.

Jeśli chcesz, aby zdarzenie interfejsu Data Manager API odzwierciedlało informacje geograficzne i informacje o urządzeniu z konkretnej sesji, a nie najnowsze informacje o clientId lub appInstanceId, dodaj wpis w additionalEventParameters, w którym parameterName ma wartość session_id, a value ma wartość identyfikatora konkretnej sesji, i wyślij zdarzenie w ciągu 24 godzin od rozpoczęcia sesji.

Za pomocą interfejsu Data Manager API możesz podawać informacje geograficzne i informacje o urządzeniu dotyczące zdarzeń.

Pełna integracja typu „serwer-serwer”

Możesz wysyłać zdarzenia do Google Analytics wyłącznie za pomocą interfejsu Data Manager API, ale wtedy możesz mieć dostęp tylko do częściowych raportów. Interfejs Data Manager API służy do wzbogacania dotychczasowych 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 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 aktywują reguł generowania ani zmiany nazwy zdarzeń. Twoja aplikacja powinna implementować logikę wysyłania zdarzeń niestandardowych za pomocą interfejsu Data Manager API, podobnie jak w przypadku reguł skonfigurowanych w interfejsie Google Analytics.