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"
]
}
]
}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:clicksTotal de Curtidas
O número de curtidas que seus Sponsored Updates receberam.
li_ads:likesImpressões
Total de impressões para Direct Ads e Sponsored Updates, e o número de "envios" para InMails.
li_ads:impressionsSeguidores Ganhos
Número de pessoas que seguiram a partir de um Sponsored Update.
li_ads:followsEngajamento Total
Número de todas as interações dos usuários com aquela peça de anúncio.
li_ads:total_engagementsCompartilhamentos
Número de compartilhamento de seus anúncios. Apenas para Sponsored Updates.
li_ads:sharesTotal de Comentários
Número de comentários feitos em Sponsored Updates.
li_ads:commentsCusto
Total do custo dos anúncios. É a soma de todas as campanhas selecionadas, ou da conta inteira, dependendo da opção escolhida.
li_ads:costTaxa de conversão
Porcentagem de conversão em relação a cliques (número de conversões totais dividido por cliques).
li_ads:conversionsRateTotal 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:externalWebsiteConversionsConversões de Cliques
Cliques em seus anúncios que levaram a uma conversão
li_ads:externalWebsitePostClickConversionsConversões de Visualização
Visualizações em seus anúncios que levaram a uma conversão
li_ads:externalWebsitePostViewConversionsLeads
Número de leads captados por suas campanhas, durante o período de análise selecionado.
li_ads:oneClickLeadsCusto 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:costPerLeadValor 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:conversionValueInLocalCurrencyCusto por Conversão
Valor médio gasto em cada conversão (total gasto dividido por conversões).
li_ads:costPerConversionCTR 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:averageCtrCPC 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:averageCpcCPM 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:averageCpmVisualizações
Reproduções de dois segundos contínuos ou mais enquanto o vídeo estiver em pelo menos 50% da tela.
li_ads:videoViewsReproduções
O número de vezes em que um vídeo é reproduzido por clique ou reprodução automática.
li_ads:videoStartsCPV
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:costPerViewTaxa 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:viewRateNúmero de campanhas
Número de campanhas publicados por sua página.
li_ads:count_campaignsNúmero de anúncios
Número de anúncios publicados por sua página.
li_ads:count_adsCliques 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:cardClicksCliques no botão
A contagem de cliques no botão de ação do anúncio de Mensagem Patrocinada.
li_ads:actionClicksCliques no banner
A contagem de cliques na unidade de anúncio exibida junto ao anúncio de Mensagem Patrocinada.
li_ads:adUnitClicksAlcance Aproximado de Membros
O número estimado de contas de membros únicos com pelo menos uma impressão.
li_ads:approximateMemberReachImpressõ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:cardImpressionsCurtidas em Comentários
A contagem de curtidas em um comentário. Somente Conteúdo Patrocinado.
li_ads:commentLikesCliques na Página da Empresa
A contagem de cliques para visualizar a página da empresa.
li_ads:companyPageClicksConclusões do Documento
O número de vezes que os usuários alcançaram 100% do comprimento do documento.
li_ads:documentCompletionsVisualizações de Documento até 25%
O número de vezes que os usuários alcançaram 25% do comprimento do documento.
li_ads:documentFirstQuartileCompletionsVisualizações de Documento até 50%
O número de vezes que os usuários alcançaram 50% do comprimento do documento.
li_ads:documentMidpointCompletionsVisualizações de Documento até 75%
O número de vezes que os usuários alcançaram 75% do comprimento do documento.
li_ads:documentThirdQuartileCompletionsCliques 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:downloadClicksReproduçõ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:fullScreenPlaysCliques no Título
O número de vezes que os membros clicaram no título dos anúncios de conversa.
li_ads:headlineClicksImpressões do Título
O número de vezes que os membros visualizaram o título dos anúncios de conversa.
li_ads:headlineImpressionsCandidaturas 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:jobApplicationsCliques 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:jobApplyClicksCliques na Página de Destino
A contagem de cliques que levam o usuário à página de destino criativa.
li_ads:landingPageClicksCompartilhamentos 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:leadGenerationMailContactInfoSharesCliques 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:leadGenerationMailInterestedClicksAberturas 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:oneClickLeadFormOpensAberturas
A contagem de aberturas de anúncios de Mensagem Patrocinada.
li_ads:opensCandidaturas 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:postClickJobApplicationsCliques 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:postClickJobApplyClicksRegistros 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:postClickRegistrationsCandidaturas 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:postViewJobApplicationsCliques 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:postViewJobApplyClicksRegistros 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:postViewRegistrationsReações
A contagem de reações positivas em Conteúdo Patrocinado que podem incluir curtir, interesse, elogios e outras respostas.
li_ads:reactionsRegistros
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:registrationsEnvios
A contagem de envios de anúncios de Mensagem Patrocinada.
li_ads:sendsLeads de Talento
Número de leads capturados através de uma campanha de mídia de talentos.
li_ads:talentLeadsCliques 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:textUrlClicksConclusões de Vídeo
A contagem de anúncios em vídeo que foram reproduzidos 97-100% do vídeo.
li_ads:videoCompletionsVisualizaçõ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:videoFirstQuartileCompletionsVisualizaçõ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:videoMidpointCompletionsVisualizaçõ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:videoThirdQuartileCompletionsCliques 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:viralCardClicksImpressõ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:viralCardImpressionsCliques Virais
A contagem de cliques em impressões virais. Somente Conteúdo Patrocinado.
li_ads:viralClicksCurtidas em Comentários Virais
A contagem de curtidas em comentários de impressões virais para esta atividade. Somente Conteúdo Patrocinado.
li_ads:viralCommentLikesComentários Virais
A contagem de comentários de impressões virais para esta atividade. Somente Conteúdo Patrocinado.
li_ads:viralCommentsCliques 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:viralCompanyPageClicksCliques 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:viralDownloadClicksConversõ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:viralExternalWebsiteConversionsConversõ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:viralExternalWebsitePostClickConversionsConversõ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:viralExternalWebsitePostViewConversionsSeguidores Virais
A contagem de seguidores de impressões virais para esta atividade. Somente Conteúdo Patrocinado.
li_ads:viralFollowsReproduçõ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:viralFullScreenPlaysImpressõ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:viralImpressionsCandidaturas 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:viralJobApplicationsCliques 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:viralJobApplyClicksCliques 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:viralLandingPageClicksCurtidas Virais
A contagem de curtidas de impressões virais para esta atividade. Somente Conteúdo Patrocinado.
li_ads:viralLikesReações Virais
A contagem de reações positivas em Conteúdo Patrocinado viral que podem capturar curtidas, interesse, elogios e outras respostas.
li_ads:viralReactionsRegistros 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:viralRegistrationsCompartilhamentos Virais
A contagem de compartilhamentos de impressões virais para esta atividade. Somente Conteúdo Patrocinado.
li_ads:viralSharesEngajamentos Virais
A contagem de todas as interações dos usuários com uma unidade de anúncio viral. Somente Conteúdo Patrocinado.
li_ads:viralTotalEngagementsVisualizaçõ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:viralVideoViewsTaxa de Abertura
Total number of opened messages divided by total number of sent messages
li_ads:opensRateClick-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:clicksPerOpensRateCost per sent
Total spend divided by total deliveries, which is the total number of times the ad was shown.
li_ads:costPerSendsCost 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_dayEvoluçã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:postsCampanhas em destaque
Campanhas que tiveram o maior impacto na sua audiência durante o período analisado.
li_ads:featuredCampaignsCampanhas de Mensagem Patrocinada
Resumo de desempenho de suas campanhas de Mensagens Patrocinadas durante o período analisado.
li_ads:featuredSponsoredMessagingGrupos de campanhas em destaque
Grupos de campanhas que tiveram o maior impacto na sua audiência durante o período analisado.
li_ads:featuredCampaignGroupsDesempenho por Tamanho da Empresa
Resultados das campanhas do período analisado de acordo com o tamanho das empresas dos usuários impactados.
li_ads:performanceCompanySizeDesempenho 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:performanceSenioritiesDesempenho por Cargo
Resultados das campanhas para o período analisado de acordo com o cargo dos usuários impactados.
li_ads:performanceTitlesDesempenho 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:performanceIndustriesDesempenho por Função
Resultados das campanhas para o período analisado de acordo com a Função dos usuários impactados.
li_ads:performanceFunctionsDesempenho por Região
Resultados das campanhas para o período analisado de acordo com a Região dos Membros impactados.
li_ads:performanceRegionDesempenho por País
Resultados das campanhas para o período analisado de acordo com o país dos Membros impactados.
li_ads:performanceCountriesDesempenho por Empresas
Resultados das campanhas para o período analisado de acordo com a Empresa dos Membros impactados.
li_ads:performanceCompaniesDesempenho 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.
