Introducing Graph API v20.0 and Marketing API v20.0

Aujourd’hui, nous mettons en ligne la version 20.0 des API Graph et Marketing de Facebook. Dans le cadre de cette version, nous tenons à mettre en évidence les modifications que nous estimons pertinentes pour les membres de notre communauté de développement. Ces changements comprennent des annonces, des mises à jour de produits et des notifications d’abandons sur les intégrations d’applications pertinentes à notre plateforme.

Consultez la liste complète de toutes les modifications et leurs détails dans notre changelog.

Mises à jour générales

Mise à niveau automatique de la version de l’API Marketing

Pour améliorer l’expérience globale de l’API et rendre son utilisation plus simple et optimale, nous allons prochainement lancer la fonctionnalité de mise à niveau automatique de version de l’API Marketing. À partir d’aujourd’hui, nous allons activer la fonctionnalité de mise à niveau automatique de version pour les points de terminaison de l’API Marketing qui ne sont pas affectés d’une version à l’autre. Cela signifie qu’entre une version prochainement obsolète et la version disponible suivante, si un point de terminaison n’est pas affecté, la plateforme mettra automatiquement à jour l’appel à la version disponible suivante, plutôt que de faire échouer directement la requête.

Pour plus d’informations, consultez l’article relatif à la gestion des versions de l’API Marketing et l’article de blog sur le lancement.

Pour connaître les points de terminaison affectés pour chaque version, consultez le changelog.

Continuez à lire pour en savoir plus sur les nouveautés de la version 20.0.

Publicités de rappel pour l’API Marketing

Avant le 13 mai 2024, les développeurs ne pouvaient pas prendre en charge la création de publicités de rappel Instagram via l’API Marketing d’Instagram, et leurs client·es ne pouvaient créer des publicités de rappel que dans le Gestionnaire de publicités Meta. Ce problème de compatibilité engendrait des difficultés pour nos partenaires et leurs client·es qui souhaitaient diffuser des publicités de rappel.

Après avoir reçu de nombreux commentaires relatifs à ce problème d’incompatibilité, nous avons décidé de prendre en charge la création de publicités de rappel via l’API Marketing d’Instagram à partir du 13 mai 2024.

Les commentaires de notre communauté de développeurs et de leurs client·es sont précieux et nous souhaitons continuer à améliorer l’expérience relative aux publicités de rappel disponibles via l’API Marketing.

À propos des publicités de rappel Instagram

Les publicités de rappel Instagram permettent aux annonceurs de faire le lien entre la promotion et le moment du lancement en invitant les personnes intéressées à programmer des rappels. Les personnes inscrites recevront des rappels juste avant l’évènement programmé.

À propos de la création et de la modification d’évènements

Les publicités de rappel Instagram utilisent l’heure et la date de début de l’évènement afin de déterminer le meilleur moment pour diffuser les rappels. Cette modification permet aux développeurs de créer et de modifier des évènements dans l’API Graph d’Instagram. Vous pouvez créer des publicités de rappel via l’API Marketing d’Instagram après avoir joint des évènements à du contenu publicitaire.

Nouvelle API sur le nœud Compte publicitaire

La mise à jour du nœud Compte publicitaire n’est pas une modification importante mais une nouvelle API. Le fait de l’appeler répertorie toutes les campagnes de ce compte publicitaire associées à des recommandations, et affiche des conseils ainsi que l’amélioration attendue du coût par action (CPA).

La nouvelle API permettra aux annonceurs de visualiser les conseils de Meta sur leurs campagnes. Ces données existent déjà dans le Centre des partenaires pour tous les partenaires. Cependant, elles sont disponibles via l’UI, ce qui nécessite de sélectionner manuellement un compte publicitaire unique pour afficher les conseils.

En automatisant l’accès à ces données via l’API CPA_GUIDANCE, nous espérons éliminer les opérations manuelles nécessaires pour consulter les conseils par compte publicitaire. L’accès à cette API permettra à nos partenaires de créer des vues personnalisées en interne et de voir les tendances dans le temps.

