Fazer upgrade da API Google Ads

Faça upgrade dos seus uploads de conversão da API Google Ads para a API Data Manager e tenha acesso a várias melhorias e recursos.

Confira uma comparação entre o uso da API Data Manager e da API Google Ads para gerenciar conversões.

	API Data Manager	API Google Ads
Suporte para envio de conversões off-line e conversões otimizadas para leads	Compatível.	Compatível.
Suporte para envio de conversões da tag do Google Ads como uma fonte de dados adicional para suas conversões de tag, a fim de maximizar os indicadores de interação com o anúncio e fortalecer seus dados e a performance geral	Compatível.	Indisponível.
Modelo de dados	Modelo de dados unificado em todos os casos de uso de conversão do Google Ads e em todos os produtos de publicidade do Google.	O modelo de dados é apenas para casos de uso do Google Ads e varia de acordo com cada um deles.
Criptografia	Aceita criptografia.	Indisponível.
Token de desenvolvedor	Não é obrigatório.	Obrigatório.
Suporte para upload de atributos de sessão e endereços IP para eventos	Disponível para todos os usuários da API.	Disponível apenas para usuários específicos da API.
Ajustes de conversão	Compatível com o método unificado IngestEvents.	Requer o ConversionAdjustmentUploadService separado.
Cotas e limites	Cotas e limites por solicitação baseados em projetos.	Cotas baseadas em token de desenvolvedor e limites por solicitação.
Modelo de erro	Usa um modelo de falha rápida.	Usa um modelo de falha parcial.

Diferença nos requisitos da conta de destino

Na API Data Manager, o operating_account do destino precisa ser o cliente de conversão do Google Ads. Isso é diferente da API Google Ads.

A API Google Ads permite enviar conversões para uma conta do Google Ads usando o customer_id de:

1. O cliente de conversão do Google Ads.

   A API Data Manager é compatível com essa abordagem.

2. Qualquer conta que seja uma controladora ou descendente do cliente de conversão do Google Ads.

   A API Data Manager não é compatível com essa abordagem. Se você estiver usando esse comportamento na API Google Ads, mude o operating_account de cada destino para o proprietário da ação de conversão. Isso pode ser diferente do customer_id usado nas solicitações da API Google Ads.

Ajustes de conversão

A API Data Manager unifica os uploads iniciais de conversão e os ajustes subsequentes em um único método.

Na API Google Ads:

• Para ajustar as conversões, use o método UploadConversionAdjustments separado no ConversionAdjustmentUploadService.
• Se você tentar fazer upload de várias conversões usando o método UploadClickConversions padrão para a mesma ação de conversão com o mesmo ID da transação (order_id), a solicitação vai falhar.
• É necessário especificar o ConversionAdjustmentType na solicitação.

Na API Data Manager:

• Os uploads e ajustes de conversão usam o endpoint unificado IngestEvents.
• O envio de um evento com um transaction_id para a mesma ação de conversão com valores de conversão ou dados do usuário atualizados é processado automaticamente como um ajuste. A API não vai retornar um erro de ID de transação duplicado.
• Nenhum tipo de ajuste é necessário na solicitação. A API Data Manager deduz como processar o ajuste com base nos campos fornecidos no evento.
• Ao contrário da API Google Ads, a API Data Manager não oferece suporte a cancelamentos de conversão, que removem completamente uma conversão gravada anteriormente definindo o valor de conversão e a contagem como 0. É possível redefinir o valor de uma conversão, mas a contagem dela vai permanecer a mesma.

Para mais detalhes, consulte Ajustes de conversão.