O Que É a Ferramenta Conversions API do LinkedIn?

LinkedIn Conversions API (CAPI) é um endpoint server-side que permite que seu site ou sistema back-end envie eventos de conversão diretamente ao LinkedIn sem depender do navegador. Como as chamadas partem do seu servidor, os dados são menos afetados por bloqueadores de anúncios, ITP e limitações de cookies. A API conecta seu banco de dados ao Campaign Manager, ajudando a garantir que mais leads qualificados ou vendas sejam contabilizados ao reduzir a perda de dados no lado do navegador.

Por Que a LinkedIn Conversions API É Importante

• Vincule pedidos por telefone, etapas de CRM ou vendas presenciais às suas campanhas para uma visão completa.
• Sinais mais ricos ajudam o LinkedIn a reduzir o CPA automaticamente. Anunciantes que utilizam a CAPI relatam +31% de conversões atribuídas, −20% no CPA e −39% no custo por lead qualificado, em média.
• Chamadas server-side resistem às restrições de navegador que podem bloquear o LinkedIn Insight Tag.
• Escolha exatamente quais campos em hash são compartilhados (SHA256_EMAIL, UUID de rastreamento first-party ou IDs de identidade de terceiros como ACXIOM_ID e ORACLE_MOAT_ID).
• Hashing SHA-256 server-side, retenção de dados por 180 dias e controles de preferências de anúncios dos membros simplificam a conformidade com GDPR, CCPA e leis de privacidade similares.
• Atualizações em tempo quase real chegam ao Campaign Manager mais rapidamente, permitindo que as estratégias de lances se adaptem antes que o orçamento seja desperdiçado.

Equipes de SaaS usam a CAPI para transmitir eventos SQL. Lojas de e-commerce enviam receita líquida. Profissionais de marketing B2B sincronizam dados de webinars e feiras. Para automação de funil de vendas e otimização de campanhas no LinkedIn, confira o LinkedIn Automated Marketing Funnel: Sales Funnel Automation Guide.

Como a LinkedIn Conversions API Funciona

Client-side vs. server-side:

• Pixel: o navegador coleta dados de clique/visualização; suscetível a bloqueadores.
• API: seu servidor envia um POST com JSON para o endpoint /rest/conversionEvents do LinkedIn usando um token de acesso OAuth2 (com os escopos rw_conversions e r_ads) e quatro headers obrigatórios: Authorization: Bearer {token}, X-Restli-Protocol-Version: 2.0.0, LinkedIn-Version: {yyyymm} e Content-Type: application/json.

Os eventos de conversão devem conter um timestamp conversionHappenedAt dentro dos últimos 90 dias. As janelas de lookback de atribuição podem ser configuradas para 1, 7, 30 ou 90 dias; janelas de 365 dias estão disponíveis para os tipos de conversão Lead, Qualified Lead, Purchase, Submit Application e Add to Cart.

Configuração passo a passo

1. Crie uma regra de conversão — no Campaign Manager, vá em Measurement → Conversion tracking → Create conversion → Conversions API. Nomeie a regra, escolha um tipo de conversão (Lead, Purchase, Sign Up, etc.), defina um método de valor (dinâmico, fixo ou nenhum) e configure as janelas de atribuição.
2. Escolha um caminho de integração — conecte-se por meio de um parceiro (Adobe, HubSpot, Google Tag Manager, Zapier, Segment, Tealium, entre outros) ou crie uma integração direta com a REST API do LinkedIn. Configurações com parceiros geralmente são únicas; integrações diretas levam em média 2–4 semanas e oferecem controle total sobre o payload.
3. Gere um token de acesso OAuth2 — seu aplicativo precisa dos escopos rw_conversions e r_ads. O proprietário do token deve ter a função de Account Manager, Campaign Manager ou Billing Admin na conta de anúncios.
4. Associe campanhas — vincule a regra de conversão a cada campanha que deve receber crédito. Use autoAssociationType=ALL_CAMPAIGNS ao criar a regra ou associe manualmente via PUT /rest/campaignConversions.
5. Transmita eventos — envie cada conversão via POST para /rest/conversionEvents com o URN da conversão, um timestamp em milissegundos, pelo menos um identificador de usuário e um eventId opcional para deduplicação.

