Passer au contenu principal
Lisez la Bibliothèque publicitaire de LinkedIn en JSON via l’API asynchrone de tâches pour voir ce que vos concurrents diffusent auprès des professionnels. ADS est un moteur à part entière : envoyez taskType ADS avec platform linkedin_ad_library, et action choisit ce qu’il faut lire. Pour choisir entre les bibliothèques publicitaires, voir Bibliothèques publicitaires comparées.
  • search (par défaut) liste les publicités par un mot-clé dans query, par le nom d’un annonceur dans advertiserName, par qui a payé dans payer, ou par une combinaison. Chaque publicité indique son annonceur, son format, son titre, son texte et ses médias, et la réponse se termine par un summary des publicités renvoyées.
  • ad ouvre une publicité : l’annonceur, qui a payé, la page de destination et, là où la bibliothèque les publie, les dates de diffusion, les impressions, les pays touchés et son ciblage.
La bibliothèque n’a pas de recherche d’annonceur, donc action advertisers est rejetée avec 400 VALIDATION_ERROR. Trouvez un concurrent avec advertiserName dans une recherche. Une recherche coûte 0.5 crédit pour 30 publicités renvoyées. ad coûte 0.5 crédit.

Requête

Soumettez la tâche, puis interrogez GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones. La bibliothèque limite sa vitesse de lecture, donc une recherche de 120 publicités prend environ une demi-minute.

Analyser les publicités d’un concurrent

Trois requêtes couvrent une analyse de la concurrence :
  1. search avec le nom du concurrent dans advertiserName liste ses publicités. advertiserName correspond à une partie d’un nom, donc vérifiez advertiserName sur chaque publicité. Ajoutez query pour restreindre les publicités à un sujet, et sortBy oldest pour commencer par les plus anciennes.
  2. ad avec le libraryId d’une publicité renvoie qui a payé, la page de destination et, pour les publicités diffusées dans l’UE, les dates de diffusion, les impressions et le ciblage.
  3. search avec payer liste les publicités payées par une agence ou une entreprise, quelle que soit la page qui les diffuse.

Paramètres

  • action : search (par défaut) ou ad.
  • query : un mot-clé dans le texte de la publicité. search exige query, advertiserName ou payer.
  • advertiserName : un nom, recherché comme partie du nom de l’annonceur, comme samsung.
  • payer : le nom de celui qui a payé la publicité, recherché comme partie du nom, comme Starcom.
  • libraryId : l’ID numérique d’une publicité, comme 1638962914. ad l’exige.
  • country : où les publicités ont été diffusées, sous forme de code pays à deux lettres, ou ALL pour tous les pays (par défaut).
  • startDate, endDate : YYYY-MM-DD, envoyés ensemble, dans la dernière année. Conserve les publicités diffusées entre les deux jours.
  • sortBy : newest (par défaut) ou oldest.
  • limit : de 1 à 120 publicités. Par défaut 30.
  • cursor : le nextCursor d’une réponse précédente, pour lire les publicités suivantes.
search lit tous les champs ci-dessus sauf libraryId, et ad lit uniquement libraryId. Un filtre de la Bibliothèque publicitaire de Meta (pageId, pageIds, activeStatus, searchType, adType, mediaType, publisherPlatforms ou contentLanguages), une valeur que la bibliothèque ne peut pas rechercher ou un champ que l’action ne lit pas est rejeté avec 400 VALIDATION_ERROR, et details nomme le champ.

Lire plus de publicités

Une réponse qui a encore des publicités à lire contient nextCursor. Envoyez-le comme cursor avec la même recherche pour recevoir les publicités suivantes, là encore jusqu’à limit. nextCursor vaut null lorsque la bibliothèque n’en a plus. Un curseur ne fonctionne qu’avec la recherche qui l’a renvoyé : un query, advertiserName, payer, country, une plage de dates ou un sortBy différents sont rejetés avec 400 VALIDATION_ERROR, tandis que limit peut changer.

