Présentation

L’API Marketing est une API basée sur le protocole HTTP qui vous permet via la programmation d’interroger des données, de créer et de gérer des publicités, ainsi que de réaliser une grande variété d’autres tâches. Cette section présente des informations d’ordre général sur les API Marketing, l’accès, la gestion des versions, et bien plus.

L’API étant basée sur le protocole HTTP, elle fonctionne avec n’importe quel langage ou logiciel compatible avec HTTP, y compris cURL et pratiquement tous les navigateurs web récents. L’API Marketing repose sur l’API Graph de Meta. Par conséquent, presque toutes les requêtes doivent être transmises à l’graph.facebook.comURL d’hébergement.

Concepts de base

Il s’agit des concepts que vous devez connaître pour utiliser l’API Marketing :

Structure des campagnes publicitaires

Meta organise les publicités dans une structure à trois niveaux : campagne, ensemble de publicités et publicité. Dans l’API, les développeur·ses ont accès à un quatrième niveau, celui du contenu publicitaire.

Autorisation

Pour accéder aux points de terminaison de l’API Marketing, votre application doit passer plusieurs niveaux d’autorisation de l’API Graph.

Authentification

Découvrez comment récupérer et stocker le token d’accès dont vous avez besoin pour passer vos appels d’API.

Plafond

L’API Marketing dispose de sa propre logique de plafond et elle est exclue de toutes les limites de débit de l’API Graph.

Gestion des versions

La plateforme de Meta dispose d’un noyau et d’un modèle de gestion des versions étendu. Apprenez-en plus sur les changements à venir et les fins de prise en charge grâce à nos systèmes de migration et de gestion des versions. Consultez les rubriques Calendriers des versions, Migration et Changelog.

Contrôle app

Pour utiliser l’API Marketing, votre application doit être soumise au Contrôle app, avec quelques exceptions pour l’API côté serveur et les conversions hors ligne.

Autorisations

Il existe deux autorisations principales relatives aux publicités : ads_management et ads_read. Les autorisations doivent être accordées à l’application que vous utilisez pour passer les appels. Elles peuvent être demandées pendant le processus Contrôle app. Consultez la liste des autorisations disponibles pour les applications d’entreprise.

Codes d’erreur

Des codes d’erreur peuvent s’afficher lorsque vous utilisez l’API. Ces informations vous en apprendront davantage sur chacun de ces codes d’erreur.

Post-traitement

Découvrez en quoi consiste la phase de post-traitement qui suit la réception d’une requête par Meta.