Odniesienie do platformy Measurement Protocol

Omówienie

Przesyłanie danych do Google Analytics za pomocą narzędzia Pomiarowe składa się z 2 etapów: Protokół:

  1. Transport – gdzie i jak wysyłane są dane
  2. Ładunek – dane wysyłane przez Ciebie

W tym dokumencie opisano formatowanie transportu i ładunku.

Transport

Punkt końcowy URL

Dane wysyłasz za pomocą Measurement Protocol, wysyłając żądania HTTP POST do ten punkt końcowy:

https://www.google-analytics.com/mp/collect

Aby wysłać zdarzenie, wyślij to żądanie POST:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

Kody odpowiedzi

Measurement Protocol zawsze zwraca kod stanu 2xx, jeśli HTTP odebrano żądanie. Measurement Protocol nie zwraca kodu błędu, jeśli: dane ładunku były uszkodzone, dane w ładunku były nieprawidłowe lub nie została przetworzona przez Google Analytics.

Ładunek

.

Dane są przesyłane do Google Analytics za pomocą danych platformy Measurement Protocol w 2 elementach: części:

  1. Parametry zapytania
  2. Treść typu JSON o nazwie POST

parametry zapytania

Nazwa parametru Opis

api_secret

Wymagane. API Secret generowany przez w interfejsie Google Analytics.

Aby utworzyć nowy obiekt tajny, przejdź w interfejsie Google Analytics do:
Administracja > Strumienie danych > wybierz transmisję &gt; Measurement Protocol > Utwórz

Zalecamy, aby zachować te informacje jako prywatne dla organizacji. Jeśli wdrożysz Measurement Protocol po stronie klienta, regularnie zmieniać sekwencję reklam na api_secret, aby uniknąć nadmiernego spamu.

Treść posta JSON

Klucz Typ Opis

user_id

 string

Opcjonalnie: Unikalny identyfikator użytkownika. Patrz sekcja User-ID analizy na wielu platformach.

timestamp_micros

 number

Opcjonalnie: Sygnatura czasowa uniksowa (w mikrosekundach) określająca czas powiązania wraz z wydarzeniem. To ustawienie należy skonfigurować tylko w celu rejestrowania zdarzeń, które miały miejsce w przeszłości. Ta wartość może zostać zastąpiona przez: user_property lub sygnatury czasowe zdarzenia. Zdarzenia mogą być wsteczne maksymalnie 3 dni kalendarzowe zależnie od strefy czasowej usługi.

user_properties

 object Opcjonalnie: Właściwości użytkownika na potrzeby pomiaru. Patrz sekcja Użytkownik usługi, aby dowiedzieć się więcej.
object Opcjonalnie: Określa ustawienia dotyczące zgody dla danego żądania. Więcej informacji znajdziesz w sekcji dotyczącej uzyskiwania zgody.

non_personalized_ads

 boolean Opcjonalnie: Ustaw jako true, aby wskazać, że dane użytkownika nie powinny być mogą być wykorzystywane do wyświetlania reklam spersonalizowanych.

events[]

 array Wymagane. Tablica elementów zdarzenia. Jednorazowo można wysłać do 25 zdarzeń użytkownika. Zobacz wydarzenia odniesienia do wszystkich prawidłowych zdarzeń.

events[].name

 string Wymagane. Nazwa zdarzenia. Zobacz wydarzenia zawiera opis wszystkich opcji.

events[].params

 object Opcjonalnie: Parametry zdarzenia. Zobacz wydarzenia dla sugerowanych parametrów każdego zdarzenia.

Atrybut consent umożliwia skonfigurowanie typów i stanów zgody na przetwarzanie danych. Jeśli nie określisz wartości consent, Google Analytics użyje zgody użytkownika ustawień na podstawie odpowiednich interakcji online z klientem lub wystąpieniem aplikacji.

Klucz Typ Opis

ad_user_data

 string

Opcjonalne. Określa stan zgody na wysyłanie danych użytkownika z tagu żądania zdarzeń i właściwości użytkownika w celach reklamowych.

Musi to być wartość GRANTED lub DENIED.

ad_personalization

 string

Opcjonalne. Określa stan zgody użytkownika na reklamy spersonalizowane.

Musi to być wartość GRANTED lub DENIED.

Parametry niestandardowe

Oprócz określonych parametrów możesz też dodać niestandardowy ograniczony do użytkownika, ograniczony do zdarzenia lub produktu w ładunku Measurement Protocol.

  • Parametry niestandardowe ograniczone do użytkownika można umieścić w obiekcie user_properties ładunku.
  • Parametr events[].params może zawierać parametry niestandardowe ograniczone do zdarzenia. ładunek.
  • Parametry niestandardowe ograniczone do produktu można umieszczać w parametrze Tablica items dla każdego zdarzenia.

Niektóre zdarzenia mają zalecane parametry. Sprawdź zalecane wydarzenia dla wszystkich obsługiwanych zdarzeń.

Zarezerwowane nazwy

Zarezerwowane nazwy zdarzeń

Te nazwy zdarzeń są zarezerwowane i nie można ich używać:

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_clear_data
  • app_exception
  • app_install
  • app_remove
  • app_store_refund
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_campaign
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • user_engagement

Zastrzeżone nazwy parametrów

Ta nazwa parametru jest zarezerwowana i nie można jej używać:

  • firebase_conversion

Poza tym nazwy parametrów nie mogą się zaczynać od:

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Zarezerwowane nazwy właściwości użytkownika

Te nazwy właściwości użytkownika są zarezerwowane i nie można ich używać:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Oprócz tego nazwy właściwości użytkownika nie mogą się zaczynać od:

  • _ (underscore)
  • firebase_
  • ga_
  • google_