Mapowanie pól

Skorzystaj z mapowań w tabelach, aby przypisać element UploadClickConversionRequest w interfejsie Google Ads API do jego odpowiednika IngestEventsRequest w interfejsie Data Manager API.

Pola żądania

`UploadClickConversionRequest` (interfejs Google Ads API)	`IngestEventsRequest` (Data Manager API)	Uwagi
`customer_id` nagłówek żądania `developer-token` nagłówek żądania `login-customer_id` nagłówek żądania `linked-customer-id` `conversion_action`	`destinations`	Zobacz pola klienta i działania powodującego konwersję.
Brak odpowiednika	`consent`	Opcjonalne domyślne ustawienia dotyczące zgody na potrzeby zdarzeń w żądaniu. Możesz zastąpić tę wartość w przypadku poszczególnych zdarzeń, ustawiając pole `consent` w `Event`.
Brak odpowiednika	`encoding`	Wymagane: ustaw na `Encoding` używany w przypadku wartości `UserIdentifier`.
Brak odpowiednika	`encryption_info`	Określ, czy żądanie zawiera zaszyfrowane wartości. Więcej informacji znajdziesz w sekcji Szyfrowanie.
`job_id`	Brak odpowiednika	Użyj parametru `request_id` zwróconego w odpowiedzi, aby pobrać diagnostykę.
`partial_failure`	Brak odpowiednika	Interfejs Data Manager API nie obsługuje częściowych błędów. Jeśli weryfikacja któregokolwiek pola w `IngestEventsRequest` się nie powiedzie, interfejs Data Manager API odrzuci całe żądanie.
`validate_only`	`validate_only`
`conversions`	`events`	Lista konwersji lub zdarzeń. Szczegółowe informacje znajdziesz w sekcji dotyczącej pól konwersji.

Pola klienta i działania powodującego konwersję

Interfejs Google Ads API wymaga developer-tokennagłówka żądania, a nagłówki żądania login-customer-id i linked-customer-id ustawiasz w różnych scenariuszach uwierzytelniania.

Interfejs Data Manager API nie wymaga tokena programisty. Informacje o logowaniu i powiązanym kliencie podajesz w polach obiektu Destination zamiast w nagłówkach żądania. Więcej informacji o miejscach docelowych znajdziesz w artykule Konfigurowanie miejsc docelowych.

Aby zmapować pola interfejsu Google Ads API dla pojedynczego conversion_action na odpowiednie pola w Destination, wykonaj te czynności:

Interfejs Google Ads API	`Destination` (Data Manager API)	Uwagi
`customer_id` prośby	`operating_account`	Ustaw wartość `account_id` na identyfikator klienta konta konwersji Google Ads. Ustaw wartość `account_type` w polu `operating_account` na `GOOGLE_ADS`. Interfejs Data Manager API może wymagać innego identyfikatora klienta niż ten, którego używasz w interfejsie Google Ads API. Więcej informacji znajdziesz w artykule Różnice w wymaganiach dotyczących konta docelowego.
nagłówek żądania `developer-token`	Brak odpowiednika	Token programisty nie jest wymagany w przypadku interfejsu Data Manager API.
nagłówek żądania `login-customer-id`	`login_account`	Ustaw `account_id` na identyfikator klienta konta logowania. Ustaw wartość `account_type` na `GOOGLE_ADS`, jeśli konto logowania jest kontem Google Ads, lub `DATA_PARTNER`, jeśli jest to konto partnera danych.
nagłówek żądania `linked-customer-id`	`linked_account`	Ustaw `account_id` na identyfikator klienta połączonego konta. Ustaw wartość `account_type` na `DATA_PARTNER`.
`conversion_action` z `ClickConversion`	`product_destination_id`	Ustaw na numeryczny identyfikator działania powodującego konwersję. Nie używaj nazwy zasobu `ConversionAction`.
Brak odpowiednika	`reference`	Identyfikator zdefiniowany przez użytkownika dla `Destination`. Ustaw to pole, jeśli wysyłasz konwersje dla wielu działań powodujących konwersję w jednym żądaniu.

Pola konwersji

