Présentation de la version 17.0 des API Graph et Marketing de Facebook

Aujourd’hui, nous mettons en ligne la version 17.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 concernant les produits et des notifications d’abandons que nous estimons pertinentes pour l’intégration de vos applications à notre plateforme.

Consultez la liste complète des modifications et leur description détaillée dans notre changelog.

Abandons et modifications importantes

Abandon de l’outil Stratégies publicitaires

Le produit bêta Stratégies publicitaires a été abandonné depuis le 28 octobre 2022. C’est pourquoi nous abandonnons les champs ad_strategy_id et ad_strategy_group_id sur le point de terminaison des campagnes dans la version 17.0 de l’API Marketing.

Abandon de l’API Offline Conversions

Depuis février 2023, l’API Conversions prend entièrement en charge les évènements hors ligne, assurant ainsi la parité avec les fonctionnalités fournies par le point de terminaison de l’actuelle API Offline Conversions. En regroupant nos API relatives aux évènements web et hors ligne dans une seule et même API, nous espérons aider les annonceurs à exploiter de façon plus simple et efficace leurs données marketing sur ces différents canaux pour améliorer l’optimisation des publicités, les audiences personnalisées et les mesures.

À partir de la version 17 de l’API Graph, publiée le 23 mai 2023, l’API Offline Conversions ne prend plus en charge les évènements hors ligne. Nous recommandons aux annonceurs qui ont mis en place une intégration avec l’API Offline Conversions de transformer leur intégration en intégration avec l’API Conversions et de ne pas mettre à jour leur API Offline Conversions avant d’avoir réussi cette transformation.

Abandon des anciens objectifs lors de la création de campagnes

Comme annoncé en décembre 2021, nous avons repensé l’expérience de sélection des objectifs lors de la création de nouvelles campagnes pour orienter efficacement les annonceurs vers des configurations de campagnes qui les aideront à atteindre leurs objectifs marketing. Cette nouvelle expérience, qualifiée d’expérience publicitaire basée sur les résultats, a entraîné des modifications de l’API Marketing.

Nous lancerons le processus d’abandon de l’ancienne expérience et des anciens objectifs à partir du lancement de l’API Marketing version 17.0. Avec la version 17.0 de l’API Marketing, les campagnes ne pourront être créées qu’avec les objectifs associés à l’expérience publicitaire basée sur les résultats et les API des anciens objectifs seront abandonnées. Les campagnes existantes et la duplication des anciennes campagnes existantes seront toujours prises en charge et ne seront pas impactées dans cette version. Pour plus d’informations, lisez notre récente publication de blog destinée aux développeur·ses.

Améliorations standard du contenu publicitaire Advantage+ : champ obligatoire

Plus tôt cette année, nous avons lancé les améliorations standard du contenu publicitaire Advantage+ sur l’API Marketing. À compter du 23 mai 2023, les utilisateur·ices de l’API Marketing doivent spécifier pour chaque annonce si elle est inscrite ou non aux améliorations standard du contenu publicitaire Advantage+, en indiquant la valeur OPT_IN ou OPT_OUT dans le champ enroll_status. Si ce champ n’est pas renseigné, l’utilisateur·ice reçoit une erreur et est invité·e à remplir le champ concerné. Pour en savoir plus sur les améliorations standard du contenu publicitaire Advantage+ dans l’API Marketing, consultez cette publication de blog pour développeur·ses.

Les points de terminaison suivants sont concernés :

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

Abandon des publicités de catalogue Advantage+ pour le streaming

Avec le lancement de l’API Marketing version 17, nous abandonnons les publicités de catalogue Advantage+ (A+CA, Advantage+ Catalog Ads) pour le streaming dans l’utilisation du catalogue. Les publicités de catalogue commercial sont l’alternative recommandée aux A+CA pour le streaming. Voici un guide de configuration d’un catalogue commercial. Les points de terminaison suivants seront abandonnés :

• Création d’un catalogue A+CA pour le streaming : arête owned_product_catalogs avec le secteur media_titles
• Importation de flux de titres multimédias : arête product_feeds pour un catalogue d’A+CA pour le streaming
• Création d’un élément de titre multimédia : arête media_titles pour un catalogue d’A+CA pour le streaming
• Création d’une campagne à l’aide d’un catalogue d’A+CA pour le streaming : arête campaigns avec un catalogue DAS sur L3, L2 ou L1

Le 21 août 2023, les changements ci-dessus s’appliqueront à toutes les versions de l’API Marketing et nous suspendrons toutes les campagnes comprenant des catalogues d’A+CA pour le streaming associés au niveau L3, L2 ou L1.

Abandon de l’API Instant Articles

Sachant que le produit Instant Articles a été abandonné le 20 avril 2023, une API permettant aux éditeur·ices de gérer leurs Instant Articles sera maintenant abandonnée.

Mise en œuvre de l’autorisation de gestion d’entreprise sur les comptes d’utilisateur·ices

Auparavant, les Pages administrées d’entreprise supplémentaires étaient renvoyées sans l’autorisation business_management. À compter du 23 mai 2023, si vous souhaitez continuer à accéder à de telles Pages administrées d’entreprise, l’autorisation business_management est requise. Vous pouvez vous reporter à la page business_management pour en savoir plus sur cette autorisation.

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

• 8 juin 2023 : la version 10.0 de l’API Graph sera abandonnée et supprimée de la plateforme
• 14 septembre 2023 : la version 11.0 de l’API Graph sera abandonnée et supprimée de la plateforme
• 8 février 2023 : la version 12.0 de l’API Graph sera abandonnée et supprimée de la plateforme

API Marketing

• 15 août 2023 : la version 14.0 de l’API Marketing sera abandonnée et supprimée de la plateforme
• 15 août 2023 : la version 15.0 de l’API Marketing sera abandonnée et supprimée de la plateforme

Afin d’éviter tout désagrément pour votre entreprise, nous vous recommandons de migrer tous les appels vers la version la plus récente de l’API que nous avons lancée aujourd’hui.

SDK de la plateforme Facebook

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 :

• Juin 2023 : les versions 9.0 et antérieures du SDK de la plateforme Facebook ne seront plus prises en charge
• Octobre 2023 : les versions 11.0 et antérieures du SDK de la plateforme Facebook ne seront plus prises en charge
• Février 2024 : les versions 12.0 et antérieures du SDK de la plateforme Facebook ne seront plus prises en charge