Si votre entreprise gère des centaines, voire des milliers de comptes, il est difficile de vérifier les indicateurs un par un, notamment lorsque les délais sont serrés (les recommandations RSS sont mises à jour quotidiennement et prennent en compte les campagnes actives au cours des 28 derniers jours). Cette API permettra aux agences d’identifier les campagnes les plus prometteuses et qui peuvent être optimisées à l’aide des recommandations fournies. Celles-ci seront par la suite intégrées dans leurs systèmes.

L’API CPA_GUIDANCE permet tout particulièrement aux agences d’indiquer à leurs partenaires de marque les produits ou catégories dont le coût par acquisition (CPA) est le plus élevé. En partageant ces informations, les agences peuvent les aider à optimiser leurs dépenses publicitaires et à améliorer les performances globales de leurs campagnes collaboratives.

Les agences pourront également vérifier si une recommandation a été mise en œuvre en observant une évolution positive du CPA.

Publicités multi-annonceurs

Nous lançons aujourd’hui la possibilité pour les annonceurs de participer à des publicités multi-annonceurs via l’API Marketing. Avant cette mise à jour, les développeurs étaient dans l’incapacité de prendre en charge la création de publicités multi-annonceurs via l’API, et leurs client·es ne pouvaient rejoindre des publicités multi-annonceurs que dans le Gestionnaire de publicités Meta.

À propos des publicités multi-annonceurs

Les publicités multi-annonceurs permettent aux internautes de découvrir les produits et les services de plusieurs entreprises. Pour certains placements sur Facebook et Instagram, vos publicités peuvent apparaître aux côtés d’autres publicités dans la même unité publicitaire pour permettre aux internautes de découvrir des produits et services personnalisés de différentes entreprises. Une unité publicitaire est un conteneur qui affiche plusieurs publicités, généralement sur la même page. Pour en savoir plus, consultez nos pages d’aide Business.

Implications pour les développeurs

Lors du lancement, la diffusion des publicités multi-annonceurs créées via l’API Marketing est désactivée par défaut, ce qui signifie que les développeurs devront modifier le code afin que les publicités de leurs client·es puissent être diffusées lors de l’expérience. La création des publicités multi-annonceurs est prise en charge dans toutes les versions de l’API Marketing. Toutefois, toutes les demandes de création de publicité éligibles aux publicités multi-annonceurs doivent préciser si ce type de publicité doit être activé ou non. Le 19 août 2024, les publicités multi-annonceurs seront activées par défaut. Les développeurs qui n’ont pas encore implémenté les modifications de code devront le faire afin de permettre à leurs client·es de se retirer de l’expérience.

L’API Marketing se dote de fonctions d’IA générative pour les contenus publicitaires : génération de texte, agrandissement d’image et génération d’arrière-plan

En octobre 2023, nous avons annoncé le lancement de nos premières fonctionnalités de contenu publicitaire utilisant l’IA générative à savoir la génération de texte, l’agrandissement d’image et la génération d’arrière-plan pour les entreprises dans le Gestionnaire de publicités. Aujourd’hui, nous souhaitons vous annoncer que nous mettons ces fonctionnalités de contenu publicitaire reposant sur l’IA générative à la disposition des annonceurs via notre API Marketing (MAPI) afin que les partenaires, les agences et les annonceurs puissent également profiter des offres GenAI de Meta via MAPI.

Ces fonctionnalités permettent de générer des contenus publicitaires variés rapidement et automatiquement, ouvrant ainsi la voie à une nouvelle manière de penser la créativité via l’optimisation de la productivité, de la personnalisation et des performances pour tous les annonceurs :

• Génération d’arrière-plans : crée jusqu’à quatre arrière-plans pour enrichir les images des produits, ce qui permet de diversifier les contenus publicitaires pour vos audiences. Les arrière-plans générés sont basés sur les images de votre produit d’origine et sont souvent des arrière-plans simples composés de couleurs et de motifs.

• Agrandissement de l’image : ajuste harmonieusement les éléments publicitaires pour qu’ils s’adaptent aux différentes proportions des supports, en commençant par le Fil et prochainement Reels, ce qui vous permet de consacrer moins de temps et de ressources à la réorganisation des éléments des contenus publicitaires.

• Génération de texte : génère plusieurs versions de textes publicitaires à partir de votre copie d’origine, en mettant en avant les arguments de vente des produits/services et en générant plusieurs propositions afin de diversifier vos publicités pour les audiences.

