Użyj mapowań w tabelach, aby zmapować żądanie zbierania danych Measurement Protocol (/mp/collect) na jego odpowiednik 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
Żądanie /mp/collect (Measurement Protocol) |
IngestEventsRequest (interfejs Data Manager API) |
Uwagi |
|---|---|---|
measurement_id (parametr zapytania) |
destinations |
Mapowanie na product_destination_id w przypadku zdarzeń w internecie. Więcej informacji znajdziesz w sekcji Pola docelowe. |
firebase_app_id (parametr zapytania) |
destinations |
Mapuj na product_destination_id w przypadku zdarzeń w aplikacji. Więcej informacji znajdziesz w sekcji Pola docelowe. |
api_secret (parametr zapytania) |
Brak odpowiednika | Aby dowiedzieć się, jak uwierzytelniać żądania w interfejsie Data Manager API, przeczytaj artykuł Konfigurowanie dostępu do interfejsu API. |
consent |
consent |
Ustaw na obiekt Consent. |
events |
events |
Ustaw listę zasobów Event. Szczegółowe informacje znajdziesz w sekcji Pola zdarzenia. |
client_id |
events.client_id |
Wymagany w przypadku zdarzeń w internecie. |
app_instance_id |
events.app_instance_id |
Wymagane 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 to zrobić na poziomie żądania lub w przypadku pojedynczego zdarzenia. W interfejsie Data Manager API nie ma sygnatury czasowej na poziomie żądania. W każdym zdarzeniu ustaw parametr event_timestamp na czas wystąpienia zdarzenia.
Szczegółowe informacje znajdziesz w sekcji Formaty sygnatury czasowej. |
user_properties |
events.user_properties |
Ustaw na obiekt 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ą określane na podstawie sygnatury czasowej zdarzenia ( |
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 to true, ustaw ad_personalization na CONSENT_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 artykule Pola urządzeń. |
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 na dalszych etapach. Jeśli IngestEventsRequest nie powiedzie się (np. z powodu braku wymaganych pól), żadne zdarzenia nie zostaną przetworzone. Musisz wtedy rozwiązać problem i ponownie wysłać żądanie. Więcej informacji znajdziesz w artykule Informacje o błędach interfejsu API. |
/debug/mp/collect |
validate_only |
Ustaw parametr validate_only na wartość true, aby sprawdzać poprawność zdarzeń bez pozyskiwania danych, podobnie jak w przypadku serwera walidacji Measurement Protocol. |
| Brak odpowiednika | encoding |
Wymagany w przypadku przesyłania UserData. Ustaw Encoding używany dla 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, aby określić, dokąd wysyłać dane.
Więcej informacji o miejscach docelowych znajdziesz w artykule Konfigurowanie miejsc docelowych.
Oto jak zmapować pola protokołu Measurement Protocol na odpowiadające im pola w Destination:
| Measurement Protocol | Destination (interfejs Data Manager API) |
Uwagi |
|---|---|---|
measurement_id (parametr zapytania) |
product_destination_id |
Ustaw identyfikator pomiaru strumienia danych z sieci w Google Analytics. |
firebase_app_id (parametr zapytania) |
product_destination_id |
Ustaw identyfikator aplikacji w Firebase strumienia 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 i zwraca błąd INVALID_EVENT_NAME. |
| Brak odpowiednika | event_source |
Ustaw wartość WEB, jeśli zdarzenie zostało wygenerowane w przeglądarce, lub 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 otrzymywać zdarzenie. |
timestamp_micros |
event_timestamp |
Szczegółowe informacje znajdziesz w sekcji Formaty sygnatury czasowej. |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
W Measurement Protocol parametr customer_type jest ustawiony 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 przypadków użycia. 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 |
Użyj pola coupon_codes, aby podać kupony, które zostały zastosowane do koszyka. W przypadku Google Analytics podaj tylko 1 kupon. Są one niezależne od kuponów na poziomie Item, które można ustawić za pomocą atrybutu cart_data.items.additional_item_parameters dla poszczególnych produktów. |
params.session_id |
additional_event_parameters |
Zmapuj na wpis z atrybutem parameter_name ustawionym na session_id. |
params.engagement_time_msec |
additional_event_parameters |
Zmapuj na wpis z atrybutem parameter_name ustawionym na engagement_time_msec. |
Inna kategoria: params |
additional_event_parameters |
Zmapuj inne parametry jako listę obiektów z parametrami |
Pola identyfikatorów użytkownika
Measurement Protocol user_data |
UserIdentifier (interfejs Data Manager API) |
Uwagi |
|---|---|---|
sha256_email_address[] |
email_address |
Ustaw sformatowany i zaszyfrowany adres e-mail. Możesz też zaszyfrować zaszyfrowany adres e-mail. |
sha256_phone_number[] |
phone_number |
Ustaw 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 sformatowane i zaszyfrowane imię. Możesz też zaszyfrować zaszyfrowane imię. |
address[].sha256_last_name |
address.family_name |
Ustaw sformatowane i zaszyfrowane nazwisko. Możesz też zaszyfrować zaszyfrowane nazwisko. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
address.city |
Ustaw na znormalizowaną nazwę miasta. Nie szyfruj tego pola. |
address[].region |
address.administrative_area |
Ustaw znormalizowany region (stan lub prowincję). Nie szyfruj tego pola. |
address[].sha256_street |
address.address_line |
Ustaw sformatowany i zaszyfrowany adres. Możesz też zaszyfrować zaszyfrowany adres pocztowy. |
Pola produktów w przypadku danych koszyka
Measurement Protocol items[] |
Item (interfejs Data Manager API) |
Uwagi |
|---|---|---|
item_id |
item_id |
Parametr wymagany. |
item_name |
additional_item_parameters |
Zmapuj na wpis z atrybutem parameter_name ustawionym na item_name. |
quantity |
quantity |
Parametr wymagany. |
price |
unit_price |
Parametr wymagany. |
| Inne pola elementu | additional_item_parameters |
Zmapuj inne parametry produktu (takie jak |
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 dwuliterowy kod regionu CLDR. |
region_id |
subdivision_code |
Ustaw 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 parametr screen_resolution jest podawany jako ciąg znaków ("1280x720"). W interfejsie Data Manager API wysyłaj parametry screen_height i screen_width jako osobne wartości całkowite. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |