La bibliothèque publicitaire Meta expose des annonces archivées diffusées sur les plateformes du groupe, et son API Ad Library permet de les interroger par requête. Son périmètre, ses filtres de recherche et les champs qu’elle restitue annonce par annonce sont documentés dans la référence de la Marketing API. Ce guide part de cette documentation pour délimiter ce qui est réellement exploitable, ce qui ne l’est pas, et comment construire une veille dessus sans extrapoler. Pour le reste de vos réglages de plateforme, voir la rubrique Meta Ads.

Deux régimes de transparence à ne pas confondre

L’API Ad Library permet des recherches par mot-clé ou par ID de Page, avec jusqu’à dix Pages Facebook interrogées dans une même requête via search_page_ids (Meta). Le paramètre ad_type distingue quatre catégories d’annonces sensibles en plus de la valeur par défaut ALL : enjeux sociaux, élections et politique (POLITICAL_AND_ISSUE_ADS), produits et services financiers (FINANCIAL_PRODUCTS_AND_SERVICES_ADS), emploi (EMPLOYMENT_ADS), logement et immobilier (HOUSING_ADS).

La limite de périmètre la plus importante tient en une phrase de la documentation : les annonces qui n’ont atteint aucune localisation de l’Union européenne ne sont restituées que si elles portent sur les enjeux sociaux, les élections ou la politique (Meta).

Analyse de Trafic Manager : pour un annonceur français, cette règle rend la bibliothèque utilisable sur les concurrents qui diffusent en Europe, et aveugle sur les acquisitions purement hors UE. Une marque testée uniquement sur les États-Unis avant lancement européen ne remontera pas. Toute conclusion du type « ce concurrent n’a pas d’activité paid » doit donc être écartée : l’absence de résultat documente d’abord le périmètre de l’outil.

Les filtres qui déterminent la qualité de votre recherche

Quatre paramètres pèsent directement sur ce que vous voyez.

La chaîne de recherche. Le terme recherché est limité à 100 caractères, et les espaces agissent comme des opérateurs ET (Meta). Une requête à cinq mots exige donc que les cinq soient présents.

Le mode de correspondance. Deux valeurs de search_type existent : KEYWORD_UNORDERED par défaut, qui ignore l’ordre des mots, et KEYWORD_EXACT_PHRASE pour une recherche exacte (Meta).

Le statut de diffusion. Le paramètre ad_active_status accepte ACTIVE, valeur par défaut, INACTIVE, ou ALL pour les deux (Meta).

La plateforme de diffusion. publisher_platforms cible Facebook, Instagram, Audience Network, Messenger, WhatsApp, Oculus et Threads (Meta).

Un paramètre optionnel mérite d’être connu : unmask_removed_content indique si les résultats doivent révéler le contenu retiré pour non-respect des standards de Meta, et vaut false par défaut (Meta).

Analyse de Trafic Manager : le couple ad_active_status plus ad_creation_time est le seul angle sérieux pour raisonner sur la durée de vie d’une créative. Une annonce toujours active plusieurs semaines après sa création signale une créative que l’annonceur n’a pas coupée. Il s’agit d’un signal de sélection éditoriale, sans valeur de mesure, et il ne remplace pas vos propres tests. Sur la méthode de test créative côté production, voir notre rubrique créatives et IA.

Ce que contient une annonce archivée

L’objet ArchivedAd porte les données restituées par l’API. Le point à retenir avant de bâtir quoi que ce soit dessus : ses champs n’ont pas tous la même disponibilité selon le type d’annonce.

Champs accessibles sur les annonces commerciales ayant atteint l’UE :

  • ad_snapshot_url : un lien affichant l’annonce archivée, avec les images et vidéos non compressées (Meta).
  • ad_creation_time : la date et l’heure UTC de création de l’annonce (Meta).
  • languages : les langues contenues dans l’annonce, sous forme de codes ISO 639-1 (Meta).
  • eu_total_reach : la portée estimée cumulée sur les localisations de l’Union européenne, champ réservé aux annonces UE (Meta).
  • total_reach_by_location : la portée estimée ventilée par localisation, pour l’UE, le Royaume-Uni et le Brésil (Meta).
  • age_country_gender_reach_breakdown : la ventilation des comptes atteints par âge, pays et genre, pour les annonces UK et UE (Meta).

Champs réservés aux annonces politiques et d’enjeux de société :

  • impressions et spend, communiqués sous forme de fourchettes et non de valeurs exactes (Meta).
  • delivery_by_region, la répartition régionale des comptes atteints en pourcentages, et demographic_distribution, la ventilation par tranche d’âge et par genre (Meta).
  • br_total_reach, bylines et estimated_audience_size (Meta).

Analyse de Trafic Manager : la conséquence pour un annonceur e-commerce est double. Aucun calcul de budget concurrent ne peut être présenté comme une mesure, puisque spend n’est pas exposé hors régime politique. Et toute veille bâtie sur delivery_by_region ou demographic_distribution s’effondre dès qu’on l’applique à des annonces commerciales : ces champs reviennent vides. Ce qui reste réellement exploitable, ce sont les codes langue et la ventilation UE et UK, qui se lisent comme des indices de stratégie de localisation. Une même créative déclinée en cinq langues traduit un dispositif multi-marchés, utile pour cadrer vos propres priorités de traduction.

Le régime politique, un niveau de détail à part

La catégorie des enjeux sociaux, élections et politique est la seule à exposer la byline de financement, autrement dit la mention « payé par », les tranches de taille d’audience estimée et la ventilation régionale de diffusion (Meta).

Analyse de Trafic Manager : si vous travaillez pour un acteur institutionnel, une fédération ou une ONG, c’est le régime qui vous concerne, avec un niveau de détail nettement supérieur. Un annonceur e-commerce doit accepter de travailler sans byline, sans tranche d’audience et sans chiffre de dépense.

Passer de l’outil à un process de veille

L’accès à l’API nécessite un jeton d’accès valide, comme le montrent les exemples de requêtes de la documentation (Meta). C’est la condition pour sortir de la consultation manuelle et industrialiser la collecte.

Analyse de Trafic Manager : un protocole de veille tenable en agence se réduit à quatre décisions.

  1. Définir la liste des Pages suivies plutôt que de partir de mots-clés. La recherche par ID de Page est stable et traite dix Pages par requête, quand une requête par mot-clé dérive dès que le vocabulaire du marché bouge.
  2. Figer une fréquence de collecte et stocker ad_creation_time à chaque passage. Sans historique daté, impossible de distinguer une nouvelle créative d’une créative reconduite.
  3. Séparer les actifs des inactifs avec ad_active_status, puisque c’est le seul discriminant de longévité disponible.
  4. Archiver l’ad_snapshot_url dans votre base créative, avec l’angle, le format et la langue relevés à la main. La lecture éditoriale reste humaine.

Ce que la bibliothèque ne documente pas : la structure de campagne, le ciblage paramétré, le budget réel d’une annonce commerciale, la stratégie d’enchères. Ces éléments se déduisent de vos propres comptes et de vos tests, pas d’un catalogue public. Pour l’articulation avec les campagnes automatisées côté Meta, voir notre guide Advantage+.