Réponse de recherche

  • La réponse reprend platform, action, country, query, advertiserName, payer, sortBy et les dates reçues. returnedCount compte les publicités dans ads, hasMore vaut true lorsque la bibliothèque en a davantage, ce que nextCursor lit, et libraryUrl ouvre la même recherche dans la Bibliothèque publicitaire. totalCount vaut null, car la bibliothèque ne donne aucun compte.
  • Chaque publicité est une carte : position, libraryId, libraryUrl, advertiserName, advertiserLogoUrl, creativeType (comme SPONSORED_STATUS_UPDATE ou SPONSORED_VIDEO), format, title, body, images et videos (l’affiche de la vidéo dans previewUrl), et platforms (LINKEDIN). format vaut IMAGE, VIDEO, CAROUSEL, DOCUMENT, ARTICLE, MESSAGE, JOB, SPOTLIGHT ou FOLLOW_COMPANY.
  • Les publicités de message et les publicités Thought Leader comportent member, l’expéditeur du message ou le membre dont la publication est promue, avec name et url ; ad le renvoie sous la même forme. Sur les autres publicités, member vaut null.
  • Une carte contient les 120 premiers caractères du texte, et bodyTruncated vaut true lorsque le texte est plus long. ad renvoie le texte complet.
  • advertiserId, payer, startDate, endDate, activeDays, linkUrl, landingDomain, impressions, targeting, ctaText et utm valent null sur une carte. ad les remplit lorsque la bibliothèque les a. isActive vaut null, car la bibliothèque n’indique pas si une publicité est toujours diffusée.
  • summary compte les publicités de cette réponse : ads, advertisers (les 10 qui ont le plus de publicités : advertiserName, ads), formats et platforms. Ses champs de date (oldestStartDate, newestStartDate, medianActiveDays, launchesByWeek et longestRunning) restent vides ou valent null, car les cartes ne portent aucune date.
  • Une recherche sans publicité correspondante se termine avec ads vide et un summary de 0 publicité.

Ce que la bibliothèque conserve

  • La création, l’annonceur et le payeur de chaque publicité sont disponibles pour tous les pays.
  • Les dates de diffusion, la fourchette d’impressions, la part des impressions par pays et le ciblage ne sont disponibles que pour les publicités diffusées dans l’UE.
  • La bibliothèque conserve les publicités environ 12 mois, et son filtre de dates n’accepte que la dernière année.

Ouvrir une publicité

action ad ouvre la publicité avec le libraryId que vous envoyez, issu d’une recherche ou de l’adresse de la Bibliothèque publicitaire /ad-library/detail/<libraryId>.
  • ad contient les champs d’une carte de recherche avec le texte complet, plus advertiserId, advertiserUrl, advertiserType (company ou person), payer (qui a payé la publicité), linkUrl, landingDomain, ctaText, startDate, endDate, activeDays, impressions, targeting et reachedCountries.
  • impressions est la fourchette que publie la bibliothèque (min, max). targeting liste les langues et les lieux que l’annonceur a inclus ou exclus (language, location) et les paramètres de ciblage (parameters : parameter, targeted, excluded). Les dates, impressions, targeting et reachedCountries valent null pour une publicité qui n’a pas été diffusée dans l’UE, comme la publicité Adobe 1698237666. Le payeur et l’annonceur figurent pour toutes les publicités.
  • videos liste chaque vidéo avec url (le fichier au débit le plus élevé), files (chaque mp4 : url, type, bitrate) et previewUrl. Une publicité en carrousel ajoute cards (title, imageUrl) et une publicité de type document ajoute document (son titre, son nombre de pages et les couvertures des pages).
  • advertiser est la page derrière la publicité : advertiserId, advertiserName, url, type et logoUrl.
  • transparency vaut null pour une publicité non diffusée dans l’UE. Pour une publicité diffusée dans l’UE, il contient impressions, impressionsText (le texte de la bibliothèque, comme 50k-100k) et reachByCountry, la part des impressions dans chaque pays (country, countryCode, share, shareText), y compris hors de l’UE.
  • variants liste les autres versions de la publicité lorsque la bibliothèque en montre plus d’une, et vaut null sinon.
  • Les URL des médias des créations restent ouvertes pendant des années. Les URL des cartes d’un carrousel expirent après environ une semaine, et les logos des annonceurs après environ deux semaines et demie. Enregistrez les fichiers dont vous avez besoin.
  • Un libraryId pour lequel la bibliothèque n’a aucune publicité échoue avec PAGE_UNAVAILABLE.

Tarif

Une recherche réserve 0.5 crédit pour 30 publicités que demande son limit, et facture 0.5 crédit pour 30 publicités renvoyées, avec un minimum de 0.5 crédit. La recherche par défaut de 30 publicités coûte 0.5 crédit, et une recherche avec limit 120 réserve 2 crédits. ad coûte 0.5 crédit. Seules les requêtes terminées sont facturées.

Voir aussi