Introducing Facebook Graph API v10.0 and Marketing API v10.0

Nous publions aujourd’hui la version 10.0 des API Graph et Marketing de Facebook.

Cette nouvelle version inclut plusieurs annonces, mises à jour, fins de prise en charge et annulations de fin de prise en charge qui peuvent avoir des conséquences sur la façon dont vos applications s’intègrent à notre plate-forme. La présente publication détaille ces mises à jour ainsi que les étapes à suivre pour les développeurs afin d’éviter tout désagrément, le cas échéant.

Des informations détaillées relatives à toutes les modifications sont fournies ci-dessous. Pour plus d’informations sur les caractéristiques techniques, consultez le changelog de la version 10.0.

Consultez le Centre d’initiatives de la plate-forme pour en savoir plus sur notre plate-forme pour les développeurs.

Annonces et mises à jour

Certification relative au Contrôle de l’utilisation des données

Pour conserver votre accès aux API de la plate-forme Facebook, veuillez réaliser le Contrôle de l’utilisation des données (CUD) dans un délai de 60 jours suivant votre inscription. Vous pouvez réaliser le CUD en vous rendant sur la page Mes applications dans votre Espace App.

À l’automne dernier, Facebook a lancé le Contrôle de l’utilisation des données (CUD), un nouveau processus annuel permettant aux développeurs de certifier qu’ils accèdent aux API et utilisent les données dans le respect des Conditions de la plate-forme Facebook et des Politiques des développeurs.

Dans le cadre de notre déploiement progressif concernant toutes les applications, vous recevrez une date d’échéance et des instructions supplémentaires par le biais d’une alerte développeur, ainsi qu’un e-mail envoyé à l’adresse de contact enregistrée et une notification dans votre liste d’actions requises dans l’Espace App.

Pour obtenir des instructions détaillées sur la réalisation du CUD, vous pouvez consulter notre documentation pour les développeurs. Vous pouvez également en savoir plus dans les questions/réponses consacrées au CUD.

Limites de données et niveaux d’accès aux données API Groups pendant 90 jours :

À compter du 24 mai 2021, lorsque vous utiliserez l’API Groups, la durée d’accès aux données disponibles des applications sera limitée à 90 jours.

Nous avons également introduit un accès par niveau à l’API Groups pour les applications pour les consommateurs selon qu’elles sont en mode développement ou en mode en ligne. Les autorisations API Groups fonctionnent à présent de manière identique à celle des niveaux d’accès Standard et Avancé pour les applications pour les entreprises.

Aujourd’hui, les applications en mode développement peuvent accéder à tous les contenus des groupes publics et des groupes privés lorsque le développeur est administrateur. Après avoir passé le Contrôle app, ces applications peuvent accéder à tous les contenus des groupes qui ont installé l’application en question.

Le 24 mai 2021, les applications en mode développement pourront uniquement accéder à leurs propres contenus dans les groupes publics et les groupes privés lorsque le développeur est administrateur. L’application n’aura donc pas accès aux contenus que les utilisateurs d’autres groupes (sans rôle dans l’application) ont publiés, tels que des publications et des commentaires.

Pour en savoir plus, consultez le changelog de la version 10.0.

Niveaux d’accès pour les autorisations public_profile et email pour les applications Entreprise

Dans le cadre de nos efforts continus visant à préserver et protéger les données de nos utilisateurs, nous avons ajouté les autorisations public_profile (c’est-à-dire les champs Profil public par défaut) et email au modèle de niveaux d’accès annoncé lors du déploiement de Graph v8.0 pour les applications Entreprise nouvelles et existantes.

Les applications Entreprise nouvellement créées sont à présent associées à un accès Standard pour les autorisations public_profile et email. Lorsque l’accès d’une application est défini sur Standard pour l’autorisation public_profile, seuls les utilisateurs associés à un rôle dans l’application ou l’entreprise qui a revendiqué l’application peuvent rechercher l’application ou s’y connecter. Si des utilisateurs externes doivent se connecter à votre application, les administrateurs de l’application peuvent demander un accès Avancé dans l’Espace App. Cet accès sera automatiquement octroyé.

Pour en savoir plus, consultez le changelog de la version 10.0.

Rappels de demandes de suppression de données

Tel qu’annoncé le 10 novembre 2020, les applications de type Consommateur et Jeux soumises au Contrôle app ou passant du mode développement au mode en ligne devront fournir un rappel de demande de suppression de données ou une URL mentionnant des instructions explicites pour les utilisateurs sur la façon de demander la suppression de leurs données. Nous prévoyons de mettre en œuvre ce processus d’ici le 10 novembre 2022 et enverrons un rappel aux développeurs d’applications 60 jours avant.

API Graph AdsInsight - Modification d’options pour le projet de réduction des durées de rétention

