Ajustes de conversão

Use o método IngestEvents para fazer ajustes em conversões do Google Ads registradas anteriormente. Na API Data Manager, um ajuste pode redefinir um valor de conversão ou complementar dados do usuário.

Se você estiver migrando da API Google Ads, consulte Fazer upgrade da API Google Ads para comparar como os ajustes são processados em cada API.

Tipos de conversão compatíveis

Você pode ajustar os seguintes tipos de conversão do Google Ads:

Como os ajustes funcionam

Na mesma ação de conversão, o Google Ads faz a correspondência de eventos usando transactionId:

  • Se o transactionId corresponder a uma conversão para a mesma ação de conversão, a API Data Manager vai tratar a solicitação como um ajuste de conversão.
  • Se o transactionId não corresponder a uma conversão atual, o Google Ads vai criar uma nova conversão. Consulte Eventos não correspondentes.

Enviar um ajuste

Para ajustar uma conversão, envie uma solicitação IngestEvents que inclua:

  • O mesmo transactionId do evento original.
  • O mesmo destino e ação de conversão do evento original.
  • Os valores atualizados dos campos que você quer ajustar.

Não é necessário especificar um tipo de ajuste. A API Data Manager infere como processar a solicitação com base em transactionId e nos campos fornecidos.

Para mais informações sobre como enviar solicitações de ingestão, consulte Enviar eventos.

Campos aceitos

A tabela a seguir lista os campos que podem ser ajustados e como as atualizações são aplicadas:

Campo Comportamento
conversionValue, currency Substituído. O novo valor substitui o valor registrado.
userData Suplementado se o evento original não tiver dados do usuário. Caso contrário, será ignorado.
Todos os outros campos, como adIdentifiers.gclid Ignorado

Valores de conversão

Envie um novo conversionValue e currency para redefinir o valor de uma conversão registrada. O novo valor substitui o valor registrado anteriormente nos relatórios e lances, sem aumentar a contagem de conversões.

Dados do usuário

Veja como o Google Ads lida com userData, como um endereço de e-mail ou número de telefone:

  • Complementado caso haja lacunas:se o evento original foi capturado sem dados do usuário, o ajuste anexa essas informações para melhorar a atribuição.

  • Ignorado se estiver presente:se a tag do Google ou um upload anterior já tiver capturado dados do usuário, os novos dados serão ignorados. Os dados do usuário não são substituídos nem anexados.

Outros campos

Identificadores e metadados que não sejam valor de conversão, moeda e dados do usuário, como adIdentifiers.gclid, não podem ser atualizados para eventos correspondentes. O Google Ads ignora esses campos e mantém os valores registrados com o evento original.

Eventos sem correspondência

Se o transactionId não corresponder a um evento atual, a solicitação será tratada como um upload de nova conversão em vez de um ajuste.

O Google Ads tenta atribuir a nova conversão a um clique no anúncio usando os identificadores fornecidos, como adIdentifiers.gclid ou userData.