Mapowanie pól

Użyj mapowań w tabelach, aby przypisać żądanie zbierania danych Measurement Protocol (/mp/collect) do jego odpowiednika IngestEventsRequest w interfejsie Data Manager API.

Uwierzytelnianie

Interfejs Data Manager API wymaga danych logowania OAuth zamiast api_secret. Aby wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API, wykonaj czynności opisane w artykule Konfigurowanie dostępu do interfejsu API.

Pola żądania

/mp/collect żądanie (Measurement Protocol) IngestEventsRequest (interfejs Data Manager API) Uwagi
measurement_id (parametr zapytania) destinations Mapowanie na product_destination_id w przypadku wydarzeń internetowych. Więcej informacji znajdziesz w sekcji Pola miejsca docelowego.
firebase_app_id (parametr zapytania) destinations Mapowanie na product_destination_id w przypadku zdarzeń w aplikacji. Więcej informacji znajdziesz w sekcji Pola miejsca docelowego.
api_secret (parametr zapytania) Brak odpowiednika Aby dowiedzieć się, jak uwierzytelniać żądania w interfejsie Data Manager API, zapoznaj się z sekcją Konfigurowanie dostępu do interfejsu API.
consent consent Ustaw na obiekt Consent.
events events Ustaw na listę zasobów Event. Szczegółowe informacje znajdziesz w sekcji dotyczącej pól zdarzeń.
client_id events.client_id Wymagany w przypadku zdarzeń w internecie.
app_instance_id events.app_instance_id Wymagany w przypadku zdarzeń w aplikacji.
user_id events.user_id Opcjonalnie: unikalny identyfikator użytkownika.
timestamp_micros events.event_timestamp W Measurement Protocol można go podać na poziomie żądania lub pojedynczego zdarzenia. W interfejsie Data Manager API nie ma sygnatury czasowej na poziomie żądania. Ustaw wartość event_timestamp w przypadku każdego zdarzenia na czas jego wystąpienia.
  • Jeśli używasz formatu JSON, ustaw wartość w formacie RFC 3339.
  • Jeśli używasz buforów protokołu, użyj Timestamp i ustaw pola seconds oraz (opcjonalnie) nanoseconds.

Szczegółowe informacje znajdziesz w sekcji Format sygnatury czasowej.
user_properties events.user_properties

Ustaw na obiekt UserProperties. Jeśli wysyłasz typ lub zakres wartości użytkownika, użyj odpowiednio pola customer_type lub customer_value_bucket w parametrze UserProperties. W przypadku innych właściwości użytkownika utwórz osobny obiekt UserProperty, ustaw jego pola property_name i value, a następnie dodaj go do listy additional_user_properties.

Interfejs Data Manager API nie obsługuje ustawiania sygnatur czasowych dla poszczególnych właściwości użytkownika. Sygnatury czasowe powiązane ze zmianami właściwości użytkownika są wywnioskowane na podstawie sygnatury czasowej zdarzenia (event_timestamp).
user_data events.user_data Ustaw na obiekt UserData. Więcej informacji znajdziesz w sekcji Pola identyfikatorów użytkownika.
non_personalized_ads events.consent.ad_personalization Jeśli non_personalized_ads ma wartość true, ustaw ad_personalization na DENIED.
user_location events.event_location Więcej informacji znajdziesz w sekcji Pola lokalizacji użytkownika.
ip_override events.event_device_info.ip_address
device events.event_device_info Więcej informacji znajdziesz w sekcji Pola urządzenia.
user_agent events.event_device_info.user_agent
validation_behavior Brak odpowiednika Użyj Diagnostyki, aby sprawdzić stan przesyłania, a także błędy i ostrzeżenia dotyczące poszczególnych zdarzeń podczas przetwarzania w dalszej kolejności. Jeśli IngestEventsRequest nie powiedzie się (np. z powodu braku wymaganych pól), żadne zdarzenia nie zostaną przetworzone. Musisz rozwiązać problem i ponowić próbę wysłania żądania. Więcej informacji znajdziesz w artykule Wyjaśnienie błędów interfejsu API.
/debug/mp/collect validate_only Ustaw wartość validate_only na true, aby weryfikować zdarzenia bez pozyskiwania danych, podobnie jak w przypadku serwera weryfikacyjnego Measurement Protocol.
Brak odpowiednika encoding Wymagane w przypadku przesyłania plików UserData. Ustaw na Encoding używany w przypadku wartości UserIdentifier.

Pola docelowe

Measurement Protocol wysyła zdarzenia bezpośrednio do konkretnego strumienia danych za pomocą parametru zapytania measurement_id lub firebase_app_id.

Interfejs Data Manager API używa obiektu Destination do określania miejsca, do którego mają być wysyłane dane. Więcej informacji o miejscach docelowych znajdziesz w artykule Konfigurowanie miejsc docelowych.

Aby przypisać pola Measurement Protocol do odpowiednich pól w Destination:

Measurement Protocol Destination (interfejs Data Manager API) Uwagi
measurement_id (parametr zapytania) product_destination_id Ustawiony na identyfikator pomiaru strumienia danych z sieci w Google Analytics.
firebase_app_id (parametr zapytania) product_destination_id Ustawiony na identyfikator aplikacji Firebase w strumieniu danych z aplikacji w Google Analytics.
Brak odpowiednika operating_account Ustaw account_id na identyfikator usługi w Google Analytics. Ustaw account_type na GOOGLE_ANALYTICS_PROPERTY.
Brak odpowiednika login_account Ustaw account_id na identyfikator usługi w Google Analytics. Ustaw account_type na GOOGLE_ANALYTICS_PROPERTY.

