Présentation

Nous vous encourageons à lire attentivement ce guide et à intégrer autant d’éléments de nos API Commerce que possible, et dans l’idéal, tous ceux qui sont pertinents pour votre cas d’utilisation.

Étendue du rôle de développeur ou développeuse

Les développeur·ses appartiennent généralement à l’une des catégories suivantes :

• Vendeur ou vendeuse : membre d’une entreprise d’e-commerce qui gère sa propre pile de technologies personnalisée et souhaite intégrer les API Commerce de Meta pour qu’une ou plusieurs boutiques fonctionnent avec les technologies de Meta.

• Fournisseur de technologies ou partenaire : membre d’une entreprise d’e-commerce ou de services logiciels destinés aux entreprises d’e-commerce existantes qui ne possède pas de boutique propre et souhaite intégrer les API Commerce de Meta pour le compte de plusieurs boutiques utilisant sa plateforme d’e-commerce.

Quelle que soit la catégorie à laquelle vous appartenez, la qualité de votre intégration aura une grande influence sur l’expérience des client·es avec vos produits et vos boutiques gérées avec nos API Commerce. Ce guide est dédié aux partenaires de développement qui souhaitent :

• intégrer nos API Commerce ;

• obtenir une vision d’ensemble de tous les éléments nécessaires pour une intégration de grande qualité dans les API Commerce de Meta ;

• découvrir comment l’intégration peut améliorer les résultats commerciaux : attirer une nouvelle clientèle, doper les ventes et tirer le meilleur profit des publicités Meta pour obtenir les mêmes résultats.

Étendue du rôle d’acheteur ou acheteuse

Les critères des acheteurs et acheteuses sont très stricts. Ils et elles veulent accéder à un maximum d’informations sur les produits qui les intéressent. Ils et elles recherchent les bonnes affaires, et s’attendent à trouver les mêmes remises et promotions sur une Boutique que sur le site web du vendeur ou de la vendeuse. Ils et elles ont besoin de connaître à tout moment l’état de leur commande et d’obtenir des informations correctes sur l’expédition, le suivi et le retour de leurs achats.

Il est essentiel de fournir tous ces éléments à Meta pour améliorer les taux de conversion des acheteur·ses grâce aux Boutiques.

Vision d’ensemble du flux de développement

Meta autorise les développeurs et développeuses tiers à créer des systèmes qui s’intègrent dans nos plateformes Instagram et Facebook grâce à une collection de points de terminaison de l’API Commerce, qui appartiennent à l’API Graph. Nous décrivons ici dans les grandes lignes le flux de développement et les composants nécessaires pour procéder à une intégration de grande qualité dans l’API Commerce.

Conditions requises

• Vous devez avoir une entreprise configurée et vérifiée dans Meta

• Les contrats commerciaux requis doivent être signés, notamment l’amendement relatif aux fournisseurs de technologies et les Conditions supplémentaires

• Vous devez connaître les concepts de l’API Graph, qui est l’outil principal permettant de lire et d’écrire des données dans la plateforme commerciale de Meta

Étape 1 : créez une application de développement

Avant de pouvoir exécuter des requêtes vers les points de terminaison de l’API Graph, vous devez créer une application dans le portail Meta for Developers. Dans ce contexte, une application est un ensemble de fonctionnalités auquel votre logiciel tiers est autorisé à accéder sur les systèmes de Meta. Chaque appel d’API à destination des systèmes de Meta est associé à cette application et vos fonctionnalités déterminent les types d’appels d’API auxquels votre logiciel a accès. Cette application est associée à votre entité commerciale sur Meta. Le modèle de données de Meta a été conçu de sorte que les éléments que vous créez pour gérer votre activité sur Meta appartiennent à cet objet commercial. Ce même objet qui détient votre application peut également détenir votre Page Facebook, votre compte Instagram, votre compte publicitaire et votre catalogue produits.

Étape 2 : créez un token d'accès (en utilisant un compte test)

Afin de voir votre application approuvée, vous devez fournir un token d’accès qui sera inclus dans chaque appel d’API. Ce token d’accès permet à votre application d’accéder aux plateformes de Meta pour le compte d’un utilisateur ou d’une utilisatrice. Les tokens d’accès sont comme des clés numériques qui maintiennent la connexion des utilisateur·ices à Facebook. Ainsi, ils et elles n’ont pas besoin de saisir leur mot de passe à chaque fois que votre logiciel tiers a besoin d’accéder aux plateformes de Meta pour leur compte.

Si vous souhaitez intégrer plusieurs boutiques à l’API Commerce, vous devez enregistrer plusieurs tokens d’accès, un pour chaque boutique en activité sur les canaux de Facebook et d’Instagram que vous gérez.

Pour commencer, créez un compte commercial de test, associez-y des éléments et générez un token d’accès pour chacun d’entre eux afin de pouvoir réaliser l’intégration.

Étape 3 : créez les intégrations de l’API Commerce (avec un compte test)

Parallèlement, commencez à intégrer les API du catalogue, de gestion des commandes et des promotions (offres) avec le compte commercial de test créé à l’étape 2. L’intégration avec les API Catalog permet de configurer et d’opérer un catalogue complet et de qualité, qui améliore l’expérience et les décisions d’achat. L’intégration avec les API Order Management permet de gérer le cycle de vie des commandes passées par les acheteurs et acheteuses sur les canaux de Facebook et d’Instagram. L’intégration avec les API Promotions permet de synchroniser différents types de promotions, et de gérer les achats et les remboursements quand des promotions sont appliquées.

Découvrez comment intégrer ces API pour respecter les critères de qualité de nos Boutiques.

Étape 4 : soumettez l’application au Contrôle app

L’examen de votre application (Contrôle app) est une étape essentielle du processus de développement des applications. Pour initier cet examen, vous devez demander des autorisations spécifiques et décrire comment vous comptez utiliser ces autorisations dans votre application pour servir les entreprises que vous gérez. Le Contrôle app est un processus qui nous permet de vérifier que votre application utilise nos produits et nos API d’une manière approuvée. En savoir plus sur le processus d’examen Contrôle app.

Étape 5 : créez un flux pour enrôler les vendeurs et vendeuses dans Meta Commerce

Appliquez la meilleure méthode pour enrôler vos vendeurs et vendeuses dans Meta Commerce. À l’issue de ce flux, le système génère un token d’accès pour chaque vendeur ou vendeuse que vous gérez. Vous devez stocker et utiliser ce token dans les appels d’API que vous réalisez pour le compte de ces vendeurs ou vendeuses.

Découvrez les instructions détaillées pour créer un flux d’enrôlement idéal et conforme aux critères de qualité de nos Boutiques.

Étape 6 : améliorez votre intégration de l’API Commerce (avec un compte de production)

Améliorez votre intégration de sorte qu’elle puisse s’adapter à différents scénarios d’arêtes et gérer convenablement les erreurs. Prenez connaissance des recommandations d’intégration détaillées dans ce guide et veillez à les appliquer. Enfin, testez votre intégration avec de véritables commandes.

Critères de qualité d’intégration

Le tableau ci-dessous répertorie les tâches de vente à accomplir. Classées par catégories, les tâches sont associées à un niveau de priorité (0 étant le niveau le plus élevé), à un champ d’application (spécifique à Meta ou applicable à d’autres canaux), à des critères de qualité d’intégration de Meta Commerce et à d’éventuelles améliorations.