Zdarzenia zalecane i niestandardowe w Google Analytics

Do wysyłania zalecanych i niestandardowych zdarzeń Google Analytics używaj interfejsu Data Manager API.

Wysyłanie zalecanych i niestandardowych zdarzeń

Jeśli przechodzisz z Measurement Protocol Google Analytics zapoznaj się z instrukcjami w artykule Przejście z Measurement Protocol na interfejs Data Manager API dla instrukcji.

Omówienie przepływu pracy

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

1. Przygotuj miejsca docelowe: zdefiniuj obiekty Destination w polu destinations żądania pozyskiwania, aby określić konto docelowe oraz miejsce docelowe konwersji lub zdarzenia. Więcej informacji znajdziesz w artykule Przygotowywanie miejsc docelowych for details.

2. Przygotuj dane zdarzenia i identyfikatory: wypełnij Event pola szczegółami zdarzenia i wymaganymi identyfikatorami (np. identyfikatorami kliknięcia reklamy, klienta lub instancji aplikacji). Jeśli w polu userData umieszczasz informacje kontaktowe użytkownika, znormalizuj i zaszyfruj identyfikatory za pomocą algorytmu SHA-256 zgodnie z wytycznymi dotyczącymi formatowania, a następnie opcjonalnie je zaszyfruj. Więcej informacji znajdziesz w artykule Przygotowywanie danych zdarzenia.

3. Utwórz i wyślij żądanie pozyskiwania: prześlij żądanie events.ingest zawierające pola destinations, Event oraz pole encryptionInfo, jeśli dane userData zostały zaszyfrowane. Aby przetestować ładunek pod kątem błędów powodujących szybkie przerwanie działania przed wysłaniem danych produkcyjnych, użyj parametru validateOnly: true. Wymagania dotyczące pól i przykłady kodu znajdziesz w artykule Wysyłanie zdarzeń.

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

Przypadki użycia

Ważne: interfejs Data Manager API ma na celu uzupełnienie automatycznego zbierania danych za pomocą tagu gtag, Menedżera tagów i Google Analytics dla Firebase, a nie jego zastąpienie.

Oto kilka przypadków użycia interfejsu Data Manager API do wysyłania zalecanych i niestandardowych zdarzeń:

• 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 obiektu Event możesz wysyłać własne dane o klientach, takie jak zaszyfrowane adresy e-mail, numery telefonów i adresy fizyczne. Pomaga to w poprawie pomiaru konwersji, atrybucji i tworzenia list odbiorców w Google Analytics.

Wysyłając dane przekazywane 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ęść obiektu Event. Samodzielne przesyłanie bez zdarzenia nie jest obsługiwane.

• Formatowanie i szyfrowanie: przed przesłaniem identyfikatory osobowe (takie jak adres e-mail, numer telefonu, imię i nazwisko oraz adres) muszą zostać znormalizowane i zaszyfrowane za pomocą algorytm u SHA-256. Inne pola (takie jak miasto, stan lub województwo, kod pocztowy i kod kraju) są normalizowane, ale nie szyfrowane. Szczegółowe wymagania znajdziesz w przewodniku Formatowanie danych użytkownika.

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

• Identyfikator użytkownika: jeśli dostępny jest spójny identyfikator użytkownika, zalecamy podawanie go w polu userId wraz z polem userData.

• Implementacja: instrukcje tworzenia żądań znajdziesz w artykule Dodawanie danych przekazywanych przez użytkowników.

Kwestie związane z integracją

Korzystając z interfejsu Data Manager API, pamiętaj o tych kwestiach.

Remarketing

Gdy włączysz sygnały Google, Google Analytics będzie obsługiwać remarketing na tym samym urządzeniu. W przypadku remarketingu na różnych urządzeniach userId jest wymagane.

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

Identyfikatory wyświetlania reklam

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ą pól clientId lub appInstanceId.

Ustawienia prywatności

Google Analytics łączy zdarzenia interfejsu Data Manager API z interakcjami online za pomocą 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ślić 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ą pól clientId lub appInstanceId. Dzięki temu zdarzenia interfejsu Data Manager API są uwzględniane w raportach zawierających wymiary geograficzne i wymiary urządzenia.

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 dotyczące clientId lub appInstanceId, dodaj wpis do additionalEventParameters z parameterName ustawionym na session_id i value ustawionym na identyfikator konkretnej sesji, a następnie 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”

Zdarzenia można wysyłać do Google Analytics wyłącznie za pomocą interfejsu Data Manager API, ale może być dostępna tylko częściowa liczba raportów. Interfejs Data Manager API ma na celu uzupełnienie istniejących zdarzeń zbieranych za pomocą tagu 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 i zmienianie nazw zdarzeń

Zdarzenia wysyłane za pomocą interfejsu Data Manager API nie aktywują reguł generowania ani zmieniania nazw zdarzeń. Aplikacja powinna implementować logikę wysyłania zdarzeń niestandardowych za pomocą interfejsu Data Manager API, podobnie jak reguły skonfigurowane w interfejsie Google Analytics.