Mapeamentos de campo

Use os mapeamentos nas tabelas para mapear um UploadCallConversionsRequest na API Google Ads para o equivalente IngestEventsRequest na API Data Manager.

Autenticação

A API Data Manager exige credenciais com um escopo diferente da API Google Ads. Siga as etapas em Configurar o acesso à API para gerar novas credenciais que incluam o escopo da API Data Manager.

Campos de solicitação

UploadCallConversionsRequest (API Google Ads) IngestEventsRequest (API Data Manager) Observações
  • customer_id
  • Cabeçalho da solicitação login-customer-id
  • Cabeçalho da solicitação linked-customer-id
  • conversion_action
destinations Consulte Campos de ação de conversão e cliente.
Não há equivalente consent Opcional. Configurações de consentimento padrão para todos os eventos na solicitação. Ao contrário da API Google Ads, que só permite definir o consentimento em conversões individuais, a API Data Manager permite definir o consentimento uma vez para toda a solicitação. Para substituir o padrão de um evento individual, defina o campo consent do Event.
Não há equivalente encoding Obrigatório: defina como o Encoding (HEX ou BASE64) usado para valores de UserIdentifier.
partial_failure Não há equivalente A API Data Manager usa um modelo de erro de falha rápida. Se algum campo de um IngestEventsRequest falhar na validação, a API Data Manager vai rejeitar toda a solicitação. Se a solicitação for bem-sucedida, use diagnostics para recuperar erros e avisos de eventos individuais.
validate_only validate_only
conversions events A lista de conversões ou eventos. Consulte Campos de conversão para mais detalhes.

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

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

Na API Data Manager, você especifica as informações do cliente e de cliente vinculado usando campos de um Destination em vez de cabeçalhos da 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.
Cabeçalho da solicitação developer-token Não há equivalente A API Data Manager não usa tokens de desenvolvedor. A API Google Ads também não exige mais esses tokens.
Cabeçalho da solicitação login-customer-id login_account Defina account_id como o ID de cliente da conta de login. Defina account_type como GOOGLE_ADS se a conta de login for uma conta do Google Ads ou como DATA_PARTNER se for uma conta de parceiro de dados.
Cabeçalho da solicitação linked-customer-id linked_account Só se aplica se você for um parceiro de dados que envia dados por um link de parceiro. Se o link de parceiro for com uma conta de administrador principal do operating_account, defina o account_id como o ID de cliente da conta do Google Ads que tem o link de parceiro e defina account_type como GOOGLE_ADS. Se o link do parceiro for diretamente com o operating_account, não defina o campo linked_account. Consulte Cenários de parceiros de dados.
conversion_action de um CallConversion product_destination_id Defina como o ID numérico da ação de conversão UPLOAD_CALLS. 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 eventos para vários destinos.

Campos de conversão

CallConversion (API Google Ads) Event (API Data Manager) Observações
caller_id user_data.user_identifiers[].phone_number Obrigatório. Formate o número de telefone no formato E.164, gere um hash usando SHA-256, codifique o hash usando a codificação hexadecimal ou Base64 e defina o campo phone_number de um UserIdentifier no objeto UserData. Defina também encoding no IngestEventsRequest.
call_start_date_time call_info.start_timestamp Obrigatório. Defina start_timestamp no objeto CallInfo.
Consulte o formato do carimbo de data/hora para mais detalhes.
consent consent As duas APIs usam um objeto Consent semelhante (ad_user_data, ad_personalization). No caso da API Data Manager, também é possível definir o consentimento para todos os eventos em uma solicitação configurando o campo consent no nível da solicitação.
conversion_action destination_references Defina product_destination_id no destino. Se você estiver enviando eventos para vários destinos, defina destination_references como o reference correspondente do destino.
conversion_date_time event_timestamp Obrigatório. Não pode ser anterior a call_info.start_timestamp.
Consulte o formato do carimbo de data/hora para mais detalhes.
conversion_value conversion_value
currency_code currency
custom_variables custom_variables Consulte Campos de variáveis personalizadas para mais detalhes.
Não há equivalente event_source Opcional. Defina como um valor de tipo enumerado EventSource válido.

Campos de variáveis personalizadas

CustomVariable (API Google Ads) CustomVariable (API Data Manager) Observações
Não há equivalente destination_references Se você estiver enviando eventos para vários destinos, use esse campo para indicar quais destinos devem receber uma variável personalizada específica.
conversion_custom_variable variable Defina como o nome da variável em vez de um nome de recurso.
value value

Campos de resposta

UploadCallConversionsResponse (API Google Ads) IngestEventsResponse (API Data Manager) Observações
partial_failure_error Não há equivalente A API Data Manager usa um modelo de erro de falha rápida. 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. Verifique os resultados do processamento usando o diagnóstico.