Introducing Graph API v22.0 and Marketing API v22.0
Nous mettons aujourd’hui en ligne la version 22.0 des API Graph et Marketing. 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
Modifications apportées à la version 22 de l’API Marketing concernant l’utilisation des audiences personnalisées basées sur un fichier clientèle dans les campagnes publicitaires portant sur les domaines de l’immobilier, de l’emploi, et des produits et services financiers (y compris pour des crédits)
S’applique aux versions 22.0 et ultérieures et sera déployé sur toutes les versions en mars 2025
Certaines audiences personnalisées basées sur un fichier clientèle ne pourront plus être utilisées dans les ensembles de publicités de campagnes publicitaires dans les domaines de l’immobilier, de l’emploi, ou des produits et services financiers (y compris pour des crédits). Pour en savoir plus sur cette mise à jour et déterminer si elle vous concerne, cliquez ici. De plus, le champ is_sac_cfca_terms_certified sera ajouté au niveau de l’ensemble de publicités, comme dans cet exemple. Vous devrez utiliser ce champ pour certifier, le cas échéant, que les audiences personnalisées basées sur un fichier clientèle (CLCA) que vous utilisez dans des ensembles de publicités pour des campagnes relatives à l’immobilier, l’emploi, ou des produits et services financiers (y compris pour des crédits), sont conformes à la certification CLCA de Meta. À compter d’avril 2025, les campagnes publicitaires ou ensembles de publicités utilisant des audiences personnalisées à partir d’un fichier clientèle et qui ne respectent pas les exigences pourront être mises en pause. Dans ce cas, vous verrez s’afficher des erreurs dans le Gestionnaire de publicités et l’API Marketing, accompagnées d’instructions.
Les points de terminaison suivants seront concernés :
Version 22 de l’API d’audience personnalisée
À partir du 6 janvier 2025, vous pourrez utiliser le nouveau champ is_eligible_for_sac_campaigns pour déterminer si une audience personnalisée peut être utilisée dans les ensembles de publicités de campagnes relevant de catégories publicitaires spéciales. Vous devez fournir les valeurs special_ad_categories et special_ad_category_countries de la campagne à catégorie publicitaire spéciale qui utilise l’audience, ainsi que la valeur ad_account_id qui utilisera l’audience pour créer ou modifier l’ensemble de publicités.
Les points de terminaison suivants seront concernés :
Étendre votre couverture aux personnes intéressées par les villes et régions que vous avez sélectionnées
Nous avons le plaisir de vous annoncer le lancement d’une nouvelle fonctionnalité de ciblage géographique qui permettra aux annonceurs d’accroître leurs performances au delà des villes ou régions ciblées, en donnant à notre système publicitaire la flexibilité nécessaire pour diffuser des publicités après des personnes qui ont manifesté un intérêt pour un lieu donné.
Cette fonctionnalité va plus loin que notre fonctionnalité de ciblage géographique : vous pourrez cibler des personnes qui ont l’intention d’effectuer des achats ou de voyager dans des villes ou régions que vous ciblez, ou qui portent simplement un intérêt général à ces villes ou régions, le tout au sein d’un même pays.
Lors des tests, les clients qui ont utilisé la nouvelle fonctionnalité de ciblage géographique ont constaté une diminution de 6,7 % du coût par résultat.
Cliquez ici pour obtenir plus d’informations.
Abandons et modifications importantes
Remplacement des points de terminaison Utilisateur Instagram, Média Instagram, Carrousel Instagram et Commentaire Instagram par les points de terminaison Utilisateur IG, Média IG et Commentaire IG
Nous apportons des modifications à l’API Graph pour Instagram et à l’API Marketing afin de permettre aux développeur·ses de créer des solutions pour les entreprises plus facilement. En raison de ces changements, les objets Utilisateur Instagram, Contenu multimédia Instagram, Carrousel Instagram et Commentaire Instagram ne seront plus pris en charge dans la version 22 de l’API Graph, et ce au profit des objets existants Utilisateur IG, Contenu multimédia IG, qui inclut les carrousels, et Commentaire IG. Nous avons également ajouté des fonctionnalités à ces objets afin d’assurer la parité dans la plupart des cas d’utilisation.
Les développeur·ses auront jusqu’au 21 janvier 2026 pour mettre à jour les points de terminaison de l’API Marketing concernés et jusqu’au 21 avril 2025 pour mettre à jour les points de terminaison de l’API Graph concernés. Si la mise à jour des versions de l’API Graph est automatique dans vos appels d’API, nous vous recommandons de consulter ces modifications, car elles s’appliquent immédiatement aux développeur·ses qui utilisent la version 22 de l’API Graph.
Consultez le blog des développeur·ses afin d’obtenir plus de détails sur ces modifications, notamment les points de terminaison modifiés, les cas d’utilisation qui ne sont plus pris en charge et le calendrier qui s’applique.
Suppression des exclusions de ciblage avancé
Dans le cadre de nos efforts continus pour permettre aux annonceurs d’améliorer leurs performances, nous supprimons les exclusions de ciblage avancé. Vous garderez cependant la possibilité d’exclure les employeurs par le biais des contrôles d’audience au niveau du compte. Pour en savoir plus sur les contrôles de compte, cliquez ici.
Ces modifications devraient permettre d’améliorer les performances de campagne. Un test annonceur a montré que le coût médian par conversion était inférieur de 22,6 % lorsque les exclusions de ciblage avancé n’étaient pas utilisées, par rapport aux cas où elles étaient utilisées.
À la suite de cette modification, les audiences personnalisées ne seront plus prises en charge dans le champ des exclusions. Pour continuer à utiliser les exclusions d’audiences personnalisées, vous pouvez utiliser le champ excluded_custom_audiences.
À compter du 21 janvier 2025, les équipes de développement peuvent commencer à modifier le code. Elles auront jusqu’au 21 avril 2025 pour effectuer ces modifications. Cette modification figurera dans la version 22. Consultez le blog des développeur·ses pour obtenir la liste des points de terminaison concernés par cette modification.
Abandon du pack d’améliorations standard de l’API Marketing
Impacts de la version 22.0 de l’API Marketing sur les améliorations du contenu publicitaire Advantage+
Dans cette nouvelle version de l’API Marketing, nous supprimerons le pack d’améliorations standard du contenu publicitaire Advantage+, en le remplaçant par des améliorations individuelles du contenu publicitaire. Pour en savoir plus sur le contenu publicitaire Advantage+, cliquez ici.
Vous trouverez ici des informations pertinentes pour la communauté des développeur·ses. Vous trouverez des détails supplémentaires dans la documentation destinée aux développeur·ses en cliquant ici.
Les améliorations standard ne seront plus prises en charge sur les points de terminaison suivants :
- POST /{ad_account_id}/adcreatives
- POST /{ad_account_id}/ads
- GET /{ad_id}/previews
Présentation de l’indicateur des vues sur Instagram et suppression des indicateurs d’impressions et de lectures
Pour continuer à harmoniser les fonctionnalités de l’API Instagram avec celles de son application, nous avons ajouté l’indicateur « views » sur toutes les versions de l’API pour les statistiques relatives au contenu multimédia et aux utilisateur·ices. Pour les statistiques de contenu multimédia, les objets Fil, Story et Reels renverront les vues. Pour les statistiques sur les utilisateur·ices, l’API prendra en charge l’indicateur « views » avec des répartitions multidimensionnelles pour le type de follower et le type de produit multimédia.
En outre, les indicateurs suivants ne seront plus pris en charge à partir de la version 22 :
- plays (statistiques sur le contenu multimédia) : nombre de fois que la lecture des reels commence après une impression déjà comptabilisée.
- clips_replays_count (statistiques sur le contenu multimédia) : nombre de fois que votre reel commence à être relu après sa lecture initiale. Cela correspond à une relecture d’une durée minimale d’une milliseconde au cours d’une même session de consultation de reels.
- ig_reels_aggregated_all_plays_count (statistiques sur le contenu multimédia) : nombre de fois que votre reel commence à être lu ou relu après une impression déjà comptabilisée.
- impressions (statistiques sur le contenu multimédia et les utilisateur·ices) : nombre total de vues de l’objet Contenu multimédia Instagram.
L’indicateur « impressions » dans les statistiques sur le contenu multimédia n’est obsolète que pour les contenus multimédias créés à compter du 2 juillet 2024. Pour le contenu multimédia créé avant cette date, l’API continuera de renvoyer des valeurs comme d’habitude pour toutes les versions.
Vous trouverez plus d’informations dans notre documentation destinée aux développeur·ses pour Instagram User Insights et Instagram Media Insights. Nous vous invitons à informer vos développeur·ses des mises à jour à effectuer d’ici le 21 avril 2025 afin d’éviter tout problème.
SDK Meta Business
Version 22 du SDK Meta Business
La version 22 du SDK Meta Business sera publiée peu après la publication de la version 22 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 22 de l’API Graph.
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 2025 : la version 17.0 ou antérieure du SDK de la plateforme Facebook ne seront plus prisent en charge.
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
- 14 mai 2025 : la version 16.0 de l’API Graph sera abandonnée et supprimée de la plateforme
- 12 septembre 2025 : la version 17.0 de l’API Graph sera abandonnée et supprimée de la plateforme
API Marketing
- 4 février 2025 : la version 19.0 de l’API Marketing sera abandonnée et supprimée de la plateforme
- 16 mai 2025 : la version 20.0 de l’API Marketing sera abandonnée et supprimée de la plateforme
Afin d’éviter toute interruption d’activité, 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.