L’UI du Gestionnaire de publicités ne prendra plus en charge les rapports des données des indicateurs Ads Insights datant de plus de 37 mois. L’API renverra une erreur lorsque la demande contient des plages de dates antérieures à la période de rétention de 37 mois. Le paramètre « date_preset = lifetime » sera désactivé et remplacé par « date_preset = maximum ».

Les modifications de l’API Graph v10.0 sur AdsInsight, à l’exception du paramètre « date_preset = lifetime », seront appliquées à toutes les autres versions de l’API Graph au bout de 90 jours. Le champ spécifique appelé n’a pas besoin d’être modifié. Une fonctionnalité prédéfinie existera et tous les appels « lifetime » utiliseront par défaut une période de rétention de 37 mois maximum.

Cette modification n’aura pas de répercussions sur les données relatives aux contenus publicitaires, aux audiences, aux paramètres de diffusion ou aux noms d’objets publicitaires. Le calcul des indicateurs existants ne sera pas non plus modifié. Cette modification s’appliquera à toutes les surfaces de rapport publicitaire, y compris le Gestionnaire de publicités, les Rapports publicitaires et les expériences publicitaires légères.

• Date de lancement : 23/02/2021 :
  • Version 10.0
    • Activation du paramètre « date_preset = maximum »
    • Désactivation du paramètre « date_preset = lifetime »
    • Renvoi d’une erreur lorsque la demande contient des plages de dates antérieures à la période de rétention de 37 mois
  • Versions 9.0 et antérieures
    • Aucun changement sur la fonctionnalité actuelle
• 90 jours après le lancement - 24/05/2021 :
  • Versions 9.0 et antérieures
    • Activation du paramètre « date_preset = maximum » (identique à la nouvelle version)
    • Renvoi d’une erreur lorsque la demande contient des plages de dates antérieures à la période de rétention de 37 mois (identique à la nouvelle version)
    • Le paramètre « date_preset = lifetime » peut continuer de fonctionner, mais il ne renverra que des données dont la date est antérieure à 37 mois. Il se comportera donc comme un paramètre maximum.

Pour en savoir plus, consultez le changelog de la version 10.0.

Nouvelle politique de suppression pour les données externes dans ThreatExchange

À compter du 24 mai 2021, lorsque des partenaires définiront une date d’expiration (expire_time) pour les données qu’ils importent dans ThreatExchange, nous supprimerons définitivement les données à la date d’expiration mentionnée. Si vous souhaitez indiquer que des données ne sont plus valides, renseignez le champ « expired_on » pour les supprimer de manière automatique.

Auparavant, lorsque nous procédions à une suppression, nous étiquetions le contenu expiré comme étant expiré. Nous ne prenons plus en charge ce type de suppression. Une fois le contenu expiré, il sera définitivement supprimé et ne sera plus visible dans ThreatExchange.

De plus, tous les ThreatDescriptors non-Facebook dans ThreatExchange seront définitivement supprimés lorsqu’ils expireront. La date d’expiration continuera d’être définie par le créateur du ThreatDescriptor. Tous les ThreatDescriptors expirés non créés par Facebook seront ensuite supprimés. Si votre application est actuellement associée à des ThreatDescriptors expirés que vous ne souhaitez pas supprimer lorsque cette politique entrera en vigueur, vous devez reporter la date d’expiration ou la définir sur « 0 » pour que les données n’expirent jamais.

Cliquez ici pour en savoir plus sur les modifications.

Modifications relatives au ciblage dans la nouvelle API

Le 24 mai 2021, la configuration des paramètres location_spec et country ne sera plus nécessaire lors de la création d’une audience personnalisée similaire dans toutes les versions de l’API.

Lors de la création d’une audience similaire, l’utilisateur sélectionne la source similaire et le ratio désiré. La zone géographique concernée par une audience similaire correspondra au pays figurant dans la spécification de ciblage de la campagne. Compte tenu de cette modification, l’impact sur les campagnes existantes sera nul. Cette modification n’aura une incidence que sur les campagnes nouvelles et modifiées.

Lancement de la nouvelle page Statut en direct de la plate-forme

La nouvelle page Statut de Facebook for Business renforcera la transparence et la communication proactive avec les développeurs externes qui utilisent les produits de la plate-forme Facebook. Cette page offrira un guichet unique pour consulter le statut de la plate-forme des produits Facebook for Business (publicités, API WhatsApp Business, plate-forme Facebook pour les développeurs, etc.). La page est actuellement en ligne pour le Gestionnaire de publicités et l’API WhatsApp Business. D’autres produits seront ajoutés d’ici mai 2021.

Fins de prise en charge

Fin de prise en charge de la boîte de dialogue Lancer un direct