Chaves de correspondência de usuários

O LinkedIn resolve eventos para membros usando identificadores que você envia no array userIds:

• SHA256_EMAIL — e-mail em minúsculas, sem espaços, com hash SHA-256.
• LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID — o parâmetro de clique li_fat_id capturado quando o rastreamento de conversão aprimorado está ativado.
• ACXIOM_ID — grafo de identidade LiveRamp.
• ORACLE_MOAT_ID — grafo de identidade Oracle MOAT.
• Se nenhum dos anteriores estiver disponível, envie firstName + lastName (e opcionalmente companyName, title, countryCode) no objeto userInfo.

Enviar múltiplos identificadores por evento aumenta as taxas de correspondência. Apenas eventos correspondidos contam para atribuição e otimização.

Tipos de conversão suportados

O LinkedIn aceita mais de 30 tipos de conversão, incluindo Add to Cart, Download, Install, Key Page View, Lead, Purchase, Sign Up, Start Checkout, Subscribe, Qualified Lead, Submit Application, Phone Call, Book Appointment, Request Quote, entre outros. A lista completa está documentada na referência da Marketing API.

Deduplicação

Se você utiliza tanto o Insight Tag quanto a CAPI, o LinkedIn pode deduplicar automaticamente. Envie a mesma string eventId tanto no evento client-side quanto no server-side para que o LinkedIn reconheça a duplicata e contabilize apenas uma vez.

Limites de requisições

• 600 requisições por minuto por token.
• 300.000 requisições por dia por token.
• O endpoint de lote aceita até 5.000 eventos em um único POST (use o header X-RestLi-Method: BATCH_CREATE).

Boas Práticas

• Envie eventos em tempo real. Dados atrasados podem ficar fora da janela de atribuição ou perder o ciclo de otimização.
• Inclua o máximo de parâmetros de correspondência possível. Mais identificadores significam taxas de correspondência mais altas e melhor qualidade de sinal.
• Ative o rastreamento first-party aprimorado no Campaign Manager para que o LinkedIn adicione o li_fat_id às URLs da landing page. Capture e encaminhe esse UUID com cada evento de conversão.
• Defina janelas de atribuição amplas. O LinkedIn recomenda 90 dias de clique / 90 dias de visualização para conversões de lead e de fundo de funil. Para ciclos de vendas B2B longos, use a janela de 365 dias nos tipos Lead, Qualified Lead, Purchase, Submit Application e Add to Cart.
• Atribua valores de conversão. Mesmo valores estáticos de referência permitem que o Campaign Manager calcule o ROAS e identifique públicos de alto valor.
• Associe conversões a todas as campanhas relevantes. Campanhas não vinculadas não podem receber crédito de atribuição.
• Use requisições em lote para cargas volumosas. Migrar dados históricos de CRM ou sincronizar exportações noturnas é mais rápido e confiável em lotes de até 5.000 eventos.
• Monitore a página Conversion Tracking no Campaign Manager para alertas de status e verifique se os eventos estão chegando e sendo correspondidos.

Dicas Extras

• Combine a CAPI com o Insight Tag em vez de substituí-lo. Sinais redundantes preenchem lacunas quando um canal perde eventos, e o LinkedIn deduplica automaticamente.
• Use o contêiner server-side do Google Tag Manager para encaminhar eventos web à CAPI sem escrever código personalizado — o LinkedIn oferece um template oficial para GTM.
• Compartilhe regras de conversão comprovadas entre contas de anúncios via Business Manager para que todas as equipes usem a mesma estrutura de mensuração.
• Faça o hash dos e-mails no seu servidor antes que eles deixem sua rede. O pré-hashing mantém dados pessoais brutos fora de logs e do tráfego de rede.
• Renove seu token OAuth antes que ele expire. Um token expirado descarta eventos silenciosamente até que alguém perceba a lacuna no Campaign Manager.
• Teste seu payload com a ferramenta Payload Builder do LinkedIn em linkedin.com/developers/payload-builder antes de ir para produção.