O que é a Microsoft Conversions API?
A Microsoft Ads Conversion API (também chamada de Bing CAPI) permite transmitir dados de conversão diretamente do servidor para a Microsoft, sem depender de cookies no navegador. É um sinal servidor-a-servidor que garante maior precisão mesmo em ambientes com restrições de cookies.
A Stape desenvolveu a tag Microsoft Ads UET Conversion API para simplificar a integração via Google Tag Manager server-side, sem necessidade de desenvolvimento customizado.
A Microsoft Ads lançou a CAPI fora do beta fechado, tornando-a disponível para todos os anunciantes. Se você usa Bing Ads, agora é o momento de implementar.
Pré-requisitos
- Acesso beta através de representante Microsoft (para algumas funcionalidades avançadas)
- Container sGTM configurado e em execução
- Stream de dados do container web para o servidor (GA4 ou Data Tag/Client recomendado)
- Tag UET da Microsoft já instalada no site
- Domínio personalizado no servidor GTM (opcional, mas recomendado)
Configuração passo a passo
- Adicione o template: no container sGTM, vá em Templates > Galeria > busque 'Microsoft Ads UET Conversion API by Stape' > adicione ao workspace
- Crie uma nova tag: Tags > Nova > selecione 'Microsoft Ads UET Conversion API' como tipo
- Configure o Event Type Setup Method: escolha 'Standard' (manual) para controle total ou 'Inherit from client' para herdar automaticamente do GA4 Client
- Adicione o UET Tag ID: encontre-o na sua conta Microsoft Ads
- Adicione o Authorization Token: obtido com seu representante Microsoft ou Account Manager
- Habilite Client-Side ID Sync (fortemente recomendado para melhorar a correspondência de usuários)
- Configure o Customer ID: encontrado na URL da sua conta Microsoft Ads (parâmetro 'cid')
- Configure dados de usuário: adicione Anonymous ID, Click ID, Email, Telefone e External ID conforme disponíveis
- Adicione trigger e teste no modo Preview do GTM
Parâmetros opcionais avançados
- Anonymous ID e Click ID: configure o gerenciamento de cookies para esses identificadores
- Event ID: para deduplicação entre eventos client-side e server-side
- Page Type: categoriza o tipo de página para otimização de campanhas
- Parâmetros de e-commerce: valor do pedido, itens, receita — essenciais para campanhas de conversão com ROAS
- Informações TCFv2: obrigatório se você estiver segmentando usuários europeus
A deduplicação é crítica se você usa tanto a UET Tag (client-side) quanto a CAPI (server-side). Sem deduplicação, as conversões serão contadas em duplicata.
Perguntas frequentes
A Microsoft CAPI funciona com todas as campanhas Bing Ads?
Sim, a CAPI funciona com todos os tipos de campanha do Microsoft Advertising: Search, Shopping, Audience Network e mais.
Preciso desabilitar a UET Tag client-side após implementar a CAPI?
Não. O recomendado é usar ambas em paralelo com deduplicação ativa. A CAPI complementa a tag client-side, não a substitui.
Como verificar se a CAPI está funcionando?
Use o modo Preview do GTM para verificar se a tag está disparando. Na plataforma Microsoft Ads, acesse o painel de conversões e verifique se os eventos estão chegando com o status 'Received'.
Este artigo é uma adaptação em português de conteúdo originalmente publicado em inglês pela equipe da Stape. Ver artigo original.
