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