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
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ę