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 os 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:

• Conversões de várias origens: conversões registradas pela tag do Google do seu site para uma ação de conversão de WEBSITE.
• Conversões off-line e conversões otimizadas para leads: eventos off-line enviados anteriormente para uma ação de conversão UPLOAD_CLICKS.

Observação: não é possível ajustar as conversões de vendas na loja.

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 atual 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, o Google Ads vai criar uma nova conversão. Consulte Eventos sem correspondência.

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

Importante: a API Data Manager valida cada evento ao receber a solicitação, antes de procurar um transactionId correspondente. Um ajuste precisa atender aos mesmos requisitos de campo e identificador de um novo evento. Caso contrário, a solicitação falhará com um erro como NO_IDENTIFIERS_PROVIDED.

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, o Google Ads vai usar esses identificadores para atribuir a nova conversão.

Não é necessário especificar um tipo de ajuste. A API da Central de Dados infere como processar a solicitação com base em transactionId e nos campos que você fornece.

Para mais informações sobre como enviar solicitações de ingestão, consulte os guias sobre como enviar eventos para conversões off-line ou conversões de várias fontes.

Campos aceitos

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

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, 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 anterior nos relatórios e lances, sem aumentar a contagem de conversões.

Observação: durante o período de teste inicial de 14 dias para conversões de várias fontes de dados, as atualizações de valor ficam desativadas. O valor da tag não será substituído nos relatórios do Google Ads até o fim do período de teste.

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 esses dados para melhorar a atribuição.

  Observação: recomendamos fazer upload de dados off-line complementares até 24 horas após o evento original para garantir a performance ideal.

• Ignorar se houver: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 adicionados ao final.

Outros campos

Identificadores e metadados que não sejam o valor da conversão, a moeda e os 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.

Ainda é necessário incluir todos 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, o upload será tratado como uma nova conversão, e não como 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.

Observação: durante o período de teste inicial de 14 dias para conversões de várias fontes de dados, as conversões recém-criadas aparecem nos relatórios, mas não são usadas para dar lances. Depois que esse período terminar, elas vão se tornar automaticamente disponíveis para lances.