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 o envio de conversões off-line e otimizadas para leads	Compatível.	Compatível.
Suporte para enviar conversões da tag do Google Ads como uma fonte de dados adicional para suas conversões de tag, maximizando os indicadores de interação com o anúncio e fortalecendo seus dados e performance geral.	Compatível.	Não compatí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 caso.
Criptografia	Aceita criptografia.	Não compatí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 baseadas em projetos e limites por solicitação.	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.

Termo-chave: o cliente de conversão do Google Ads é a conta do Google Ads que é proprietária da ação de conversão identificada pelo product_destination_id do destino.

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 principal 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. Ele pode ser diferente do customer_id que você usa nas suas solicitações da API Google Ads.

Ajustes de conversão

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

Na API Google Ads:

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

Na API Data Manager:

• Os uploads e ajustes de conversão usam o endpoint unificado IngestEvents.
• O upload de um evento com um transaction_id atual 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 é obrigatório na solicitação. A API Data Manager infere como processar o ajuste com base nos campos fornecidos no evento.
• Ao contrário da API Google Ads, a API Data Manager não aceita remoções de conversão, que excluem completamente uma conversão registrada anteriormente definindo o valor e a contagem de conversões como 0. É possível redefinir o valor de uma conversão, mas a contagem de conversões vai permanecer a mesma.

Para mais detalhes, consulte Ajustes de conversão.