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

23 janvier 2024DeMohamed Amr Abouelhassan

Aujourd’hui, nous publions la version 19.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 notre changelog pour obtenir la liste complète et détaillée de toutes les modifications.

Mises à jour générales

Activer le ciblage avancé Advantage pour toutes les optimisations et tous les objectifs de campagne

Dans le cadre de notre démarche permanente visant à aider les annonceurs à améliorer leurs performances, nous proposons désormais notre produit de ciblage avancé Advantage pour l’ensemble des optimisations et objectifs de campagne.

Le ciblage avancé Advantage fait partie de notre suite de produits Advantage, qui s’appuie sur une automatisation avancée, ainsi que sur la technologie du machine learning, afin d’aider les annonceurs à améliorer les performances de leurs campagnes. Concrètement, le ciblage avancé Advantage contribue à l’amélioration des performances d’une campagne, car il permet à notre système de toucher une audience plus vaste que celle initialement définie par un annonceur en matière de ciblage avancé s’il estime que ces modifications sont susceptibles d’améliorer les performances.

Le 23 janvier 2024, nous effectuons les modifications suivantes pour les annonceurs et partenaires utilisant l’API Marketing :

Les campagnes optimisées pour les objectifs Impressions, Vues de vidéos, Couverture, Interactions ou Augmentation de la mémorisation publicitaire peuvent désormais opter pour le ciblage avancé Advantage.
Les campagnes optimisées pour l’objectif Prospects bénéficieront automatiquement du ciblage avancé Advantage, avec toutefois la possibilité d’y renoncer.
- Remarque importante : cette option sera activée pour les campagnes et ensembles de publicités dupliqués ou nouveaux. Vous pouvez utiliser le même bouton pour la désactiver si vous le souhaitez.
Le ciblage avancé Advantage sera automatiquement appliqué aux campagnes optimisées pour les objectifs Clics sur un lien ou Vues de page de destination, sans possibilité d’y renoncer.

Pour les annonceurs et partenaires qui utilisent l’API Marketing, ces modifications représentent un changement radical. À partir du 23 janvier 2024, les équipes de développement peuvent commencer à modifier le code. Elles auront jusqu’au 22 avril 2024 pour effectuer des mises à jour. Cette modification figure dans la nouvelle version V19 de l’API.

<Impacted endpoints>

Type de demande	Point de terminaison	Modifications
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	Le champ ‘targeting_optimization’ ne sera pas accepté pour les campagnes optimisées pour les objectifs Clics sur un lien ou Vues de page de destination. Cela est également valable pour les optimisations précédentes incluses dans le ciblage avancé Advantage, notamment les conversions, la valeur, les installations d’applications, les évènements d’application et les conversations, et il n’est pas possible d’y renoncer. Le champ targeting_as_signal doit indiquer null ou 0 pour les campagnes optimisées pour les objectifs Impressions, Vues de vidéos, Couverture, Interactions, Augmentation de la mémorisation publicitaire ou Prospect, sans quoi une erreur sera renvoyée.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	Le champ ‘targeting_optimization’ ne sera pas accepté pour les campagnes optimisées pour les objectifs Clics sur un lien ou Vues de page de destination. Cela est également valable pour les optimisations précédentes incluses dans le ciblage avancé Advantage, notamment les conversions, la valeur, les installations d’applications, les évènements d’application et les conversations, et il n’est pas possible d’y renoncer. Pour toutes les optimisations faisant l’objet d’une option obligatoire de ciblage avancé Advantage, nous définissons automatiquement la valeur du champ targeting_as_signal sur 1 ou 3 selon l’ensemble d’objectifs et d’optimisations.

Type de demande

Point de terminaison

Modifications

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

Le champ ‘targeting_optimization’ ne sera pas accepté pour les campagnes optimisées pour les objectifs Clics sur un lien ou Vues de page de destination. Cela est également valable pour les optimisations précédentes incluses dans le ciblage avancé Advantage, notamment les conversions, la valeur, les installations d’applications, les évènements d’application et les conversations, et il n’est pas possible d’y renoncer.
Le champ targeting_as_signal doit indiquer null ou 0 pour les campagnes optimisées pour les objectifs Impressions, Vues de vidéos, Couverture, Interactions, Augmentation de la mémorisation publicitaire ou Prospect, sans quoi une erreur sera renvoyée.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

Le champ ‘targeting_optimization’ ne sera pas accepté pour les campagnes optimisées pour les objectifs Clics sur un lien ou Vues de page de destination. Cela est également valable pour les optimisations précédentes incluses dans le ciblage avancé Advantage, notamment les conversions, la valeur, les installations d’applications, les évènements d’application et les conversations, et il n’est pas possible d’y renoncer.
Pour toutes les optimisations faisant l’objet d’une option obligatoire de ciblage avancé Advantage, nous définissons automatiquement la valeur du champ targeting_as_signal sur 1 ou 3 selon l’ensemble d’objectifs et d’optimisations.

