Mapeamentos de campo

Use os mapeamentos nas tabelas para mapear um UploadClickConversionRequest na API Google Ads para o equivalente IngestEventsRequest na API Gerenciador de dados.

Campos de solicitação

UploadClickConversionRequest (API Google Ads) IngestEventsRequest (API Data Manager) Observações
  • customer_id
  • Cabeçalho da solicitação developer-token
  • Cabeçalho da solicitação login-customer_id
  • Cabeçalho da solicitação linked-customer-id
  • conversion_action
destinations Consulte Campos de cliente e ação de conversão.
Não há equivalente consent Configurações de consentimento padrão opcionais para eventos na solicitação. É possível substituir esse valor em um evento específico definindo o campo consent de Event.
Não há equivalente encoding Obrigatório:defina como o Encoding usado para valores de UserIdentifier.
Não há equivalente encryption_info Defina se a solicitação contém valores criptografados. Consulte Criptografia para mais detalhes.
job_id Não há equivalente Use o request_id retornado na resposta para recuperar diagnósticos.
partial_failure Não há equivalente A API Data Manager não aceita falhas parciais. Se algum campo de um IngestEventsRequest falhar na validação, a API Data Manager vai rejeitar toda a solicitação.
validate_only validate_only
conversions events A lista de conversões ou eventos. Consulte a seção "Campos de conversão" para mais detalhes.

Campos de cliente e ação de conversão

A API Google Ads exige o cabeçalho de solicitação developer-token, e você define os cabeçalhos de solicitação login-customer-id e linked-customer-id para diferentes cenários de autenticação.

A API Data Manager não exige um token de desenvolvedor, e você especifica o login e as informações do cliente vinculado usando campos de um Destination em vez de cabeçalhos de solicitação. Confira Configurar destinos para mais informações sobre destinos.

Veja como mapear os campos da API Google Ads de um único conversion_action para os campos equivalentes em um Destination:

API Google Ads Destination (API Data Manager) Observações
customer_id da solicitação operating_account Defina o account_id como o ID de cliente da conta de conversão do Google Ads. Defina o account_type do operating_account como GOOGLE_ADS.

A API Data Manager pode exigir um ID de cliente diferente daquele usado na API Google Ads. Consulte Diferença nos requisitos da conta de destino para mais detalhes.

Cabeçalho da solicitação developer-token Não há equivalente Um token de desenvolvedor não é necessário para a API Data Manager.
Cabeçalho da solicitação login-customer-id login_account Defina o account_id como o ID de cliente da conta de login. Defina account_type como GOOGLE_ADS se a conta de login for do Google Ads ou DATA_PARTNER se for de um parceiro de dados.
Cabeçalho da solicitação linked-customer-id linked_account Defina o account_id como o ID de cliente da conta vinculada. Defina account_type como DATA_PARTNER.
conversion_action de um ClickConversion product_destination_id Definido como o ID numérico da ação de conversão. Não use o nome do recurso do ConversionAction.
Não há equivalente reference Um identificador definido pelo usuário para o Destination. Defina esse campo se você estiver enviando conversões para várias ações de conversão em uma única solicitação.

Campos de conversão

ClickConversion (API Google Ads) Event (API Data Manager) Observações
cart_data cart_data Consulte Campos de dados do carrinho para mais detalhes.
consent consent As duas APIs usam um objeto Consent semelhante (ad_user_data, ad_personalization).
Na API Data Manager, também é possível definir o consentimento para todos os eventos em uma solicitação definindo o campo consent no nível da solicitação.
conversion_action destination_references Se você estiver enviando conversões para várias ações de conversão em uma única solicitação, defina este campo como o reference correspondente do destino.
conversion_date_time event_timestamp
Consulte Formato do carimbo de data/hora para mais detalhes.
conversion_environment Não há equivalente
conversion_value conversion_value Defina como o valor da moeda, não o valor em micros. Por exemplo, para um valor de conversão de R $5,23, use o valor 5.23.
currency_code currency
custom_variables custom_variables Consulte Campos de variáveis personalizadas para mais detalhes.
customer_type
Não há equivalente event_source
Não há equivalente event_device_info
external_attribution_data Não há equivalente
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
Não há equivalente last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes Consulte Adicionar atributos de sessão para mais detalhes.
session_attributes_key_value_pairs experimental_fields Consulte Adicionar atributos de sessão para mais detalhes.
user_identifiers user_data.user_identifiers Consulte Campos de identificador do usuário para mais detalhes.
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

Campos de dados do carrinho

CartData (API Google Ads) CartData (API Data Manager) Observações
feed_country_code merchant_feed_label Definido como o rótulo do feed.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

Campos de item para dados do carrinho

Item (API Google Ads) Item (API Data Manager) Observações
product_id merchant_product_id
quantity quantity
unit_price unit_price
Não há equivalente item_id
Não há equivalente additional_item_parameters

Campos de variáveis personalizadas

CustomVariable (API Google Ads) CustomVariable (API Data Manager) Observações
Não há equivalente destination_references A API Google Ads exige solicitações separadas por ação de conversão. A API Data Manager permite enviar conversões para várias ações de conversão em uma única solicitação, além de usar o campo destination_references para indicar quais destinos devem receber uma variável personalizada específica.
conversion_custom_variable variable Definido como o nome da variável em vez de um nome de recurso.
value value

Campos do identificador de usuário

UserIdentifier (API Google Ads) UserIdentifier (API Data Manager)
address_info address Siga as diretrizes de formatação e hash. Também é possível criptografar os atributos hash de um endereço.
hashed_email email_address Definido como o endereço de e-mail formatado e com hash. Também é possível criptografar o endereço de e-mail com hash.
hashed_phone_number phone_number Definido como o número de telefone formatado e com hash. Também é possível criptografar o número de telefone hash.
Outros campos:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
Não é relevante Nenhuma das APIs aceita esses identificadores para conversões off-line ou conversões otimizadas para leads, e a API Data Manager não aceita esses identificadores ao enviar eventos de conversão como uma fonte de dados adicional.

Campos de resposta

UploadClickConversionResponse (API Google Ads) IngestEventsResponse (API Data Manager) Observações
job_id Não há equivalente Use o request_id retornado na resposta para recuperar diagnósticos.
partial_failure_error Não há equivalente A API Data Manager não aceita falhas parciais. Se algum campo de um IngestEventsRequest falhar na validação, a API Data Manager vai rejeitar toda a solicitação.
request-id cabeçalho de resposta request_id O ID da solicitação é retornado como um campo de resposta na API Data Manager, em vez de um cabeçalho de resposta.
results Não há equivalente A API Data Manager processa eventos de forma assíncrona. Confira os resultados do processamento usando diagnósticos.