LinkedIn Conversions API para B2B: rastrear leads e receita de ciclo longo server-side

O problema de mensurar B2B no LinkedIn#

Campanha B2B no LinkedIn quase nunca converte no clique. O tomador de decisão vê o anúncio, baixa um material, entra num fluxo de nutrição, marca uma reunião, passa por uma proposta e assina semanas ou meses depois. O evento que importa para o negócio — o contrato fechado — acontece num CRM, longe do navegador onde o Insight Tag do LinkedIn conseguiria ver. Mensurar B2B só com o pixel é medir o topo do funil e torcer para o resto correlacionar.

A Conversions API do LinkedIn (a API de conversões server-side, ligada às conversões offline e ao envio direto de eventos) resolve isso de duas formas. Primeiro, reporta conversões online que o Insight Tag perderia por bloqueio ou fim de sessão. Segundo, e mais importante para B2B, reporta conversões offline — o lead que virou oportunidade, a oportunidade que virou venda — casando o resultado real com a pessoa que clicou no anúncio.

Eventos e estrutura do payload#

A Conversions API do LinkedIn organiza eventos em torno de uma regra de conversão (conversion rule) que você cria na conta de anúncios. Cada evento enviado se associa a uma dessas regras. O envelope de um evento carrega:

• conversion — o identificador (URN) da regra de conversão que este evento alimenta.
• conversionHappenedAt — timestamp em milissegundos de quando a conversão ocorreu.
• conversionValue — opcional, com amount e currencyCode, para reportar receita.
• eventId — identificador do evento para deduplicação.
• user — o objeto de identificação, com os userIds e informações adicionais.

O user é o coração da correspondência. Ele contém uma lista de userIds, cada um com um tipo e um valor, e pode incluir userInfo com dados como nome e cargo que reforçam o match.

Como o LinkedIn casa o evento com a pessoa#

O LinkedIn é uma rede de identidade profissional, e isso muda a lógica de correspondência em relação a redes de consumo. Os sinais de identidade que você pode enviar:

• SHA256_EMAIL — email hasheado em SHA-256 após normalização (minúsculas, sem espaços). No B2B, o email corporativo é o sinal mais forte, porque as pessoas cadastram o email de trabalho no LinkedIn. Capturar o email empresarial no formulário de lead é meio caminho para um bom match.
• LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — o identificador first-party que o LinkedIn gera e que a Insight Tag persiste. Quando disponível, é um elo direto ao clique. Capture-o do cookie first-party e envie junto.
• SHA256_ACOUNT_ID / identificadores adicionais — quando aplicável, dados extras que reforçam a correspondência.

Além dos userIds, o userInfo com firstName, lastName, title, companyName e countryCode ajuda o LinkedIn a confirmar a identidade em casos ambíguos. No B2B, esses campos costumam existir no CRM — aproveite-os.

Uma particularidade: como a jornada B2B é longa, você raramente terá o UUID first-party na hora de reportar a venda offline, porque o vendedor fechou o negócio meses depois. Aí o email corporativo hasheado sustenta o match sozinho. Por isso a disciplina de capturar e normalizar o email no ponto de entrada do lead é decisiva.

O caso central do B2B: conversões offline do CRM#

O maior valor da Conversions API para B2B é fechar o loop entre o anúncio e o dinheiro. O fluxo típico de estágios:

1. O anúncio no LinkedIn gera um clique; o Insight Tag registra o contexto e o UUID first-party.
2. O usuário preenche um formulário (no site ou um Lead Gen Form) com o email corporativo. Você guarda email, UUID (se veio) e o momento.
3. O lead entra no CRM e avança pelos estágios: MQL, SQL, oportunidade, proposta.
4. Quando a oportunidade é ganha, o CRM (ou seu backend integrado a ele) dispara o envio à Conversions API, com conversionHappenedAt no momento do fechamento, conversionValue igual ao valor do contrato e o user com o email hasheado.

Assim o LinkedIn aprende quais características de público geraram receita, não apenas quais geraram downloads de e-book. A otimização de campanha passa a mirar o perfil que fecha negócio.

Você pode — e deve — reportar múltiplos estágios como regras de conversão distintas: uma para "lead qualificado", outra para "oportunidade criada", outra para "venda ganha". Isso dá ao LinkedIn sinais ao longo do funil, e a você um mapa de onde o investimento vira pipeline.

Enviar só na conversão real#

O princípio da casa vale integralmente aqui, e no B2B ele é ainda mais natural: você não reporta o lead como "venda". Cada estágio é um evento com significado próprio. A "conversão de receita" só é enviada quando o negócio está de fato fechado no CRM — status ganho, contrato assinado. Nada de reportar valor de contrato na criação da oportunidade, porque a maioria das oportunidades não fecha, e inflar receita ensina a plataforma a otimizar pelo público errado.

Esse rigor tem um efeito colateral bom: o número que você reporta ao LinkedIn passa a bater com o que o financeiro reconhece, e a discussão de ROI da mídia deixa de ser sobre proxies (cliques, leads) para ser sobre pipeline e receita atribuída.

Deduplicação e integridade#

Se você reporta a mesma conversão online tanto pelo Insight Tag quanto pela Conversions API, use o eventId para deduplicar — o LinkedIn reconcilia os dois envios pelo mesmo identificador. Para conversões offline puras (a venda que só existe no CRM), não há duplicata com o pixel, mas mantenha o eventId estável mesmo assim, para que reprocessamentos da sua integração não gerem contagem dupla.

Pontos de integridade:

• Idempotência. Se o worker que envia ao LinkedIn reprocessa um item, o eventId derivado do ID da oportunidade evita duplicar.
• Janela de reporte. O LinkedIn aceita conversões offline dentro de uma janela retroativa. Como o ciclo B2B é longo, verifique que o conversionHappenedAt cai dentro do limite; venda fechada muito depois do clique ainda é atribuível dentro da janela configurada, mas há um teto.
• Valor e moeda coerentes. Reporte o valor do contrato na moeda certa; misturar moedas sem currencyCode correto corrompe o ROI.

Autenticação e operação#

A Conversions API do LinkedIn é acessada via a API de marketing, autenticada por OAuth com o escopo apropriado da conta de anúncios. Do ponto de vista de arquitetura, isso significa que o token de acesso é um segredo de servidor — nunca no cliente, nunca em bundle de frontend. A chamada parte do seu backend ou de um conector no CRM.

Para confiabilidade, aplique o mesmo padrão das outras plataformas:

• Outbox. A transição de estágio no CRM que representa a conversão grava um evento numa fila persistente; um worker consome e chama a API com retry e backoff.
• Erro honesto. Trate rejeições de payload (regra de conversão errada, campo faltando) como bugs a corrigir, e erros transitórios como retry. Logue com trace_id; alerte quando a taxa de falha subir.
• Token gerenciado. Renove o token de acesso conforme a política de expiração; um token vencido silencioso derruba todo o reporte de conversão sem alarde.

Validação#

• Ferramenta de teste da Conversions API. Envie eventos de teste e confirme que o LinkedIn os associou à regra de conversão certa e reconheceu os campos de match.
• Taxa de correspondência. Acompanhe quantos eventos o LinkedIn conseguiu casar. No B2B, uma taxa razoável depende quase toda do email corporativo — se estiver baixa, verifique normalização e se você está capturando o email de trabalho, não o pessoal.
• Reconciliação com o CRM. O número de conversões de "venda ganha" reportado deve espelhar as oportunidades ganhas do CRM no período.

Lead Gen Forms e a captura de identidade de qualidade#

Grande parte das campanhas B2B no LinkedIn usa os Lead Gen Forms, os formulários nativos que preenchem automaticamente os dados do perfil profissional do usuário. Eles têm uma vantagem enorme para a mensuração: o email que vem preenchido é frequentemente o email corporativo associado ao perfil do LinkedIn — exatamente o sinal que dá o melhor match na Conversions API.

Para aproveitar isso, integre os Lead Gen Forms ao seu CRM e capture, no momento da submissão, o email e o UUID first-party quando disponível. Esse lead, ao avançar no funil, já carrega a identidade certa para o reporte de conversão offline lá na frente. O erro comum é deixar o lead do formulário morrer numa planilha desconectada do CRM — quando a venda fecha meses depois, ninguém tem como casar o contrato com o clique original.

Se a captura de lead é no seu próprio site (e não no formulário nativo), a disciplina é a mesma: peça e valide o email corporativo, normalize-o e guarde junto do UUID first-party e do momento do clique.

Modelar o funil B2B como múltiplos eventos#

O ciclo B2B tem muitos estágios entre o clique e a receita, e reportar só a venda final desperdiça sinal. A prática recomendada é criar regras de conversão para os marcos que importam e reportar cada um quando acontece:

• Lead qualificado (MQL/SQL) — quando o time de marketing ou pré-vendas valida o lead. Sinal de topo, sem valor de receita.
• Oportunidade criada — quando vira pipeline formal no CRM. Ainda sem reportar valor de contrato como receita realizada.
• Venda ganha — o único evento que carrega conversionValue com o valor real do contrato.

Reportar os estágios intermediários dá ao LinkedIn sinais mais frequentes para aprender, encurtando o tempo até a otimização convergir — algo valioso num ciclo onde a venda final pode levar meses. Mas só o estágio final leva valor de receita, para não ensinar a plataforma a perseguir oportunidades que não fecham.

Atribuição e a realidade do multi-toque B2B#

No B2B, o LinkedIn raramente é o único ponto de contato. O tomador de decisão vê um anúncio, pesquisa no Google, recebe um email, fala com um vendedor. Reportar a conversão ao LinkedIn não significa dar a ele 100% do crédito — significa dar a ele o sinal de que aquele público converteu, para que otimize.

A leitura honesta dos resultados exige entender que a Conversions API alimenta a otimização da campanha do LinkedIn, enquanto a atribuição de negócio (quanto do pipeline o LinkedIn realmente influenciou) é uma análise que cruza várias fontes. Não confunda o número que o LinkedIn reporta como conversões atribuídas a ele com a contribuição incremental real do canal — essa distinção evita decisões de orçamento equivocadas.

Checklist#

• Regras de conversão criadas por estágio (lead, oportunidade, venda ganha).
• Email corporativo capturado no ponto de entrada e hasheado com normalização única.
• UUID first-party do LinkedIn capturado quando disponível.
• userInfo (cargo, empresa, país) enviado para reforçar o match.
• Conversão de receita reportada só quando o negócio está ganho no CRM.
• eventId estável para deduplicação e idempotência.
• conversionHappenedAt dentro da janela de atribuição.
• Token OAuth tratado como segredo de servidor.
• Outbox com retry e alerta; reconciliação com o CRM.

No B2B, mensuração boa é a que liga o anúncio ao contrato. A Conversions API do LinkedIn, alimentada pelo CRM e disparada só na venda real, é o que transforma "geramos muitos leads" em "geramos este tanto de pipeline e esta receita".