Mapowanie pól

Użyj mapowań w tabelach, aby zmapować an UploadClickConversionRequest w interfejsie Google Ads API na its IngestEventsRequest odpowiednik w interfejsie Data Manager API.

Pola żądania

UploadClickConversionRequest (interfejs Google Ads API)	IngestEventsRequest (interfejs 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 zgody na potrzeby zdarzeń w żądaniu. Tę wartość możesz zastąpić w przypadku pojedynczego zdarzenia, ustawiając pole consent w Event.
Brak odpowiednika	encoding	Wymagane: ustaw wartość Encoding używaną w przypadku wartości UserIdentifier.
Brak odpowiednika	encryption_info	Ustaw, jeśli żądanie zawiera zaszyfrowane wartości. Szczegóły znajdziesz w artykule Szyfrowanie.
job_id	Brak odpowiednika	Aby pobrać diagnostykę, użyj request_id zwróconego w odpowiedzi.
partial_failure	Brak odpowiednika	Interfejs Data Manager API nie obsługuje częściowych błędów. Jeśli walidacja któregokolwiek pola IngestEventsRequest się nie powiedzie, interfejs Data Manager API odrzuci całe żądanie.
validate_only	validate_only
conversions	events	Lista konwersji lub zdarzeń. Szczegóły znajdziesz w sekcji Pola konwersji.

Pola klienta i działania powodującego konwersję

Interfejs Google Ads API wymaga nagłówka żądania developer-token, 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, a informacje o logowaniu i połączonym kliencie określasz za pomocą pól Destination zamiast nagłówków żądania. Więcej informacji o miejscach docelowych znajdziesz w artykule Konfigurowanie miejsc docelowych.

Oto jak zmapować pola interfejsu Google Ads API dla pojedynczego conversion_action na odpowiednie pola w Destination:

Interfejs Google Ads API	Destination (interfejs Data Manager API)	Uwagi
customer_id żądania	operating_account	Ustaw account_id na identyfikator klienta konta konwersji Google Ads. Ustaw account_type w operating_account na GOOGLE_ADS.
nagłówek żądania developer-token	Brak odpowiednika	Interfejs Data Manager API nie wymaga tokena programisty.
nagłówek żądania login-customer-id	login_account	Ustaw account_id na identyfikator klienta konta logowania. Jeśli konto logowania jest kontem Google Ads, ustaw account_type na GOOGLE_ADS, a jeśli jest kontem dostawcy danych – na DATA_PARTNER.
nagłówek żądania linked-customer-id	linked_account	Jeśli uzyskujesz dostęp do operating_account za pomocą linku partnerskiego, ustaw account_id na identyfikator klienta połączonego konta i ustaw account_type na DATA_PARTNER. W przeciwnym razie nie ustawiaj pola linked_account.
conversion_action w ClickConversion	product_destination_id	Ustaw na numeryczny identyfikator działania powodującego konwersję. Nie używaj nazwy zasobu ConversionAction.
Brak odpowiednika	reference	Zdefiniowany przez użytkownika identyfikator 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 (interfejs Data Manager API)	Uwagi
cart_data	cart_data	Szczegóły znajdziesz w sekcji Pola danych koszyka.
consent	consent	Oba interfejsy API używają podobnego Consent obiektu (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 to pole na 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 interfejsu Google Ads API. Jeśli używasz buforów protokołu, użyj Timestamp i ustaw pola seconds oraz (opcjonalnie) nanoseconds. Szczegóły znajdziesz w sekcji Format sygnatury czasowej.
conversion_environment	Brak odpowiednika
conversion_value	conversion_value	Ustaw wartość waluty, a nie wartość w mikrach. Na przykład w przypadku wartości konwersji 5,23 zł użyj wartości 5.23.
currency_code	currency
custom_variables	custom_variables	Szczegóły 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óły znajdziesz w sekcji Dodawanie atrybutów sesji.
session_attributes_key_value_pairs	experimental_fields	Szczegóły znajdziesz w sekcji Dodawanie atrybutów sesji.
user_identifiers	user_data.user_identifiers	Szczegóły 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 (interfejs Data Manager API)	Uwagi
feed_country_code	merchant_feed_label	Ustaw etykietę pliku danych .
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

Pola produktu w danych koszyka

Item (interfejs Google Ads API)	Item (interfejs 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 (interfejs Data Manager API)	Uwagi
Brak odpowiednika	destination_references	Interfejs Google Ads API wymaga osobnych żą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 jednym żądaniu, a także używanie pola destination_references do wskazywania, które miejsca docelowe powinny otrzymywać określoną zmienną niestandardową.
conversion_custom_variable	variable	Ustaw nazwę zmiennej zamiast nazwy zasobu.
value	value

Pola identyfikatorów użytkownika

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

Pola odpowiedzi

UploadClickConversionResponse (interfejs Google Ads API)	IngestEventsResponse (interfejs Data Manager API)	Uwagi
job_id	Brak odpowiednika	Aby pobrać diagnostykę, użyj request_id zwróconego w odpowiedzi.
partial_failure_error	Brak odpowiednika	Interfejs Data Manager API nie obsługuje częściowych błędów. Jeśli walidacja któregokolwiek pola 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.