Metrics

Métricas do LinkedIn Ads pela API

Seu cliente conecta a conta do LinkedIn Ads e seu produto consulta 103 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:clicks",
      "component": "number_v1",
      "metrics": [
        "clicks"
      ]
    }
  ]
}
Exemplo: "Cliques" em outubro, comparado a setembro.

Mais exemplos de chamadas no LinkedIn Ads

O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Evolução dos Cliques

Esse gráfico mostra o número de cliques durante o período selecionado.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:clicks_by_day",
      "component": "chart_v1",
      "metrics": [
        "clicks"
      ],
      "dimensions": [
        "dateRange"
      ]
    }
  ]
}

Tabela

Anúncios

Estes são os anúncios que tiveram maior impacto no seu público-alvo, classificados por impressões. Apenas para Sponsored Updates.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:posts",
      "component": "datatable_v1",
      "metrics": [
        "costInLocalCurrency",
        "impressions",
        "clicks",
        "totalEngagements",
        "createdAt"
      ],
      "dimensions": [
        "posts"
      ]
    }
  ]
}

Número

Total de Curtidas

O número de curtidas que seus Sponsored Updates receberam.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "li_ads:likes",
      "component": "number_v1",
      "metrics": [
        "likes"
      ]
    }
  ]
}

Números

