Field mappings

Use the mappings in the tables to map an UploadClickConversionRequest in the Google Ads API to its IngestEventsRequest equivalent in the Data Manager API.

Request fields

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (Data Manager API)	Notes
customer_id developer-token request header login-customer_id request header linked-customer-id request header conversion_action	destinations	See Customer and conversion action fields.
No equivalent	consent	Optional default consent settings for events in the request. You can override this value for an individual event by setting the consent field of Event.
No equivalent	encoding	Required: Set to the Encoding used for UserIdentifier values.
No equivalent	encryption_info	Set if the request contains encrypted values. See Encryption for details.
job_id	No equivalent	Use the request_id returned in the response to retrieve diagnostics.
partial_failure	No equivalent	The Data Manager API doesn't support partial failure. If any field of an IngestEventsRequest fails validation, the Data Manager API rejects the entire request.
validate_only	validate_only
conversions	events	The list of conversions or events. See the Conversion fields section for details.

Customer and conversion action fields

The Google Ads API requires the developer-token request header, and you set the login-customer-id and linked-customer-id request headers for different authentication scenarios.

The Data Manager API doesn't require a developer token, and you specify login and linked customer information using fields of a Destination instead of request headers. Check out Configure destinations for more information about destinations.

Here's how to map the Google Ads API fields for a single conversion_action to the equivalent fields in a Destination:

Google Ads API	Destination (Data Manager API)	Notes
customer_id of the request	operating_account	Set the account_id to the customer ID of the Google Ads conversion account. Set the account_type of the operating_account to GOOGLE_ADS. The Data Manager API may require a different customer ID than the one you use for the Google Ads API. See Difference in destination account requirements for details.
developer-token request header	No equivalent	A developer token is not required for the Data Manager API.
login-customer-id request header	login_account	Set the account_id to the customer ID of the login account. Set account_type to GOOGLE_ADS if the login account is a Google Ads account, or DATA_PARTNER if the login account is a data partner account.
linked-customer-id request header	linked_account	Set the account_id to the customer ID of the linked account. Set account_type to DATA_PARTNER.
conversion_action of a ClickConversion	product_destination_id	Set to the numeric ID of the conversion action. Don't use the resource name of the ConversionAction.
No equivalent	reference	A user-defined identifier for the Destination. Set this field if you are sending conversions for multiple conversion actions in a single request.

Conversion fields

ClickConversion (Google Ads API)	Event (Data Manager API)	Notes
cart_data	cart_data	See Cart data fields for details.
consent	consent	Both APIs use a similar Consent object (ad_user_data, ad_personalization). For the Data Manager API, you can also set consent for all events in a request by setting the request-level consent field.
conversion_action	destination_references	If sending conversions for multiple conversion actions in a single request, set this field to the corresponding reference of the destination.
conversion_date_time	event_timestamp	If using the JSON format, set to a value in RFC 3339 format, which differs slightly from the Google Ads API date and time format. If using protocol buffers, use a Timestamp and set the seconds and (optionally) the nanoseconds fields. See Timestamp format for details.
conversion_environment	No equivalent
conversion_value	conversion_value	Set to the currency value, not the value in micros. For example, for a conversion value of $5.23, use the value 5.23.
currency_code	currency
custom_variables	custom_variables	See Custom variable fields for details.
customer_type
No equivalent	event_source
No equivalent	event_device_info
external_attribution_data	No equivalent
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
No equivalent	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	See Add session attributes for details.
session_attributes_key_value_pairs	experimental_fields	See Add session attributes for details.
user_identifiers	user_data.user_identifiers	See User identifier fields for details.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

Cart data fields

CartData (Google Ads API)	CartData (Data Manager API)	Notes
feed_country_code	merchant_feed_label	Set to the feed label.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

Item fields for cart data

Item (Google Ads API)	Item (Data Manager API)	Notes
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
No equivalent	item_id
No equivalent	additional_item_parameters

Custom variable fields

CustomVariable (Google Ads API)	CustomVariable (Data Manager API)	Notes
No equivalent	destination_references	The Google Ads API requires separate requests per conversion action. The Data Manager API supports sending conversions for multiple conversion actions in a single request, as well as using this destination_references field to indicate which destinations should receive a specific custom variable.
conversion_custom_variable	variable	Set to the name of the variable instead of a resource name.
value	value

User identifier fields

UserIdentifier (Google Ads API)	UserIdentifier (Data Manager API)
address_info	address	Follow the formatting and hashing guidelines. You can also encrypt the hashed attributes of an address.
hashed_email	email_address	Set to the formatted and hashed email address. You can also encrypt the hashed email address.
hashed_phone_number	phone_number	Set to the formatted and hashed phone number. You can also encrypt the hashed phone number.
Other fields: mobile_id third_party_user_id user_identifier_source	Not relevant	Neither API supports these identifiers for offline conversions or enhanced conversions for leads, and the Data Manager API doesn't support these identifiers when sending conversion events as an additional data source.

Response fields

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (Data Manager API)	Notes
job_id	No equivalent	Use the request_id returned in the response to retrieve diagnostics.
partial_failure_error	No equivalent	The Data Manager API doesn't support partial failure. If any field of an IngestEventsRequest fails validation, the Data Manager API rejects the entire request.
request-id response header	request_id	The request ID is returned as a response field in the Data Manager API instead of as a response header.
results	No equivalent	The Data Manager API processes events asynchronously. Check the processing results using diagnostics.