APIs de conversões
Informe suas metas à Meta, LinkedIn, TikTok e Google Ads pelo nosso servidor, não pelo navegador, com correspondência apenas pelo identificador de clique definido pela própria rede.
1. Por que usar o servidor?
Um pixel no navegador precisa superar três obstáculos antes de informar uma conversão: bloqueador de anúncios, prevenção de rastreamento e fechamento da aba antes do disparo. Uma chamada do servidor supera os três porque não acontece no navegador.
O MousePlayer já sabe quando uma meta foi atingida: é para isso que as metas servem. As APIs de conversões apenas encaminham esse fato à rede publicitária pelo servidor.
Isso não substitui seu pixel. Mantenha-o. Cada rede remove duplicações entre as duas fontes e enviamos os identificadores necessários.
2. O que enviamos e o que nunca enviamos
A única informação que identifica o visitante nessas chamadas é o cookie ou identificador de clique definido pela própria rede. Nenhum outro dado da pessoa sai do nosso servidor.
| Rede | Identificador usado | Origem |
|---|---|---|
| Meta | _fbp, _fbc | Cookies próprios definidos pelo pixel da Meta |
li_fat_id | Cookie próprio definido pela LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp é um cookie, ttclid vem da URL do clique no anúncio |
| Google Ads | gclid, wbraid, gbraid | Da URL do clique no anúncio ou do cookie _gcl_aw depois disso |
| Microsoft Advertising | msclkid | Da URL do clique no anúncio ou do cookie _uetmsclkid gravado pela tag UET |
Nunca enviados: e-mail, telefone, nome ou endereço IP, nem mesmo em hash. Sem identificador de clique, nada é enviado. Uma conversão sem atribuição vale menos para você que uma contagem exata.
Só com consentimento
Todas essas chamadas passam pelo mesmo controle de consentimento da gravação. Uma sessão sem consentimento não gera relatório de conversão, independentemente do interruptor nas configurações do projeto.
3. O Google Ads tem três identificadores, não um
Isso costuma surpreender, então vale esclarecer. O Google usa gclid para um clique individual. Quando a prevenção de rastreamento da Apple impede atribuir um clique individual, o Google envia wbraid ou gbraid no lugar, que representam um grupo de cliques.
Os três são mutuamente exclusivos: o Google rejeita uma conversão com dois. Enviamos exatamente um e gclid tem prioridade se houver mais de um, por ser o mais preciso.
Eles aparecem na URL uma única vez
O identificador aparece no endereço apenas na primeira página após o clique no anúncio. Depois a tag Google o salva no cookie _gcl_aw . Lemos o cookie como alternativa: sem ele, uma conversão na terceira página não encontraria identificador algum.
4. Configuração
Meta, LinkedIn e TikTok
Dois campos para cada rede: ID do pixel ou regra de conversão e um token de acesso criado na interface da rede. Ambos são armazenados criptografados com AES-256-GCM e não são exibidos novamente após salvar.
O Google Ads precisa de seis
O Google é a exceção e vale entender antes de começar: diferente das outras três redes, não emite um token de acesso simples. O acesso usa OAuth com token de atualização e a Ads API exige também um token de desenvolvedor.
| Campo | Onde encontrar |
|---|---|
| ID do cliente | No canto superior direito do Google Ads. Apenas dígitos, sem hífens. |
| ID da ação de conversão | Metas e conversões, depois a ação à qual atribuir a conversão. |
| Token de desenvolvedor | Na conta de administrador do Google Ads, Central de API. |
| ID do cliente e segredo OAuth | Google Cloud Console, Credenciais, cliente OAuth do tipo “App para computador”. |
| Token de atualização | Você o gera uma vez para o escopo adwords. |
O LinkedIn tem dois caminhos; escolha o curto
No Campaign Manager: Dados, Gerenciador de sinais, API direta, Gerar token de acesso. É o caminho para anunciantes que enviam seus próprios dados, sem aplicativo de desenvolvedor ou revisão. O token não expira e o Campaign Manager não o mostra de novo; copie imediatamente.
O outro caminho, um aplicativo solicitado no portal de desenvolvedores do LinkedIn, é para plataformas que enviam em nome de muitos anunciantes. Exige verificar a página da empresa e aprovar o caso de uso; você não precisa disso aqui.
O Microsoft Advertising é o mais simples
Depois do Google Ads, você espera OAuth, token de desenvolvedor e aprovação. É o contrário: dois campos. O ID da tag UET já usada no navegador e um token copiado no Microsoft Advertising, na tag UET, “Usar API de conversões”, “Copiar token”. Nenhuma solicitação necessária.
Use o mesmo ID da tag do navegador. Isso permite que a Microsoft reconheça o evento do servidor e o do navegador como uma conversão, não duas.
O token de desenvolvedor exige aprovação do Google (“Acesso básico”), o que leva alguns dias. É a única etapa que não termina em um minuto; comece por ela. Nunca vemos sua senha Google, apenas o token de atualização, que pode ser revogado a qualquer momento.
5. Quando a conversão é informada
Exatamente uma vez por meta e sessão. O MousePlayer elimina duplicações antes da chamada e os dados incluem um ID para a rede repetir a verificação. Um visitante que adiciona cinco itens ao carrinho gera uma conversão, não cinco.
O que você verá na conta de anúncios
A conversão contém o nome da meta, valor e moeda se definidos, e o horário em que ocorreu. Normalmente chega em até um minuto.
Se nada chegar
- Sem identificador de clique. O visitante não veio por um anúncio daquela rede ou chegou antes de o pixel definir o cookie. Nada é enviado: é o comportamento esperado, não um erro.
- Sem consentimento. O controle de consentimento veio primeiro.
- A rede aceitou a chamada, mas rejeitou a conversão. Google, TikTok e outras redes respondem HTTP 200 com um erro no corpo. Lemos o corpo, não apenas o status, e o motivo aparece no registro de entregas.
Todas as marcas mencionadas pertencem aos respectivos proprietários. O MousePlayer não mantém relação comercial com esses fornecedores.