88 métricas

  • Cliques

    O número de cliques nos seus anúncios. Por exemplo, cliques para ver a landing page ou a página da empresa.

    li_ads:clicks
  • Total de Curtidas

    O número de curtidas que seus Sponsored Updates receberam.

    li_ads:likes
  • Impressões

    Total de impressões para Direct Ads e Sponsored Updates, e o número de "envios" para InMails.

    li_ads:impressions
  • Seguidores Ganhos

    Número de pessoas que seguiram a partir de um Sponsored Update.

    li_ads:follows
  • Engajamento Total

    Número de todas as interações dos usuários com aquela peça de anúncio.

    li_ads:total_engagements
  • Compartilhamentos

    Número de compartilhamento de seus anúncios. Apenas para Sponsored Updates.

    li_ads:shares
  • Total de Comentários

    Número de comentários feitos em Sponsored Updates.

    li_ads:comments
  • Custo

    Total do custo dos anúncios. É a soma de todas as campanhas selecionadas, ou da conta inteira, dependendo da opção escolhida.

    li_ads:cost
  • Taxa de conversão

    Porcentagem de conversão em relação a cliques (número de conversões totais dividido por cliques).

    li_ads:conversionsRate
  • Total de Conversões

    Número total de vezes que as pessoas tomaram uma ação desejada depois de clicar ou ver seu anúncio. Quando as conversões não podem ser atribuídas a membros individuais, pode-se usar atribuição ou estimativa em nível de grupo.

    li_ads:externalWebsiteConversions
  • Conversões de Cliques

    Cliques em seus anúncios que levaram a uma conversão

    li_ads:externalWebsitePostClickConversions
  • Conversões de Visualização

    Visualizações em seus anúncios que levaram a uma conversão

    li_ads:externalWebsitePostViewConversions
  • Leads

    Número de leads captados por suas campanhas, durante o período de análise selecionado.

    li_ads:oneClickLeads
  • Custo por Todos os cadastros (leads)

    O custo médio de cada lead captado. Essa métrica é calculada dividindo o valor total gasto pelo número de leads.

    li_ads:costPerLead
  • Valor das conversões

    Valor total gerado pelas suas conversões (valor por conversão multiplicado por número de conversões). O valor pode ser definido ao criar conversões e deve refletir o quanto você valoriza cada conversão.

    li_ads:conversionValueInLocalCurrency
  • Custo por Conversão

    Valor médio gasto em cada conversão (total gasto dividido por conversões).

    li_ads:costPerConversion
  • CTR médio

    O CTR médio indica a porcentagem de cliques carregáveis em relação às impressões (cliques divididos por impressões).

    li_ads:averageCtr
  • CPC médio

    Custo por Clique (CPC) mostra quanto, em média, cada clique no link custa para você. Ele é calculado dividindo o total gasto em seus anúncios pelos cliques totais.

    li_ads:averageCpc
  • CPM médio

    O CPM é o preço médio de 1000 impressões. Ele é calculado dividindo o total gasto em seus anúncios pela quantidade de cliques totais.

    li_ads:averageCpm
  • Visualizações

    Reproduções de dois segundos contínuos ou mais enquanto o vídeo estiver em pelo menos 50% da tela.

    li_ads:videoViews
  • Reproduções

    O número de vezes em que um vídeo é reproduzido por clique ou reprodução automática.

    li_ads:videoStarts
  • CPV

    Custo médio da visualização de seus anúncios de vídeo. Embora algumas visualizações de vídeo possam ser gratuitas, como resultado do alcance orgânico de usuários que compartilham seu anúncio, apenas as visualizações pagas são incluídas no CPV.

    li_ads:costPerView
  • Taxa de Visualização

    Taxa de visualização de seus vídeos. Esta métrica é calculada dividindo o número de visualizações/impressões, e multiplicado por 100.

    li_ads:viewRate
  • Número de campanhas

    Número de campanhas publicados por sua página.

    li_ads:count_campaigns
  • Número de anúncios

    Número de anúncios publicados por sua página.

    li_ads:count_ads
  • Cliques no Cartão

    A contagem de cliques nos cartões de seus anúncios, por exemplo, cliques para visualizar a página de destino ou a página da empresa.

    li_ads:cardClicks
  • Cliques no botão

    A contagem de cliques no botão de ação do anúncio de Mensagem Patrocinada.

    li_ads:actionClicks
  • Cliques no banner

    A contagem de cliques na unidade de anúncio exibida junto ao anúncio de Mensagem Patrocinada.

    li_ads:adUnitClicks
  • Alcance Aproximado de Membros

    O número estimado de contas de membros únicos com pelo menos uma impressão.

    li_ads:approximateMemberReach
  • Impressões do Cartão

    A contagem de impressões nos cartões de seus anúncios, por exemplo, impressões da página de destino ou da página da empresa.

    li_ads:cardImpressions
  • Curtidas em Comentários

    A contagem de curtidas em um comentário. Somente Conteúdo Patrocinado.

    li_ads:commentLikes
  • Cliques na Página da Empresa

    A contagem de cliques para visualizar a página da empresa.

    li_ads:companyPageClicks
  • Conclusões do Documento

    O número de vezes que os usuários alcançaram 100% do comprimento do documento.

    li_ads:documentCompletions
  • Visualizações de Documento até 25%

    O número de vezes que os usuários alcançaram 25% do comprimento do documento.

    li_ads:documentFirstQuartileCompletions
  • Visualizações de Documento até 50%

    O número de vezes que os usuários alcançaram 50% do comprimento do documento.

    li_ads:documentMidpointCompletions
  • Visualizações de Documento até 75%

    O número de vezes que os usuários alcançaram 75% do comprimento do documento.

    li_ads:documentThirdQuartileCompletions
  • Cliques em Download

    O número de vezes que os usuários indicaram a intenção de baixar a mídia em um anúncio clicando no ícone de download.

    li_ads:downloadClicks
  • Reproduções em Tela Cheia

    Número de vezes que os membros clicam no botão de tela cheia ou no vídeo (somente celular).

    li_ads:fullScreenPlays
  • Cliques no Título

    O número de vezes que os membros clicaram no título dos anúncios de conversa.

    li_ads:headlineClicks
  • Impressões do Título

    O número de vezes que os membros visualizaram o título dos anúncios de conversa.

    li_ads:headlineImpressions
  • Candidaturas a Emprego

    O número de vezes que um membro completou uma candidatura a emprego após visualizar ou clicar em um anúncio.

    li_ads:jobApplications
  • Cliques em Candidatar-se ao Emprego

    O número de vezes que um membro clicou no botão de candidatura a emprego em uma página de empregos do LinkedIn após visualizar ou clicar em uma página de destino.

    li_ads:jobApplyClicks
  • Cliques na Página de Destino

    A contagem de cliques que levam o usuário à página de destino criativa.

    li_ads:landingPageClicks
  • Compartilhamentos de Contato de Leads patrocinados

    O número de vezes que os usuários compartilharam informações de contato através do Geração de Leads com Um Clique para o anúncio de Mensagem Patrocinada.

    li_ads:leadGenerationMailContactInfoShares
  • Cliques em E-mails de Captação de Leads

    A contagem de destinatários do anúncio de Mensagem Patrocinada que clicaram para demonstrar interesse.

    li_ads:leadGenerationMailInterestedClicks
  • Aberturas de Formulário de Lead com Um Clique

    A contagem de vezes que os usuários abriram o formulário de lead para uma campanha de Geração de Leads com Um Clique.

    li_ads:oneClickLeadFormOpens
  • Aberturas

    A contagem de aberturas de anúncios de Mensagem Patrocinada.

    li_ads:opens
  • Candidaturas a Emprego Pós-Clique

    O número de vezes que um membro completou uma candidatura a emprego após clicar em um anúncio.

    li_ads:postClickJobApplications
  • Cliques no Botão de Candidatura após clique no Anúncio

    O número de vezes que um membro clicou no botão de candidatura a emprego em uma página de empregos do LinkedIn após clicar em um anúncio que possui uma página de destino de emprego do LinkedIn.

    li_ads:postClickJobApplyClicks
  • Registros Pós-Clique

    O número de vezes que um membro se registrou para um evento ou seminário após clicar em um anúncio que possui uma página de destino do LinkedIn.

    li_ads:postClickRegistrations
  • Candidaturas a Emprego Pós-Visualização

    O número de vezes que um membro completou uma candidatura a emprego após visualizar um anúncio.

    li_ads:postViewJobApplications
  • Cliques no Botão de Candidatura Após Visualização da Vaga

    O número de vezes que um membro clicou no botão de candidatura a emprego em uma página de empregos do LinkedIn após clicar em um anúncio que possui uma página de destino de emprego do LinkedIn.

    li_ads:postViewJobApplyClicks
  • Registros Pós-Visualização

    O número de vezes que um membro se registrou para um evento ou seminário após visualizar um anúncio que possui uma página de destino de evento do LinkedIn.

    li_ads:postViewRegistrations
  • Reações

    A contagem de reações positivas em Conteúdo Patrocinado que podem incluir curtir, interesse, elogios e outras respostas.

    li_ads:reactions
  • Registros

    O número de vezes que um membro se registrou para um evento ou seminário após visualizar ou clicar em um anúncio que possui uma página de destino de evento do LinkedIn.

    li_ads:registrations
  • Envios

    A contagem de envios de anúncios de Mensagem Patrocinada.

    li_ads:sends
  • Leads de Talento

    Número de leads capturados através de uma campanha de mídia de talentos.

    li_ads:talentLeads
  • Cliques no link

    A contagem de cliques em quaisquer links (tags âncoras) que foram incluídos no corpo do anúncio de Mensagem Patrocinada.

    li_ads:textUrlClicks
  • Conclusões de Vídeo

    A contagem de anúncios em vídeo que foram reproduzidos 97-100% do vídeo.

    li_ads:videoCompletions
  • Visualizações em 25%

    O número de vezes em que seu vídeo foi assistido até pelo menos 25% da duração total, incluindo visualizações que pularam até esse ponto

    li_ads:videoFirstQuartileCompletions
  • Visualizações em 50%

    O número de vezes em que seu vídeo foi assistido até pelo menos 50% da duração total, incluindo visualizações que pularam até esse ponto

    li_ads:videoMidpointCompletions
  • Visualizações em 75%

    O número de vezes em que seu vídeo foi assistido até pelo menos 75% da duração total, incluindo visualizações que pularam até esse ponto

    li_ads:videoThirdQuartileCompletions
  • Cliques Virais no Cartão

    The number of "viral clicks" for each card of a carousel ad. The first "viral card clicks" of the carousel ad results in an immediate "viral card clicks" and "viral clicks", whereas scrolling to other cards and clicking will count as additional "viral card clicks".

    li_ads:viralCardClicks
  • Impressões virais do cartão

    O número de "impressões virais" exibidas para cada cartão de um anúncio em carrossel. O primeiro cartão do anúncio em carrossel resulta em "impressões no cartão viral" e "impressões virais" imediatas, enquanto rolar para outros cartões contará como "impressões no cartão viral" adicionais.

    li_ads:viralCardImpressions
  • Cliques Virais

    A contagem de cliques em impressões virais. Somente Conteúdo Patrocinado.

    li_ads:viralClicks
  • Curtidas em Comentários Virais

    A contagem de curtidas em comentários de impressões virais para esta atividade. Somente Conteúdo Patrocinado.

    li_ads:viralCommentLikes
  • Comentários Virais

    A contagem de comentários de impressões virais para esta atividade. Somente Conteúdo Patrocinado.

    li_ads:viralComments
  • Cliques na Página da Empresa Viral

    A contagem de cliques para visualizar a página da empresa a partir de impressões virais para esta atividade. Somente Conteúdo Patrocinado.

    li_ads:viralCompanyPageClicks
  • Cliques virais em download

    O número de vezes que os usuários indicaram a intenção de baixar a mídia em um anúncio viral clicando no ícone de download.

    li_ads:viralDownloadClicks
  • Conversões de Anúncios de Eventos Virais

    A contagem de conversões atribuídas aos seus anúncios impulsionadas por um evento viral.

    li_ads:viralExternalWebsiteConversions
  • Conversões Pós-Clique em Sites Externos Virais

    A contagem de conversões pós-clique atribuídas aos seus anúncios impulsionadas por um clique viral.

    li_ads:viralExternalWebsitePostClickConversions
  • Conversões Pós-Visualização em Sites Externos Virais

    A contagem de conversões pós-visualização atribuídas aos seus anúncios impulsionadas por uma impressão viral.

    li_ads:viralExternalWebsitePostViewConversions
  • Seguidores Virais

    A contagem de seguidores de impressões virais para esta atividade. Somente Conteúdo Patrocinado.

    li_ads:viralFollows
  • Reproduções em Tela Cheia Virais

    Número de vezes que os membros clicam no botão de tela cheia ou no vídeo (somente celular) para entrar no modo de tela cheia.

    li_ads:viralFullScreenPlays
  • Impressões Virais

    A contagem de impressões virais para esta atividade. Impressões virais são aquelas resultantes de usuários compartilhando conteúdo patrocinado com sua própria rede de conexões. Impressões virais não são contadas como impressões regulares. Somente Conteúdo Patrocinado.

    li_ads:viralImpressions
  • Candidaturas a Emprego Virais

    O número de vezes que um membro completou uma candidatura a emprego após visualizar ou clicar em um anúncio viral.

    li_ads:viralJobApplications
  • Cliques em Anúncios Virais de Emprego

    O número de vezes que um membro clicou no botão de candidatura a emprego em uma página de empregos do LinkedIn após visualizar ou clicar em um anúncio viral que possui uma página de destino de emprego do LinkedIn durante o período.

    li_ads:viralJobApplyClicks
  • Cliques em Páginas de Destino Patrocinadas Virais

    A contagem de cliques em impressões virais para levar o usuário à página de destino criativa. Somente Conteúdo Patrocinado.

    li_ads:viralLandingPageClicks
  • Curtidas Virais

    A contagem de curtidas de impressões virais para esta atividade. Somente Conteúdo Patrocinado.

    li_ads:viralLikes
  • Reações Virais

    A contagem de reações positivas em Conteúdo Patrocinado viral que podem capturar curtidas, interesse, elogios e outras respostas.

    li_ads:viralReactions
  • Registros Virais

    O número de vezes que um membro se registrou para um evento ou seminário após visualizar ou clicar em um anúncio viral que possui uma página de destino de evento do LinkedIn.

    li_ads:viralRegistrations
  • Compartilhamentos Virais

    A contagem de compartilhamentos de impressões virais para esta atividade. Somente Conteúdo Patrocinado.

    li_ads:viralShares
  • Engajamentos Virais

    A contagem de todas as interações dos usuários com uma unidade de anúncio viral. Somente Conteúdo Patrocinado.

    li_ads:viralTotalEngagements
  • Visualizações de Vídeo Virais

    Um anúncio de vídeo viral reproduzido por pelo menos 2 segundos contínuos com 50% em exibição, ou um clique no CTA, o que ocorrer primeiro. Uma interação com o vídeo (como entrar no modo de tela cheia) não conta como uma visualização.

    li_ads:viralVideoViews
  • Taxa de Abertura

    Total number of opened messages divided by total number of sent messages

    li_ads:opensRate
  • Click-through rate per opening

    Percentage of people who clicked after opening your Sponsored Messaging ad (number of clicks divided by number of opens)

    li_ads:clicksPerOpensRate
  • Cost per sent

    Total spend divided by total deliveries, which is the total number of times the ad was shown.

    li_ads:costPerSends
  • Cost per open message

    Total invested divided by total openings.

    li_ads:costPerOpenMessage

