Ajustes de conversão

Use o método IngestEvents para fazer ajustes nas 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 aceitos

É possível 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 existente 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.
  • Todos os campos necessários para um evento, incluindo pelo menos um identificador, como adIdentifiers ou userData. Consulte os requisitos de evento e identificador para conversões off-line ou conversões de várias origens.

Recomendamos que você envie os mesmos identificadores que enviou ou capturou com o evento original. Se o transactionId não corresponder a uma conversão existente, o Google Ads usará esses identificadores para atribuir a nova conversão.

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 os guias de envio de eventos para conversões off-line ou conversões de várias origens.

Campos aceitos

A tabela a seguir mostra como o Google Ads aplica cada campo quando um evento corresponde a uma conversão existente:

Campo Comportamento
conversionValue, currency Substituído. O novo valor substitui o valor registrado.
userData Complementado se o evento original não tiver dados do usuário. Caso contrário, será ignorado.
Todos os outros campos, como adIdentifiers.gclid Não atualizado. O Google Ads mantém os valores registrados com o evento original. Os campos obrigatórios ainda precisam estar presentes.

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 nos 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 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 mantém os valores registrados com o evento original.

Você ainda precisa incluir os campos obrigatórios, como pelo menos um identificador. A API Data Manager os valida para cada evento.

Eventos sem correspondência

Se o transactionId não corresponder a um evento existente, 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.