`ClickConversion` (interfejs Google Ads API)	`Event` (Data Manager API)	Uwagi
`cart_data`	`cart_data`	Więcej informacji znajdziesz w sekcji Pola danych koszyka.
`consent`	`consent`	Oba interfejsy API używają podobnego obiektu `Consent` (`ad_user_data`, `ad_personalization`). W przypadku interfejsu Data Manager API możesz też ustawić zgodę na wszystkie zdarzenia w żądaniu, ustawiając pole `consent` na poziomie żądania.
`conversion_action`	`destination_references`	Jeśli wysyłasz konwersje dla wielu działań powodujących konwersję w jednym żądaniu, ustaw w tym polu odpowiedni `reference` miejsca docelowego.
`conversion_date_time`	`event_timestamp`	Jeśli używasz formatu JSON, ustaw wartość w formacie RFC 3339, który nieznacznie różni się od formatu daty i godziny w interfejsie Google Ads API. 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.
`conversion_environment`	Brak odpowiednika
`conversion_value`	`conversion_value`	Ustaw wartość waluty, a nie wartość w mikrojednostkach. Na przykład w przypadku wartości konwersji wynoszącej 5,23 zł użyj wartości `5.23`.
`currency_code`	`currency`
`custom_variables`	`custom_variables`	Szczegółowe informacje znajdziesz w sekcji Pola zmiennych niestandardowych.
`customer_type`
Brak odpowiednika	`event_source`
Brak odpowiednika	`event_device_info`
`external_attribution_data`	Brak odpowiednika
`gbraid`	`ad_identifiers.gbraid`
`gclid`	`ad_identifiers.gclid`
Brak odpowiednika	`last_updated_timestamp`
`order_id`	`transaction_id`
`session_attributes_encoded`	`ad_identifiers.session_attributes`	Szczegółowe informacje znajdziesz w artykule Dodawanie atrybutów sesji.
`session_attributes_key_value_pairs`	`experimental_fields`	Szczegółowe informacje znajdziesz w artykule Dodawanie atrybutów sesji.
`user_identifiers`	`user_data.user_identifiers`	Więcej informacji znajdziesz w sekcji Pola identyfikatorów użytkownika.
`user_ip_address`	`landing_page_device_info.ip_address`
`wbraid`	`ad_identifiers.wbraid`

Pola danych koszyka

`CartData` (interfejs Google Ads API)	`CartData` (Data Manager API)	Uwagi
`feed_country_code`	`merchant_feed_label`	Ustaw na etykietę pliku danych.
`feed_language_code`	`merchant_feed_language_code`
`items`	`items`
`local_transaction_cost`	`transaction_discount`
`merchant_id`	`merchant_id`

Pola produktów w danych koszyka

`Item` (interfejs Google Ads API)	`Item` (Data Manager API)	Uwagi
`product_id`	`merchant_product_id`
`quantity`	`quantity`
`unit_price`	`unit_price`
Brak odpowiednika	`item_id`
Brak odpowiednika	`additional_item_parameters`

Pola zmiennych niestandardowych

`CustomVariable` (interfejs Google Ads API)	`CustomVariable` (Data Manager API)	Uwagi
Brak odpowiednika	`destination_references`	Interfejs Google Ads API wymaga oddzielnych żądań dla każdego działania powodującego konwersję. Interfejs Data Manager API umożliwia wysyłanie konwersji dla wielu działań powodujących konwersję w ramach jednego żądania, a także używanie tego pola `destination_references` do wskazywania, które miejsca docelowe powinny otrzymywać konkretną zmienną niestandardową.
`conversion_custom_variable`	`variable`	Ustaw na nazwę zmiennej zamiast nazwy zasobu.
`value`	`value`

Pola identyfikatorów użytkownika

`UserIdentifier` (interfejs Google Ads API)	`UserIdentifier` (Data Manager API)
`address_info`	`address`	Postępuj zgodnie z wytycznymi dotyczącymi formatowania i szyfrowania. Możesz też zaszyfrować zahaszowane atrybuty adresu.
`hashed_email`	`email_address`	Ustaw na sformatowany i zahaszowany adres e-mail. Możesz też zaszyfrować zahaszowany adres e-mail.
`hashed_phone_number`	`phone_number`	Ustaw na sformatowany i zahaszowany numer telefonu. Możesz też zaszyfrować zahaszowany numer telefonu.
Inne pola: `mobile_id` `third_party_user_id` `user_identifier_source`	Nietrafna	Żaden z tych interfejsów API nie obsługuje tych identyfikatorów w przypadku konwersji offline ani konwersji rozszerzonych dotyczących potencjalnych klientów. Interfejs Data Manager API nie obsługuje tych identyfikatorów podczas wysyłania zdarzeń powodujących konwersję jako dodatkowego źródła danych.

Pola odpowiedzi

`UploadClickConversionResponse` (interfejs Google Ads API)	`IngestEventsResponse` (Data Manager API)	Uwagi
`job_id`	Brak odpowiednika	Użyj parametru `request_id` zwróconego w odpowiedzi, aby pobrać diagnostykę.
`partial_failure_error`	Brak odpowiednika	Interfejs Data Manager API nie obsługuje częściowych błędów. Jeśli weryfikacja któregokolwiek pola w `IngestEventsRequest` się nie powiedzie, interfejs Data Manager API odrzuci całe żądanie.
`request-id` nagłówek odpowiedzi	`request_id`	Identyfikator żądania jest zwracany jako pole odpowiedzi w interfejsie Data Manager API, a nie jako nagłówek odpowiedzi.
`results`	Brak odpowiednika	Interfejs Data Manager API przetwarza zdarzenia asynchronicznie. Sprawdź wyniki przetwarzania za pomocą diagnostyki.

Wstecz

Przejście na nową wersję