Pola zdarzeń

Measurement Protocol events[] Event (interfejs Data Manager API) Uwagi
name event_name Jeśli event_name używa zarezerwowanej nazwy, interfejs API odrzuca zdarzenie z błędem INVALID_EVENT_NAME.
Brak odpowiednika event_source Ustaw wartość WEB, jeśli zdarzenie zostało wygenerowane w przeglądarce internetowej, a wartość APP, jeśli zdarzenie zostało wygenerowane w aplikacji.
Brak odpowiednika destination_references Wymagane, jeśli lista destinations na poziomie żądania zawiera więcej niż 1 Destination Google Analytics. Dodaj wpis, aby określić, które miejsce docelowe ma otrzymać zdarzenie.
timestamp_micros event_timestamp
  • Jeśli używasz formatu JSON, ustaw wartość w formacie RFC 3339.
  • Jeśli używasz buforów protokołu, użyj Timestamp i ustaw pola seconds oraz (opcjonalnie) nanoseconds.

Szczegółowe informacje znajdziesz w sekcji Format sygnatury czasowej.
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type W Measurement Protocol parametr customer_type jest ustawiany jako parametr zdarzenia. W interfejsie Data Manager API ustaw go w polu customer_type w obiekcie UserProperties w zdarzeniu.
params.transaction_id transaction_id Wymagany w przypadku niektórych zdarzeń i zastosowań. Więcej informacji znajdziesz w artykule Przekształcanie danych w Event obiekty.
params.items cart_data.items Więcej informacji znajdziesz w artykule Pola produktów w danych koszyka.
params.coupon cart_data.coupon_codes Użyj pola coupon_codes, aby podać kupony, które zostały zastosowane w koszyku. Podaj tylko 1 kupon na Google Analytics. Jest to niezależne od kuponów na poziomie Item, które można ustawić za pomocą cart_data.items.additional_item_parameters w przypadku poszczególnych produktów.
params.session_id additional_event_parameters Zmapuj wpis z wartością parameter_name ustawioną na session_id.
params.engagement_time_msec additional_event_parameters Zmapuj wpis z wartością parameter_name ustawioną na engagement_time_msec.
Inna kategoria: params additional_event_parameters

Zmapuj inne parametry jako listę obiektów z parameter_name i value.

Uwaga: nie dodawaj tutaj wpisów dla transaction_id, currency ani value. Zamiast tego użyj pól najwyższego poziomu na stronie Event.

Pola identyfikatorów użytkownika

Measurement Protocol user_data UserIdentifier (interfejs Data Manager API) Uwagi
sha256_email_address[] email_address Ustaw na sformatowany i zahaszowany adres e-mail. Możesz też zaszyfrować zahaszowany adres e-mail.
sha256_phone_number[] phone_number Ustaw na sformatowany i zahaszowany numer telefonu. Możesz też zaszyfrować zahaszowany numer telefonu.
address[] address Ustaw na obiekt AddressInfo. Postępuj zgodnie z wytycznymi dotyczącymi formatowania i szyfrowania.
address[].sha256_first_name address.given_name Ustawia sformatowane i zahaszowane imię. Możesz też zaszyfrować zahaszowane imię.
address[].sha256_last_name address.family_name Ustaw na sformatowane i zahaszowane nazwisko. Możesz też zaszyfrować zahaszowane nazwisko.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city address.city Ustaw na znormalizowane miasto. Nie haszuj tego pola.
address[].region address.administrative_area Ustaw na znormalizowany region administracyjny (stan lub województwo). Nie haszuj tego pola.
address[].sha256_street address.address_line Ustawiony na sformatowany i zahaszowany adres ulicy. Możesz też zaszyfrować zahaszowany adres ulicy.

Pola produktów w danych koszyka

Measurement Protocol items[] Item (interfejs Data Manager API) Uwagi
item_id item_id Parametr wymagany.
item_name additional_item_parameters Zmapuj wpis z wartością parameter_name ustawioną na item_name.
quantity quantity Parametr wymagany.
price unit_price Parametr wymagany.
Inne pola produktu additional_item_parameters

Mapuj inne parametry produktu (np. discount, affiliation, item_brand itp.) jako listę obiektów z atrybutami parameter_name i value.

Uwaga: nie dodawaj tutaj wpisów dla quantity, price ani item_id. Zamiast tego użyj pól najwyższego poziomu w Item.

Pola lokalizacji użytkownika

Measurement Protocol user_location EventLocation (interfejs Data Manager API) Uwagi
city city Nazwa miasta, w którym miało miejsce zdarzenie.
country_id region_code Ustaw na 2-literowy kod regionu CLDR.
region_id subdivision_code Ustaw na kod regionu w formacie ISO 3166-2.
continent_id continent_code Ustaw kod kontynentu w formacie UN M49.
subcontinent_id subcontinent_code Ustaw kod subkontynentu w formacie UN M49.

Pola urządzenia

Measurement Protocol device DeviceInfo (interfejs Data Manager API) Uwagi
category category
language language_code
screen_resolution screen_height i screen_width W Measurement Protocol wartość screen_resolution jest podawana jako ciąg znaków ("1280x720"). W interfejsie Data Manager API wartości screen_height i screen_width są wysyłane jako osobne liczby całkowite.
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
Wstecz
Przejście na nową wersję