Gráficos

2 métricas

  • Evolução dos Cliques

    Esse gráfico mostra o número de cliques durante o período selecionado.

    li_ads:clicks_by_day
  • Evolução das Impressões

    Esse gráfico mostra o número de impressões durante o período selecionado.

    li_ads:impressions_by_day

Tabelas

13 métricas

  • Anúncios

    Estes são os anúncios que tiveram maior impacto no seu público-alvo, classificados por impressões. Apenas para Sponsored Updates.

    li_ads:posts
  • Campanhas em destaque

    Campanhas que tiveram o maior impacto na sua audiência durante o período analisado.

    li_ads:featuredCampaigns
  • Campanhas de Mensagem Patrocinada

    Resumo de desempenho de suas campanhas de Mensagens Patrocinadas durante o período analisado.

    li_ads:featuredSponsoredMessaging
  • Grupos de campanhas em destaque

    Grupos de campanhas que tiveram o maior impacto na sua audiência durante o período analisado.

    li_ads:featuredCampaignGroups
  • Desempenho por Tamanho da Empresa

    Resultados das campanhas do período analisado de acordo com o tamanho das empresas dos usuários impactados.

    li_ads:performanceCompanySize
  • Desempenho por Nível de Senioridade

    Resultados das campanhas do período analisado de acordo com o Nível de Senioridade dos usuários impactados.

    li_ads:performanceSeniorities
  • Desempenho por Cargo

    Resultados das campanhas para o período analisado de acordo com o cargo dos usuários impactados.

    li_ads:performanceTitles
  • Desempenho por Setor da Indústria

    Resultados das campanhas para o período analisado de acordo com o Setor da Indústria dos usuários impactados.

    li_ads:performanceIndustries
  • Desempenho por Função

    Resultados das campanhas para o período analisado de acordo com a Função dos usuários impactados.

    li_ads:performanceFunctions
  • Desempenho por Região

    Resultados das campanhas para o período analisado de acordo com a Região dos Membros impactados.

    li_ads:performanceRegion
  • Desempenho por País

    Resultados das campanhas para o período analisado de acordo com o país dos Membros impactados.

    li_ads:performanceCountries
  • Desempenho por Empresas

    Resultados das campanhas para o período analisado de acordo com a Empresa dos Membros impactados.

    li_ads:performanceCompanies
  • Desempenho de Conversões

    Desempenho de conversões no período analisado, de acordo com o tipo de conversão.

    li_ads:performanceConversion

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.