Publicités, ensembles de publicités et campagne utilisant des objectifs originaux de l’API Marketing

À partir de la version 19.0 de l’API Marketing, il n’est plus possible de créer des publicités, des ensembles de publicités et des campagnes utilisant des objectifs originaux (énumérés ci-dessous) par le biais d’un texte de publicité. Les objectifs publicitaires devront être mis à jour afin de refléter nos objectifs simplifiés.

À partir de la version 20 de l’API Marketing, la création de publicités et d’ensembles de publicités dans le cadre de campagnes avec un objectif originaux ne sera plus prise en charge. Cependant, toutes les versions de l’API antérieures à 20 (par ex. : 19, 18) autoriseront toujours cette fonctionnalité. Aucune action immédiate n’est nécessaire pour les publicités existantes utilisant les objectifs originaux.

Objectifs originaux concernés

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

Points de terminaison POST concernés

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

Pour référence, vous trouverez ici la précédente publication du blog pour développeur·euses concernant les modifications de l’API pour la création de campagnes à l’aide des objectifs originaux.

Questions/réponses

Q : Ce changement nécessite-t-il de mettre à jour le code ?

R : Oui, plusieurs appels d’API de la version 18 ne fonctionneront pas sur la version 19 (par exemple, les publicités, les ensembles de publicités et les campagnes utilisant des objectifs originaux ne pourront plus être créés via du texte de publicité).

Q : Quel est le comportement attendu avant et après le changement ?

R : Avant, les appels d’API pour dupliquer une publicité, un ensemble de publicités ou une campagne utilisant des objectifs originaux aboutissaient. Ils échouent désormais.

Q : Quand ces modifications du code seront-elles appliquées ?

R : Jusqu’à l’abandon de la version 18.0, prévue pour septembre 2024.

Documentation supplémentaire destinée aux développeur·euses

Articles d’aide

PPCA (autorisation d’accès au contenu public de la Page)

Le cas d’utilisation pour des données collectées via PPCA (autorisation d’accès au contenu public de la Page) a changé. Pour plus de détails, consultez le lien suivant.

Présentation de l’API Audience Advantage+

En octobre de l’année dernière, nous avons lancé l’audience Advantage+, une nouvelle expérience simplifiée de création d’audience qui permet d’améliorer les performances des campagnes en élargissant l’audience potentielle d’une publicité, tout en continuant à diffuser des publicités auprès des personnes que les annonceurs souhaitent le plus toucher.

Nous mettons désormais à disposition l’audience Advantage+ sur l’API Marketing.

Pour l’activer, définissez le paramètre targeting_automation dans advantage_audience sur 1.
Pour la désactiver, définissez le paramètre targeting_automation dans advantage_audience sur 0.

Abandons et modifications importantes

Abandon de l’API Groupes Facebook

L’API Groupes Facebook n’est plus disponible dans la version 19. Elle sera retirée de toutes les versions dans 90 jours. Cet abandon inclut toutes les autorisations (publish_to_groups, groups_access_member_info), ainsi que les fonctionnalités révisables (API Groupes) associées à l’API Groupes Facebook.

Un cas d’utilisation majeur de l’API Groupes était les réponses privées dans les groupes. Nous apportons une autre modification dans la version 19 qui rendra possible ce cas d’utilisation sans que les développeur·euses aient besoin d’utiliser l’API Groupes. Pour les développeur·euses de réponses privées, aucune modification ne sera apportée à la version 19. Pour les développeur·euses qui comptaient sur les appels aux points de terminaison d’une publication de groupes via l’API Groupes après avoir reçu un webhook Réponses privées, elles et ils devront désormais utiliser un token d’accès de Page pour ces demandes.

Pour les développeur·ses qui ne savent pas si leurs points de terminaison utilisent une autorisation abandonnée, elles et ils peuvent le vérifier en testant les points de terminaison dans la version 19.0.

Modifications de l’API Page Insights : abandon d’indicateurs

Avec le transfert des Pages classiques vers la nouvelle version des Pages sur Facebook, nous cesserons de prendre en charge un certain nombre d’indicateurs de l’API Page Insights. Pour en savoir plus, consultez ce lien.

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 février 2024 : la version 12.0 de l’API Graph sera abandonnée et supprimée de la plateforme
28 juin 2024 : la version 13.0 de l’API Graph sera abandonnée et supprimée de la plateforme
17 septembre 2024 : la version 14.0 de l’API Graph sera abandonnée et supprimée de la plateforme

API Marketing

6 février 2024 : la version 16.0 de l’API Marketing sera abandonnée et supprimée de la plateforme
14 mai 2024 : la version 17.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 Meta Business

Publication de la version 19 du SDK Meta Business

La version 19 du SDK Meta Business sera publiée peu après la version 19 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 19 de l’API Graph. À l’avenir, nous prévoyons des lancements de versions plus rapprochés du SDK afin de nous aligner sur la cadence des mises à jour de l’API. Cela permettra aux développeur·euses de suivre le rythme des dernières API et fonctionnalités.

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 :