Nous proposons aujourd’hui ces fonctionnalités à davantage d’annonceurs, et nous avons le plaisir de mettre la puissance de notre IA générative à la disposition d’une audience plus vaste.

Conformément à notre approche concernant les tests portant sur de nouveaux produits susceptibles de faire l’objet d’une plus grande vigilance, certains secteurs tels que les services financiers et les produits pharmaceutiques ou de santé, et les publicités relatives au logement, à l’emploi ou aux services et crédits financiers, ainsi qu’aux questions sociales, aux élections ou à la politique peuvent ne pas avoir un accès immédiat à toutes les fonctionnalités d’IA générative.

Comment cela va-t-il fonctionner ?

Nous mettons aujourd’hui en service la prise en charge de ces fonctionnalités dans le cadre de notre API Marketing, et plus particulièrement des API de contenu publicitaire. Les annonceurs auront la possibilité de choisir d’utiliser ces fonctionnalités à partir de l’API et de prévisualiser les contenus publicitaires générés par l’IA à partir de l’API.

L’exemple suivant montre comment intégrer les fonctionnalités d’IA générative dans votre contenu publicitaire sur l’API Marketing.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Remarque : l’exemple ci-dessus montre comment activer la fonction de génération d’arrière-plan. De même, utilisez la clé image_uncrop pour agrandir les images et la clé text_generation dans creative_features_spec pour générer du texte.

Les annonceurs pourront également prévisualiser les contenus publicitaires issus de l’IA générative grâce à l’API. Consultez notre documentation destinée aux développeurs pour en savoir plus sur la manière de générer et de fournir des contenus publicitaires ainsi que de prévisualiser le contenu généré pour chacune de nos fonctionnalités GenAI.

API Video pour Instagram : importation avec reprise pour l’API Video pour Instagram

Mis en service le 15 mai 2024, le nouveau protocole d’importation avec reprise prendra en charge la publication de vidéos Instagram (c’est-à-dire les reels, les stories vidéo et le carrousel vidéo) à partir de vidéos locales et de vidéos dont l’URL est hébergée publiquement. Ce nouveau protocole permet d’importer des fichiers en local et des vidéos plus longues pour les reels uniquement (par exemple, jusqu’à 15 minutes) et de reprendre une importation après une coupure de réseau ou toute autre erreur de transmission.

Jusqu’à présent, pour créer des vidéos Instagram, les fichiers vidéo devaient être importés sur un service d’hébergement accessible au public, où une URL à partager était récupérée par Meta afin de publier la vidéo.

Les détails concernant le flux de publication de contenu amélioré peuvent être consultés dans la documentation pour les développeurs sur la publication de contenu. Des détails supplémentaires concernant le contenu multimédia Instagram peuvent être consultés ici.

API Graph pour Instagram : intégration de nouveaux indicateurs

Dès aujourd’hui, six indicateurs supplémentaires pour le conteneur de médias carrousel seront disponibles pour l’API Graph. Ces indicateurs sont les suivants : J’aime, Commentaires, Partages, Followers, Activité du profil (c’est-à-dire le nombre d’actions effectuées lorsqu’un utilisateur visite votre profil), Visites du profil (c’est-à-dire le nombre de fois où votre profil a été consulté). Ces indicateurs étaient déjà disponibles sur la page relative aux insights d’Instagram, mais cette initiative permettra de s’assurer qu’ils sont également disponibles via l’API Graph.

En ajoutant les mentions J’aime, les commentaires, les partages, les followers, l’activité du profil, les visites du profil aux points de terminaison de l’API Graph pour les publications carrousel, vous devriez être en mesure de consulter ces indicateurs directement à partir de l’appel de l’API.

Veuillez consulter la liste complète de ces indicateurs ici afin d’ajouter les indicateurs pertinents à votre appel d’API GET pour les publications de conteneur de carrousel dès aujourd’hui.

Mise à jour du calendrier d’abandon : API Offline Conversion de Meta

