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

Aujourd’hui, nous mettons en ligne la version 16.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. Découvrez notamment des annonces, des mises à jour concernant les produits et des notifications sur les abandons que nous estimons pertinentes pour les intégrations liant vos applications et notre plateforme.

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

Annonces et mises à jour générales

Réponses d’erreur sur la plateforme WhatsApp Business

Dans le cadre de notre démarche d’amélioration des réponses aux erreurs de nos API, nous avons effectué les modifications suivantes.

• Les sous-codes d’erreur, qui sont rarement utilisés et auxquels il ne faut pas se fier, ne seront plus inclus dans les réponses aux erreurs des versions 16.0 et suivantes. Utilisez plutôt le code et les détails.
• Le code d’erreur 100 (« code » : 100) comptait plusieurs titres différents qui indiquaient la nature d’une erreur donnée. Toutes les erreurs 100 auront désormais pour titre « Paramètre non valide ». Les anciens titres qui décrivaient la nature d’une erreur 100 donnée ont été déplacés vers la propriété Détails. Cette modification se reflète également dans les charges utiles des webhooks qui décrivent une réponse à l’erreur 100.
• Les objets d’erreurs de webhook ont une nouvelle propriété de message qui correspond à celle des charges utiles de réponse aux erreurs d’API.

Une vérification de l’entreprise est désormais requise pour obtenir l’accès Avancé à n’importe quelle API sur la plateforme de développement

Comme annoncé le 1er février 2023, dans le cadre de son processus visant à vérifier l’authenticité et la légitimité des entreprises ou des organisations, Meta met en place une vérification d’entreprise destinée aux développeur·ses qui souhaitent obtenir un accès Avancé à n’importe quelle autorisation sur la plateforme de développement Meta.

Nous déploierons ce processus de manière progressive pour les applications créées après le 1er février 2023 qui feront une demande d’accès Avancé. Les applications créées avant le 1er février 2023 avec accès Avancé devront être associées à une entreprise vérifiée à compter du 1er mai 2023. Pour obtenir la liste des autorisations qui nécessitent la vérification de l’entreprise avant octroi de l’accès Avancé, consultez cette page.

Abandons et modifications importantes

Abandon de l’option Idées voyage

En 2018, nous avons lancé Idées voyage, une option que les annonceurs du secteur du tourisme pouvaient activer pour rendre prioritaire la diffusion de leur publicité auprès des personnes qui souhaitaient voyager, mais n’avaient pas encore choisi leur destination. La fonctionnalité Idées voyage pouvait être combinée avec des options de ciblage existantes afin d’aider les annonceurs à diffuser leurs publicités auprès des bonnes personnes et au moment opportun, via Facebook, Instagram et Audience Network. Ces quatre dernières années, grâce au développement continu de nos systèmes de machine learning et à nos tests poussés, les annonceurs peuvent désormais cibler les futur·es voyageur·ses et atteindre des performances similaires sans l’activation de cette option.

À partir du 2 février 2023, l’option Idées voyage ne sera plus proposée pour les nouvelles campagnes dans le Gestionnaire de publicités et dans l’API. Nous pensons qu’elle n’est plus nécessaire et que les annonceurs devraient connaître des performances similaires sans elle. D’ici-là, le fait d’activer ou non cette option ne devrait pas avoir d’impact notable sur les performances d’une campagne.

Avec l’amélioration des modèles de machine learning, des performances et objectifs similaires peuvent être atteints sans la fonctionnalité Idées voyage. Nous pensons donc que le plus simple est de la supprimer.

Abandon des publicités pour les vols à des fins de prospection

En septembre 2018, nous avons lancé les publicités pour les vols à des fins de prospection. Malgré ce lancement réussi, au second semestre 2021, ce produit a rencontré des difficultés techniques, et nous avons identifié des erreurs qui empêchaient la diffusion efficace des campagnes. Nous avons alors décidé d’encourager les annonceurs à se tourner vers d’autres options de prospection. La fonctionnalité de reciblage est toujours disponible pour les annonceurs.

Si vous ou un de vos partenaires utilise actuellement les publicités pour les vols à des fins de prospection, nous recommandons de désactiver toute campagne concernée avant le 1er mai 2023.

Abandon du placement publicitaire Instant Articles

Nous allons retirer de Facebook les Instant Articles et le placement publicitaire associé à partir du 20 avril 2023. Nous les avions lancés en 2015 pour permettre aux éditeur·ices de créer sur mobile des articles avec du contenu multimédia interactif et de les monétiser à l’aide de publicités sur Facebook. Mais la découverte d’actualités ne représente qu’une infime partie de l’expérience de la plupart des utilisateur·ices sur Facebook, et d’après nos échos, ces personnes souhaitent voir moins de ces contenus dans leur fil d’actualité. Ainsi, nous ajustons nos investissements pour nous adapter aux souhaits des membres de la plateforme.

