Revenir aux actualités des développeurs

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

15 septembre 2022DeAchyuth Venkatesh

Aujourd’hui, nous mettons en ligne la version 15.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 nos équipes de développement. Parmi ces modifications, découvrez des annonces, des mises à jour concernant les produits et des notifications sur des abandons que nous estimons pertinentes pour l’intégration de vos applications à notre plateforme.

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

Annonces et mises à jour générales

Simplification des critères de création des conversions personnalisées

Afin de simplifier le processus de création de campagnes pour les annonceurs, les conversions personnalisées nouvellement créées nécessiteront au moins une règle associée à la version 15.0 de l’API Graph. Les conversions personnalisées ne nécessitant pas de règles devront utiliser l’optimisation des évènements personnalisés qui permet d’optimiser les campagnes publicitaires directement sur l’évènement personnalisé. Nous travaillons activement à la transition de nos conversions personnalisées existantes pour les faire passer d'une offre unique, tout-en-un, vers des produits multiples, spécifiques de la valeur, afin de mieux répondre aux besoins et aux cas d'utilisation de nos annonceurs. Cette modification poussera les annonceurs à abandonner les conversions personnalisées basées sur les évènements pour passer à l'optimisation des évènements personnalisés.

Mises à jour des Conditions générales de la Plateforme

Nous mettons à jour les Conditions générales de la Plateforme concernant les situations pour lesquelles nous sommes susceptibles de supprimer l’accès d’une application à n’importe quelle API, autorisation ou fonctionnalité de la Plateforme que votre application n’a pas utilisée ni à laquelle elle n’a pas accédé depuis un certain temps. À compter du 15 décembre 2022, les Conditions générales de la Plateforme requerront une activité dans les 28 jours pour que votre application soit considérée comme active.

Si vous recevez une notification selon laquelle votre application est inactive et que vous souhaitez la rétablir, vous pouvez le faire en accédant à votre rôle d’admin de l’application.

Vous pouvez consulter ici les Conditions générales de la Plateforme pour obtenir un aperçu complet de ces modifications.

Abandons et modifications importantes

Présentation de l’audience personnalisée Advantage

À compter du 19 septembre 2022, nous allons commencer à déployer l’audience personnalisée Advantage. Celle-ci utilise l’audience personnalisée d’un annonceur pour guider la diffusion et pour trouver davantage d’internautes susceptibles d’atteindre l’objectif d’optimisation souhaité. Cela signifie que nous diffuserons des publicités au-delà de leur audience personnalisée si cela est susceptible d’améliorer les performances. L’audience personnalisée Advantage fait partie de notre gamme de produits de ciblage Advantage, notamment le ciblage détaillé Advantage et les audiences similaires Advantage. Nos produits de ciblage Advantage s'appuient sur une technologie avancée d'automatisation et de machine learning qui permet d'améliorer les performances des campagnes des annonceurs avec moins d’intervention manuelle.

Les annonceurs s’appuyant sur les audiences personnalisées pourront sélectionner les audiences personnalisées Advantage. Avec les audiences personnalisées Advantage, les annonceurs continueront de créer une audience personnalisée (site web, activité de l’application, liste de clients ou interactions) et d’appliquer les inclusions/exclusions pertinentes tout en bénéficiant de notre technologie avancée d'automatisation et de machine learning qui utilise votre audience personnalisée comme source de guidage pour la diffusion afin de cibler davantage d’utilisateur·ices susceptibles d’atteindre l’objectif d’optimisation souhaité.

Les audiences personnalisées Advantage seront automatiquement activées lors de la création d’une nouvelle campagne qui inclut une audience personnalisée de site web, personnalisée mobile ou personnalisée d’interaction. Vous pouvez choisir de désactiver ce produit en décochant la case Audiences personnalisées Advantage dans la section Audience personnalisée de notre outil de création de publicités.

Abandon d’audiences publicitaires spéciales

Dans le cadre de notre accord avec le Département du logement et du développement urbain des États-Unis, nous ne prendrons plus en charge les audiences publicitaires spéciales (cet outil permettait aux annonceurs de développer leurs audiences pour des ensembles de publicités concernant le logement, l’emploi et le crédit). Nous allons supprimer la possibilité de créer des audiences publicitaires spéciales via l’API Marketing à compter du 15 septembre 2022.

Pour les annonceurs et les partenaires, le blocage de la création de nouvelles audiences publicitaires spéciales à compter du 15 septembre 2022 représentera une modification importante, car, cette modification n’affectant pas la gestion des versions, les valeurs antérieures seront obsolètes. En 2019, en plus de l'élimination de certaines options de ciblage pour les publicités relatives au logement, à l'emploi et au crédit, nous avons introduit des audiences publicitaires spéciales comme alternative aux audiences similaires. Mais l'équité dans le machine learning est un domaine dynamique et en pleine évolution, et les audiences publicitaires spéciales ont été un moyen précoce de répondre aux préoccupations. Désormais, nous allons nous concentrer sur de nouvelles approches afin d’améliorer l’équité, y compris la méthode annoncée précédemment.

Consultez la liste ci-dessous des points de terminaison concernés par cet abandon :

Pour l’audience de lecture :

  • point de terminaison gr:get:AdAccount/customaudiences
  • champ operation_status

Pour la création d’ensembles de publicités :

  • point de terminaison gr:post:AdAccount/adsets
  • champ subtype

Pour la modification d’ensembles de publicités :

  • point de terminaison gr:post:AdCampaign
  • champ subtype

Pour la création d’audiences personnalisées :

  • point de terminaison gr:post:AdAccount/customaudiences
  • champ subtype

Pour la modification d’audiences personnalisées :

  • point de terminaison gr:post:CustomAudience

