La fonctionnalité Sandbox de l’API Marketing a été réactivée

Nous avons le plaisir de vous informer que les comptes publicitaires sandbox de l’API Marketing sont à nouveau disponibles. Ces comptes permettent de tester la compatibilité des API avec l’API Marketing.

Qu’est-ce qu’un compte publicitaire sandbox de l’API Marketing ?

Il s’agit d’un compte publicitaire de test associé à une application. Vous devez accéder à developer.facebook.com pour le configurer et l’autoriser à accéder à un sous-ensemble d’API Marketing. Grâce au compte sandbox, les développeurs et développeuses peuvent tester les appels de l’API Marketing pour leurs pages et contenus sans diffuser les publicités mêmes. Il est inutile de configurer de source d’approvisionnement pour les comptes publicitaires, car Meta ne diffuse pas les publicités créées, et les impressions ou dépenses ne sont pas comptabilisées.

Comment créer un compte publicitaire sandbox de l’API Marketing ?

Pour créer un compte publicitaire sandbox, les utilisateurs et utilisatrices doivent avant tout activer le produit API Marketing dans leur Espace App, puis créer et associer un compte publicitaire sandbox à ce produit. Il est ensuite possible de configurer ce compte publicitaire sandbox en y associant des comptes Business Manager, en acceptant des conditions d’utilisation, etc. Quand la configuration est terminée, il est possible de générer le token d’accès utilisateur ou d’utiliser le token d’utilisateur système pour interroger l’API Graph et réaliser des tests.

Expérience d’utilisation finale

1. Pour ajouter le produit API Marketing, les développeurs et développeuses doivent se rendre dans leur Espace App à l’adresse https://developers.facebook.com/ et suivre les instructions ci-dessous.
   • Cliquez sur le menu déroulant Mes applications
   • Sélectionnez une application pour laquelle vous avez le rôle d’administrateur·ice ou de développeur·se.
2. Ajoutez le produit API Marketing, si vous n’y aviez pas encore accès.
   • Dans Espace App, accédez à la section Ajouter un produit et configurez l’API Marketing.
   
3. Cliquez sur API Marketing > Outils pour ouvrir la carte de gestion du compte publicitaire sandbox.
4. S’il s’agit du premier compte sandbox que vous créez, l’option de création d’un compte s’affiche. Remarque : un seul compte sandbox peut être associé à chaque application.
5. Vous pouvez ensuite associer ce compte sandbox à n’importe quelle page pour laquelle vous disposez des droits d’administrateur·ice.
6. Pour les cas d’utilisation basiques, vous pouvez désormais générer les tokens d’accès utilisateur qui disposent d’un compte publicitaire et d’un accès à la Page, et les utiliser pour commencer à tester les appels de l’API Marketing.
7. Si vous envisagez d’utiliser des fonctionnalités telles qu’Instant Experience et le Gestionnaire de catalogues, nous vous recommandons d’utiliser un token d’utilisateur système plutôt qu’un token d’accès utilisateur. Pour obtenir le token d’accès utilisateur système, cliquez sur le bouton Connexion à l’entreprise et utilisez un compte Business Manager pour récupérer le token d’accès.

Limites

• Les comptes publicitaires sandbox ne peuvent pas être gérés directement à partir du Gestionnaire de publicités. Seuls les appels de l’API Ads peuvent être utilisés pour les gérer.
• L’API Insights n’est actuellement pas prise en charge, car les modifications apportées à l’environnement sandbox ne sont pas publiées ni diffusées. Aucun clic, ni aucune dépense ou impression ne sont générés, et aucune statistique n’est évaluée.
• Si votre application est actuellement autorisée à accéder à certaines API expérimentales, vous pourrez effectuer des appels vers ces API en mode Sandbox
• Vous pouvez créer un seul compte publicitaire sandbox par application, peu importe le niveau d’accès de votre application

Ressources :

• Documentation pour les équipes de développement

• Documentation générale sur l’API Marketing expliquant les tests

• Publication de blog datant du lancement initial (2017)