Saltar para o conteúdo principal
Leia a Biblioteca de Anúncios do LinkedIn como JSON pela API de tarefas assíncronas para ver o que seus concorrentes anunciam para profissionais. ADS é um mecanismo próprio: envie taskType ADS com platform linkedin_ad_library, e action escolhe o que ler. Para escolher entre as bibliotecas de anúncios, veja Bibliotecas de anúncios comparadas.
  • search (padrão) lista anúncios por uma palavra-chave em query, pelo nome de um anunciante em advertiserName, por quem pagou em payer, ou por uma combinação. Cada anúncio traz o anunciante, o formato, o título, o texto e a mídia, e a resposta termina com um summary dos anúncios retornados.
  • ad abre um anúncio: o anunciante, quem pagou, a página de destino e, onde a biblioteca os publica, as datas de veiculação, as impressões, os países que ele alcançou e a segmentação.
A biblioteca não tem busca de anunciantes, então action advertisers é recusada com 400 VALIDATION_ERROR. Encontre um concorrente com advertiserName em uma busca. Uma busca custa 0.5 crédito a cada 30 anúncios que retorna. ad custa 0.5 crédito.

Requisição

Envie a tarefa e depois consulte GET /v1/async/task/{id} ou receba o webhook. Veja Tarefas assíncronas. A biblioteca limita a velocidade de leitura, então uma busca de 120 anúncios leva cerca de meio minuto.

Analise os anúncios de um concorrente

Três requisições cobrem uma análise de concorrentes:
  1. search com o nome do concorrente em advertiserName lista os anúncios dele. advertiserName corresponde a parte de um nome, então confira advertiserName em cada anúncio. Adicione query para restringir os anúncios a um tema, e sortBy oldest para começar pelos anúncios mais antigos.
  2. ad com o libraryId de um anúncio retorna quem pagou, a página de destino e, nos anúncios exibidos na UE, as datas de veiculação, as impressões e a segmentação.
  3. search com payer lista os anúncios que uma agência ou empresa pagou, seja qual for a página que os veicula.

Parâmetros

  • action: search (padrão) ou ad.
  • query: Uma palavra-chave no texto do anúncio. search precisa de query, advertiserName ou payer.
  • advertiserName: Um nome, comparado como parte do nome do anunciante, como samsung.
  • payer: O nome de quem pagou o anúncio, comparado como parte do nome, como Starcom.
  • libraryId: O ID numérico de um anúncio, como 1638962914. ad o exige.
  • country: Onde os anúncios foram exibidos, como código de país de duas letras, ou ALL para todos os países (padrão).
  • startDate, endDate: YYYY-MM-DD, enviados juntos, dentro do último ano. Mantém os anúncios exibidos entre os dois dias.
  • sortBy: newest (padrão) ou oldest.
  • limit: De 1 a 120 anúncios. Padrão 30.
  • cursor: O nextCursor de uma resposta anterior, para ler os anúncios seguintes.
search lê todos os campos acima, exceto libraryId, e ad lê somente libraryId. Um filtro da Biblioteca de Anúncios da Meta (pageId, pageIds, activeStatus, searchType, adType, mediaType, publisherPlatforms ou contentLanguages), um valor que a biblioteca não consegue pesquisar ou um campo que a ação não lê é recusado com 400 VALIDATION_ERROR, e details indica o campo.

Ler mais anúncios

Uma resposta com mais anúncios para ler traz nextCursor. Envie-o como cursor com a mesma busca para receber os anúncios seguintes, de novo até limit. nextCursor é null quando a biblioteca não tem mais. Um cursor só funciona com a busca que o retornou: um query, advertiserName, payer, country, intervalo de datas ou sortBy diferente é recusado com 400 VALIDATION_ERROR, enquanto limit pode mudar.