L’année dernière, nous avions annoncé que la version 17 de l’API Offline Conversions ne prendrait plus en charge les évènements hors ligne et que nous prévoyions l’arrêt de l’API Offline Conversions au cours du troisième trimestre 2024. Le calendrier d’abandon anticipé a depuis été mis à jour et nous confirmons que l’API Offline Conversions sera abandonnée en mai 2025. Bien que la date de l’abandon de l’API Offline Conversions ait été repoussée du troisième trimestre 2024 à mai 2025, nous invitons les annonceurs qui utilisent actuellement l’API Offline Conversions (OCAPI) pour envoyer des évènements hors ligne à envisager de migrer leur configuration existante afin de commencer à envoyer des évènements hors ligne par le biais de l’API Conversions (CAPI pour les évènements hors ligne).

Abandons et modifications importantes

Suppression du bouton de réservation dans l’API Messenger

Dès aujourd’hui, le bouton de réservation ne sera plus pris en charge dans les appels de l’API Messenger. Cette modification ne concerne pas les autres modèles et boutons, et les entreprises peuvent toujours gérer les réservations grâce à la Meta Business Suite.

Arrêt de la création des types de publicités Messages sponsorisés dans l’API Marketing

Dès aujourd’hui, la création du type de publicité Messages sponsorisés ne sera plus disponible dans la version 20.0 de l’API Marketing. La prise en charge de la création de ce type de publicité dans les versions précédentes de l’API prendra fin dans 90 jours. Cette modification ne concerne pas les autres types de publicités Envoyer un message.

Nous vous recommandons de consulter les intégrations actuelles et d’ajuster les applications si nécessaire afin d’assurer une transition fluide pour les utilisateur·ices.

Suppression des délais non critiques pour les indicateurs démographiques d’Insights (via l’API Graph pour Instagram externe)

Le 21 mai 2024, nous avons déployé la version 20 de l’API Graph pour Instagram.

90 jours après ce lancement (soit le 19 août 2024), l’API Graph ne partagera plus les indicateurs démographiques sur les membres de l’audience impliqués et touchés dans des délais non critiques pour l’API Graph pour Instagram (par exemple, les informations sur la diffusion par pays, ville, âge et genre au cours des 14 et 90 derniers jours).

L’API Graph pour Instagram continuera d’envoyer des données démographiques pour le mois écoulé (c’est-à-dire this_month) et la semaine écoulée (c’est-à-dire this_week), comme dans l’application Instagram, afin d’assurer la cohérence entre les plateformes.

Cette nouvelle mise à niveau évite toute confusion tout en améliorant la fiabilité et la qualité de nos rapports.

Pour en savoir plus, consultez la documentation pour les développeurs.

Abandon de certaines versions d’API :

Dans le cadre du calendrier de gestion des versions de Facebook pour l’API Graph et l’API Marketing, veuillez noter les abandons prévus prochainement :

API Graph

• 28 mai 2024 : abandon et retrait de la plateforme de la version 13.0 de l’API Graph

• 17 septembre 2024 : abandon et retrait de la plateforme de la version 14.0 de l’API Graph

• 20 novembre 2024 : abandon et retrait de la plateforme de la version 15.0 de l’API Graph

API Marketing

• 13 août 2024 : abandon et retrait de la plateforme de la version 18.0 de l’API Marketing

• 4 février 2025 : abandon et retrait de la plateforme de la version 19.0 de l’API Marketing

Afin d’éviter toute interruption d’activité, nous vous recommandons de migrer tous les appels à la version la plus récente de l’API que nous avons lancée aujourd’hui.

SDK Meta Business

Version 20 du SDK Meta Business

La version 20 du SDK Meta Business sera publiée peu après la publication de la version 20 de l’API Graph. Cette version inclura des corrections de bugs, des mises à niveau de dépendances, de nouvelles fonctionnalités et, surtout, une interface d’API mise à jour pour correspondre à la version 20 de l’API Graph.

Dans cette version, nous introduisons également une assistance supplémentaire pour les API Instagram : IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI et IGAccessTokenForIGOnlyAPI. Elles permettent d’activer d’autres méthodes en plus des API Instagram existantes pour récupérer le contenu multimédia directement. Nous souhaitons intégrer davantage d’API couvrant d’autres produits Meta afin d’enrichir l’écosystème du SDK Business.

Dans le cadre de notre calendrier d’abandon sur deux ans pour les SDK de la plateforme, veuillez noter les abandons et arrêts de prise en charge à venir :

• Mai 2024 : la version 13.0 ou antérieure du SDK de la plateforme Facebook sera abandonnée.