Veuillez consulter la publication de blog précédente et la documentation pour les équipes de développement pour en savoir plus sur la prise en charge de l’implémentation de codes.

Parité ciblage détaillé Advantage / audience similaire Advantage

Ce projet apporte la parité au ciblage détaillé en tant que signal (ciblage détaillé Advantage) pour les utilisateur·ices de l'API ayant des ensembles de publicités avec des messages/installations d'applications comme objectifs (version ultérieure du Gestionnaire de publicités). Nous avons précédemment lancé le ciblage détaillé Advantage pour les API vers les ensembles de publicités avec les Conversions comme objectif et les Conversions/Valeur comme objectifs d'optimisation (ensembles de publicités VO/OC).

Actuellement, lorsque des annonceurs créent des ensembles de publicités via l’API avec des messages ou des installations d’applications comme objectif, ils·communiquent deux éléments dans le cadre des critères de ciblage (L2). Ils·transmettent une liste d’entrées de ciblage détaillé (par exemple, cricket, football, chiens, etc.) et un indicateur signalant s’ils souhaitent aller au-delà de ces entrées (appelé ciblage détaillé Advantage). Lorsque cet indicateur est activé, nos systèmes diffusent au-delà de leurs sélections de ciblage détaillé si cela est susceptible d’améliorer les performances. Lorsqu’il est désactivé, nos systèmes limitent la diffusion à la liste de sélections fournie par les annonceurs.

À l'avenir (version ultérieure du Gestionnaire de publicités), lorsque les annonceurs créeront de nouvelles campagnes avec des messages ou des installations d'applications mobiles comme objectifs, leurs inclusions de ciblage détaillé seront utilisées comme entrée (et non comme contrainte) pour guider la diffusion des publicités. En conséquence, nous abandonnons l'indicateur DTE pour ces objectifs et faisons de l'extension du ciblage le comportement par défaut des sélections de ciblage détaillé. En procédant ainsi, nous pouvons aller au-delà de leurs inclusions de ciblage détaillé si cela est susceptible d’améliorer les performances. Aucune des autres sélections et inclusions de ciblage ne sera affectée. Cette modification ne s’appliquera pas aux catégories spéciales.

Fonctionnement :

Auparavant, les annonceurs transmettaient l'indicateur targeting_optimization avec une valeur de expansion_all ou none pour activer ou désactiver l'extension du ciblage détaillé. Compte tenu de la modification de la sémantique du fonctionnement du ciblage détaillé pour ces ensembles de publicités, les annonceurs n'ont pas besoin de transmettre cet indicateur lorsqu'ils·créent des ensembles de publicités avec des messages ou des installations d'applications comme objectif, car cela n'aura aucun impact sur leurs ensembles de publicités nouvellement créés. Tous ces ensembles de publicités nouvellement créés utiliseront toujours des inclusions de ciblage détaillé comme signal pour nos systèmes backend ; celles-ci peuvent décider de diffuser des publicités au-delà de ces sélections si cela se traduit par de meilleures performances pour les annonceurs.

Étant donné que l'indicateur targeting_optimization n'aura aucun effet sur les ensembles de publicités nouvellement créés, nous prévoyons d’abandonner ce champ à l’avenir pour les nouvelles campagnes ayant des messages et/ou des installations d’applications comme objectif.

  • À cet effet, si les annonceurs transmettent l’indicateur targeting_optimization lorsqu'ils·créent de nouveaux ensembles de publicités MAI/messages ou lorsqu'ils demandent les estimations de diffusion de ces ensembles de publicités nouvellement créés, nous enverrons un message d'erreur leur demandant de ne plus envoyer ce paramètre.
  • Un nouveau champ intitulé targeting_as_signal sera défini dans le système backend lors de la création d’ensembles de publicités avec des installations d’applications/messages. Ce champ sera disponible sur les commandes GET uniquement pour permettre aux annonceurs de vérifier si leurs ensembles de publicités vont au-delà des inclusions de ciblage détaillé.

REMARQUE : ces modifications apportées au ciblage détaillé en tant que signal s’appliqueront uniquement aux ensembles de publicités nouvellement créés avec des messages et/ou des installations d’applications comme objectif.

Points de terminaison de l'API dans le champ d'application :

  • gr:post:/act_XXXX/ adsets
  • gr:get:/<adset_id>/delivery_estimate

Abandon des onglets Pages

Notez que les fonctionnalités d’onglet personnalisé de l’API Pages ne seront plus disponibles via l’API Graph. Comme nous déployons la nouvelle version des Pages, certaines fonctionnalités de l’API Pages seront abandonnées à l’avenir. Comme les fonctionnalités d’onglet personnalisé des Pages ne seront plus disponibles sur la nouvelle version des Pages, nous allons supprimer la prise en charge de ces fonctionnalités par l'API. Nous partageons ces mises à jour maintenant pour donner aux équipes de développement et à leurs client·es suffisamment de temps pour communiquer l’abandon de ces fonctionnalités à partir de leur(s) page(s) et apporter les modifications nécessaires à ces pages. Cette fonctionnalité sera entièrement abandonnée le 14 décembre 2022.

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

  • 1er novembre 2022 : la version 8.0 de l’API Graph sera abandonnée et supprimée de la plateforme
  • 23 février 2023 : la version 9.0 de l’API Graph sera abandonnée et supprimée de la plateforme
  • 8 juin 2023 : la version 10.0 de l’API Graph sera abandonnée et supprimée de la plateforme

Pour é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 :

  • Janvier 2023 : les versions 8.0 et antérieures du SDK de la plateforme Facebook ne seront plus prises en charge
  • 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