Resposta da busca

  • A resposta repete platform, action, country, query, advertiserName, payer, sortBy e as datas recebidas. returnedCount conta os anúncios em ads, hasMore é true quando a biblioteca tem mais, o que nextCursor lê, e libraryUrl abre a mesma busca na Biblioteca de Anúncios. totalCount é null, porque a biblioteca não informa uma contagem.
  • Cada anúncio é um card: position, libraryId, libraryUrl, advertiserName, advertiserLogoUrl, creativeType (como SPONSORED_STATUS_UPDATE ou SPONSORED_VIDEO), format, title, body, images e videos (o pôster do vídeo em previewUrl), e platforms (LINKEDIN). format é IMAGE, VIDEO, CAROUSEL, DOCUMENT, ARTICLE, MESSAGE, JOB, SPOTLIGHT ou FOLLOW_COMPANY.
  • Anúncios de mensagem e anúncios Thought Leader trazem member, o remetente da mensagem ou o membro cuja publicação o anúncio promove, com name e url; ad o retorna no mesmo formato. Nos demais anúncios, member é null.
  • Um card traz os primeiros 120 caracteres do texto, e bodyTruncated é true quando o texto é mais longo. ad retorna o texto completo.
  • advertiserId, payer, startDate, endDate, activeDays, linkUrl, landingDomain, impressions, targeting, ctaText e utm são null em um card. ad os preenche onde a biblioteca os tem. isActive é null, porque a biblioteca não informa se um anúncio ainda roda.
  • summary conta os anúncios desta resposta: ads, advertisers (os 10 com mais anúncios: advertiserName, ads), formats e platforms. Os campos de data dele (oldestStartDate, newestStartDate, medianActiveDays, launchesByWeek e longestRunning) ficam vazios ou null, porque os cards não trazem datas.
  • Uma busca sem anúncios correspondentes termina com ads vazio e um summary de 0 anúncios.

O que a biblioteca guarda

  • O criativo, o anunciante e o pagador de cada anúncio estão disponíveis para todos os países.
  • As datas de veiculação, a faixa de impressões, a participação das impressões por país e a segmentação estão disponíveis apenas para anúncios exibidos na UE.
  • A biblioteca guarda os anúncios por cerca de 12 meses, e o filtro de datas aceita apenas o último ano.

Abra um anúncio

action ad abre o anúncio com o libraryId que você enviar, obtido em uma busca ou no endereço da Biblioteca de Anúncios /ad-library/detail/<libraryId>.
  • ad tem os campos de um card de busca com o texto completo, mais advertiserId, advertiserUrl, advertiserType (company ou person), payer (quem pagou o anúncio), linkUrl, landingDomain, ctaText, startDate, endDate, activeDays, impressions, targeting e reachedCountries.
  • impressions é a faixa que a biblioteca publica (min, max). targeting lista os idiomas e locais que o anunciante incluiu ou excluiu (language, location) e os parâmetros de segmentação (parameters: parameter, targeted, excluded). As datas, impressions, targeting e reachedCountries são null em um anúncio que não foi exibido na UE, como o anúncio da Adobe 1698237666. O pagador e o anunciante aparecem em todos os anúncios.
  • videos lista cada vídeo com url (o arquivo com o maior bitrate), files (cada mp4: url, type, bitrate) e previewUrl. Um anúncio em carrossel acrescenta cards (title, imageUrl) e um anúncio de documento acrescenta document (o título, o número de páginas e as capas das páginas).
  • advertiser é a página por trás do anúncio: advertiserId, advertiserName, url, type e logoUrl.
  • transparency é null em um anúncio não exibido na UE. Em um anúncio exibido na UE, contém impressions, impressionsText (o texto da biblioteca, como 50k-100k) e reachByCountry, a participação das impressões em cada país (country, countryCode, share, shareText), inclusive fora da UE.
  • variants lista as outras versões do anúncio quando a biblioteca mostra mais de uma, e é null nos demais casos.
  • As URLs de mídia dos criativos continuam abertas por anos. As URLs dos cards de um carrossel expiram após cerca de uma semana, e os logotipos dos anunciantes após cerca de duas semanas e meia. Salve os arquivos de que precisar.
  • Um libraryId para o qual a biblioteca não tem anúncio falha com PAGE_UNAVAILABLE.

Preço

Uma busca reserva 0.5 crédito a cada 30 anúncios que o limit dela pede, e cobra 0.5 crédito a cada 30 anúncios que retorna, no mínimo 0.5 crédito. A busca padrão de 30 anúncios custa 0.5 crédito, e uma busca com limit 120 reserva 2 créditos. ad custa 0.5 crédito. Apenas requisições concluídas são cobradas.

Relacionado