Le 24 mai 2021, le SDK de la boîte de dialogue Lancer un direct ne sera plus pris en charge. Cette fin de prise en charge d’un ancien outil de production en ligne concernera toutes les versions de l’API. Cette modification n’aura une incidence que sur la diffusion en direct sur Facebook. Nous encourageons les développeurs à utiliser Live Producer et l’API Live pour toutes leurs solutions de production en ligne personnalisées.

Solutions pour diffuser en direct après la fin de la prise en charge du SDK de la boîte de dialogue Lancer un direct :

• Accéder à Live Producer directement via facebook.com/live/producer (ou d’autres points d’entrée sur Facebook tels que le bouton Vidéo en direct sur une page ou un profil)
• Intégrer l’API Live à toute solution personnalisée

Pour en savoir plus, consultez le changelog de la version 10.0.

Fin de prise en charge du ciblage des connexions

Le 24 mai 2021, le ciblage des connexions ne sera plus pris en charge lors de la création/modification d’un ensemble de publicités. Ce critère n’aura une incidence que sur les campagnes nouvelles et modifiées, et l’impact sur les campagnes existantes sera nul.

Pour en savoir plus, consultez le changelog de la version 10.0.

Annulations de fin de prise en charge

Annulation de la fin de prise en charge du point de terminaison gr:delete:Page/tabs

Lorsque nous avons lancé l’API Graph v8.0, nous avons supprimé le point de terminaison gr:delete:Page/tabs pour les onglets des pages. Nous avons décidé de réintégrer immédiatement ce point de terminaison à l’API Graph v10.0 et de restaurer son accès le 24 mai 2021 dans toutes les autres les versions de Graph.

Pour en savoir plus, consultez le changelog de la version 10.0.

Annulation de la fin de prise en charge des points de terminaison gr:post:Business/business_users, gr:post:Business/system_users et gr:post:User/access_tokens

Lorsque nous avons lancé l’API Graph v9.0, nous avons restreint l’accès à trois points de terminaison pour les entreprises :

• gr:post:Business/entreprise
• gr:post:Business/system_users
• gr:post:User/access_tokens

Dans Graph v10.0, nous rouvrons ces points de terminaison aux appels d’API lorsque les applications présentent l’une des deux conditions suivantes :

• L’entreprise cible est l’entreprise propriétaire de l’application appelante
• L’entreprise cible est une entreprise enfant (dans un modèle d’entreprise à 2 niveaux) de l’entreprise propriétaire de l’application appelante

Pour en savoir plus, consultez le changelog de la version 10.0.

Calendrier des actions à entreprendre

Fin de prise en charge des versions de l’API Marketing :

Dans le cadre de notre calendrier de gestion des versions de l’API Marketing, les prochaines dates de fin de prise en charge sont les suivantes :

• 3 mars 2021 : l’API Marketing v7.0 ne sera plus prise en charge et sera retirée de la plate-forme
• 4 mai 2021 : l’API Marketing v8.0 ne sera plus prise en charge et sera retirée de la plate-forme
• 25 août 2021 : l’API Marketing v9.0 ne sera plus prise en charge et sera retirée de la plate-forme

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 Marketing que nous avons lancée aujourd’hui. (Pour en savoir plus, consultez le changelog.)

Fin de prise en charge des versions de l’API Graph :

Dans le cadre de notre calendrier de gestion des versions de l’API Graph, les prochaines dates de fin de prise en charge sont les suivantes :

• 4 mai 2021 : l’API Graph v3.2 ne sera plus prise en charge et sera retirée de la plate-forme
• 3 août 2021 : l’API Graph v3.3 ne sera plus prise en charge et sera retirée de la plate-forme

Fins de prise en charge générales

• 24 mai 2021 :
  • La boîte de dialogue Lancer un direct ne sera plus prise en charge et sera retirée de la plate-forme
  • Le ciblage des connexions ne sera plus pris en charge et sera retiré de la plate-forme

Action requise par les développeurs

• Inscription glissante : Certification relative au Contrôle de l’utilisation des données
  • Après inscription, à passer dans un délai de 60 jours
  • Questions/réponses consacrées au CUD
• 23 février 2021 : lancement des modifications de l’API Graph AdsInsight uniquement pour Graph v10.0
• 24 mai 2021 :
  • Lancement des modifications de l’API Graph AdsInsight pour Graph v9.0 et versions antérieures
  • Déploiement des modifications des niveaux d’accès en fonction du Contrôle app
    • Accès aux données de l’API Groups limité à 90 jours
    • Mise en place de l’accès aux données par niveau dans l’API Groups
    • Déploiement des modifications des autorisations public_profile et email pour les applications Entreprise
  • Mise en place de la nouvelle politique relative à la suppression définitive des données dans ThreatExchange
• 10 novembre 2022 : date limite pour les demandes de suppression de données