À partir du 20 avril 2023, le Gestionnaire de publicités et l’API Marketing ne proposeront plus le placement publicitaire Instant Articles lors de la création d’une campagne. Après le 20 avril 2023, les ensembles de publicités composés exclusivement de placements Instant Articles seront mis en pause, et tous les autres ensembles comprenant au moins un placement de ce type seront automatiquement modifiés pour exclure ce placement.

Masquage des réactions, commentaires et tags pour les contenus publiés sur des profils d’utilisateur·ices

Dans cette version, nous avons apporté une modification qui aura pour résultat de masquer les commentaires, réactions et tags de l’utilisateur·ice de la session. Les champs « via » et « sharedposts » renverront également des données vides pour les publications sur des profils d’utilisateur·ices. Cette modification ne concernera que les contenus publiés sur ce type de profils.

Abandon de la prise en charge pour les versions de TLS antérieures à 1.2

Par souci de sécurité, nous arrêtons la prise en charge des API Graph pour les versions de TLS antérieures à 1.2. Si vous utilisez TLS 1.2, l’accès à l’aide de chiffrements RSA statiques (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) ne sera plus possible non plus. Les requêtes d’API effectuées avec des versions de TLS plus anciennes renverront une erreur après 90 jours.

À partir du 1er mai 2023, nous rejetterons également le trafic web vers developer.facebook.com depuis les navigateurs qui utilisent d’anciennes versions de TLS (antérieures à TLS 1.2 et utilisant des chiffrements RSA statiques [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] pour TLS 1.2).

Catégories de modèles WhatsApp

L’année dernière, nous avons modifié les types de catégories de modèles dans l’API ou le Gestionnaire WhatsApp afin de nous adapter aux nouvelles utilisations sur la plateforme WhatsApp Business. Le 2 février 2023, nous renommerons ces catégories de modèles pour qu’elles correspondent mieux à ces utilisations :

• Les modèles marketing seront toujours appelés « marketing » (aucun changement).
• Les modèles transactionnels seront renommés « utilitaires ».
• Les modèles avec mot de passe à usage unique seront renommés « authentification ».

Les entreprises doivent utiliser ces nouvelles catégories de modèles quand elles créent ou modifient des modèles à l’aide de la version 16 de Graph. À partir du 1er mai, ce changement s’appliquera à toutes les versions. Ainsi, toute tentative de création ou de modification de modèle, peu importe la version employée, devra utiliser ces nouvelles catégories. Pour éviter toute perturbation dans la création ou la modification de modèles, les entreprises et les fournisseurs de solutions d'entreprise (BSP) doivent faire de la modification de leurs appels d’API une priorité afin d’utiliser les nouvelles catégories et les nouveaux modèles avant le 1er mai 2023.

Voici d’autres dates et considérations importantes :

• Migration des modèles : le 1er avril, WhatsApp migrera tous les modèles existants vers les nouvelles catégories. Les entreprises pourront consulter la nouvelle catégorisation de leurs modèles dans le Gestionnaire WhatsApp et auront jusqu’au 15 mai pour la vérifier. Si une entreprise n’est pas d’accord avec cette catégorisation, elle peut faire appel jusqu’au 15 mai. Tous les modèles créés ou modifiés à l’aide de la version 15 (ou antérieure) de l’API Graph entre le 1er avril et le 1er mai feront l’objet d’une migration le 5 mai. Nous recommandons donc de commencer à utiliser la version 16 pour vos nouveaux modèles dès le 1er avril. À partir du 1er mai, la nouvelle catégorisation s’appliquera à tout modèle créé dans le Gestionnaire WhatsApp ou toute version de l’API Graph.
• Création de modèle dans les nouvelles catégories : à partir du 1er avril, tous les modèles créés dans la version 16 de l’API Graph ou dans le Gestionnaire WhatsApp devront faire l’objet d’une validation de catégorie. Tout modèle créé ou modifié pourra être refusé si WhatsApp détecte une erreur de catégorisation. L’explication donnée sera que la catégorie sélectionnée ne correspond pas au contenu du modèle, selon nos règles relatives aux modèles. Les entreprises pourront alors choisir de modifier la catégorie et de soumettre à nouveau leur modèle, de modifier ce dernier ou de faire appel. Dès le 1er mai, les nouveaux modèles avec variables nécessiteront des échantillons en ligne. À partir du 1er juin, la facturation des entreprises suivra de nouvelles grilles tarifaires pour chaque catégorie de modèle.

Plateforme Messenger API

À partir de la version 16, nous simplifions les notifications récurrentes grâce à la suppression de l’option permettant de préciser la fréquence des messages. Pour en savoir plus, consultez le changelog Messenger.

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

• 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
• 14 septembre 2023 : la version 11.0 de l’API Graph sera abandonnée et supprimée de la plateforme

API Marketing

• 25 avril 2023 : la version 14.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