Mapowanie pól

Skorzystaj z mapowań w tabelach, aby przypisać żądanie zbierania danych Measurement Protocol (/mp/collect) do jego odpowiednika w IngestEventsRequest w interfejsie Data Manager 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 aplikacjach. 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 artykułem 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ń ze stron internetowych.
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 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. 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 Szczegółowe informacje 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 oraz błędy i ostrzeżenia dotyczące poszczególnych zdarzeń podczas przetwarzania w dalszej kolejności. Jeśli IngestEventsRequest się nie powiedzie (np. z powodu brakujących pól wymaganych), ż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

Platforma 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 wartość account_id na identyfikator usługi w Google Analytics. Ustaw wartość account_type na GOOGLE_ANALYTICS_PROPERTY.
Brak odpowiednika login_account Ustaw wartość account_id na identyfikator usługi w Google Analytics. Ustaw wartość 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 usługę Google Analytics Destination. 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 Konwertowanie danych na obiekty Event.
params.items cart_data.items Więcej informacji znajdziesz w artykule Pola produktów w danych koszyka.
params.coupon cart_data.coupon_codes W polu coupon_codes podaj 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 dla poszczególnych produktów.
params.session_id additional_event_parameters Mapa do wpisu, w którym wartość parameter_name to session_id.
params.engagement_time_msec additional_event_parameters Mapowanie do wpisu, w którym pole parameter_name ma wartość engagement_time_msec.
Inna kategoria: params additional_event_parameters

Zmapuj inne parametry jako listę obiektów z polami 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 Ustaw na sformatowane i zaszyfrowane imię. Możesz też zaszyfrować zahaszowane imię.
address[].sha256_last_name address.family_name Ustaw na sformatowane i zahaszowane nazwisko. Możesz też zaszyfrować zahaszowaną nazwę rodziny.
address[].country address.region_code
address[].postal_code address.postal_code
address[].city Brak odpowiednika Nie jest obsługiwany w bieżącej wersji interfejsu Data Manager API.
address[].region Brak odpowiednika Nie jest obsługiwany w bieżącej wersji interfejsu Data Manager API.
address[].sha256_street Brak odpowiednika Nie jest obsługiwany w bieżącej wersji interfejsu Data Manager API.

Pola produktów w danych koszyka

Measurement Protocol items[] Item (interfejs Data Manager API) Uwagi
item_id item_id Wymagane.
item_name additional_item_parameters Mapa do wpisu, w którym wartość parameter_name to item_name.
quantity quantity Wymagane.
price unit_price Wymagane.
Inne pola produktu additional_item_parameters

Zmapuj 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 na stronie Item.

Pola lokalizacji użytkownika

Measurement Protocol user_location EventLocation (interfejs Data Manager API) Uwagi
city city Nazwa miasta, w którym wystąpiło zdarzenie.
country_id region_code Ustaw na dwuliterowy kod regionu CLDR.
region_id subdivision_code Ustaw na kod regionu w formacie ISO 3166-2.
continent_id continent_code Ustawiony na kod kontynentu w formacie UN M49.
subcontinent_id subcontinent_code Ustawiony na 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ą przesyłane jako oddzielne 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ę