Intégration préalable dans Boutiques

Les vendeurs et vendeuses doivent d’abord s’intégrer dans Boutiques pour intégrer Meta Commerce. Une intégration dans Boutiques réussie garantit un catalogue produit actualisé, des informations de commande synchronisées, un rapprochement simple réalisable une fois par trimestre ou par an, et des informations de règlement correctement configurées pour des paiements et des rapports rapides.

Conditions requises

Vous devez réaliser l’intégration avec l'extension Facebook Business pour respecter les critères de qualité d'intégration des Boutiques. Les vendeurs et vendeuses pourront ainsi effectuer les opérations suivantes :

• Découvrir facilement l’intégration Meta dans la plateforme
• Connecter leur compte tiers aux éléments Meta (Business Manager, catalogue ou Pixel existant, le cas échéant, Pages, alias Instagram)
• Configurer et modifier les paramètres sur site des Boutiques (Paramètres de retour, Informations légales, Informations de compte bancaire, Informations fiscales)
• Associer d’autres éléments (Pages, alias Instagram) à la boutique
• Modifier leurs paramètres
• Rétrograder

Avant de commencer

1. Intégrez votre entreprise vérifiée dans l’extension Facebook Business.
2. Ajoutez FBE à votre application et obtenez l’accès au Developer Panel de l’extension. Consultez ce diagramme pour comprendre le flux de l’extension Facebook Business pour Commerce.
3. Suivez les étapes de configuration de l’extension Facebook Business et envoyez votre intégration pour examen. Vous devez notamment activer l’expérience de gestion des fonctionnalités de l’extension Facebook Business dans votre plateforme afin que les entreprises puissent modifier leurs fonctionnalités, voire désinstaller leur configuration de l’extension Facebook Business.

Exigence 1 : réaliser l’intégration avec FBE

L’extension Facebook Business est une interface appartenant à Meta et générant des fenêtres contextuelles. Elle s’intègre aux sites tiers sous forme de plugin et simplifie le processus global d’intégration dans Meta. FBE facilite la configuration du Pixel Meta, du catalogue et des Boutiques. Elle aide les entreprises à connecter leurs produits et services aux canaux Facebook et Instagram sur votre plateforme. Une fois la connexion établie, vous pouvez les aider à utiliser un grand nombre de fonctionnalités performantes.

Voici un résumé des différentes responsabilités dans une intégration réalisée avec FBE :

• Responsabilité de Meta : interface, authentification, connexion, ainsi qu’une surface [(vue de gestion de FBE)](vue de gestion de FBE) permettant d’afficher les éléments connectés et de gérer les fonctionnalités installées et le statut des intégrations dans Commerce
• Responsabilité du ou de la partenaire : configuration de Pixel, importation de l’inventaire dans le catalogue Facebook via l’API

Une fois configurées, vos entreprises peuvent démarrer le flux d’intégration dans l’extension Facebook Business avec les éléments existants, en créant de nouveaux éléments ou en optant pour une combinaison d’éléments nouveaux et existants.

Étape 1 : ajoutez des points d'entrée vers votre application dans FBE

Créez des points d’entrée vers l’extension Facebook Business permettant aux utilisateurs et utilisatrices de sélectionner, de gérer ou de créer des éléments (entreprise, catalogue, boutique, pixel, etc.). Voici les différents types de points d’entrée disponibles :

• Connexion d’entreprise (plus connue sous le nom de Facebook Login) : permet aux entreprises de se connecter à partir de votre plateforme à l’aide d’un bouton placé sur votre site.
• Applications Business : permet aux entreprises de se connecter à partir d’une plateforme Meta. Pour activer ce type de point d’entrée et intégrer votre application dans la liste des applications Business de Meta, vous devez fournir une interface d’authentification personnalisée sur votre site. Grâce à cette interface, les utilisateurs et utilisatrices pourront sélectionner leur entreprise et être redirigés vers le flux Meta avec les informations sélectionnées.

Exemple

https://facebook.com/dialog/oauth?
client_id=<FB_APP_ID>
&display=page
&redirect_uri="https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension
//   additionally use catalog_management or ads_management
//   &scope=manage_business_extension,catalog_management,ads_management
&extras={
  "setup": {
    "external_business_id": "foo-123",
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "domain": "https://example-shop.partner-site.com/",
    "channel": "ECOMMERCE",
    "business_vertical": "ECOMMERCE"
  },
  "business_config": {
    "business": {
      "name": "Foo Business"
    },
    "catalog_feed_scheduled": {
      "enabled": true,
      "feed_url": "https://partner-site.com/feed-url"
    },
    "page_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business",
      "below_button_text": "Powered by FBE Partner"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "messenger_menu": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    }
  },
  "repeat": false
}

Selon le type de configuration choisi, vous pouvez obtenir le token d’accès d’une entreprise (nécessaire pour les prochaines étapes) de plusieurs façons :

• Connexion d’entreprise : comme pour toute connexion Facebook Login classique, un token d’accès "access_token" est renvoyé à la fin du processus. Celui-ci vous permettra d’obtenir plus d’éléments (comme les ID du Pixel, de la Page et d’Instagram Business)
• Applications Business : via les webhooks.

Étape 2 : configurez les webhooks FBE_install

Les webhooks sont obligatoires pour l’ensemble des partenaires qui souhaitent intégrer l’App Store. Si vous ne comptez pas ajouter votre application à l’App Store, vous pouvez ignorer cette section ou la consulter ultérieurement. Meta déclenche des évènements webhooks à chaque fois que l’une de vos entreprises installe, modifie ou désinstalle l’extension Facebook Business. Chaque fois qu'un évènement webhook est reçu, votre application devrait consommer cet évènement et comprendre quels éléments de sa connexion avec votre application l'entreprise a modifiés, ajoutés ou supprimés. Le comportement de votre application devrait se mettre à jour en fonction des derniers éléments connectés. Nous vous recommandons vivement de mettre en place et de tester votre abonnement à notre webhook.

Pour configurer un webhook :

1. Créez un point de terminaison sur un serveur sécurisé capable de traiter correctement les requêtes provenant de Meta.
2. Dans Espace App, configurez la description de vos webhooks de l’extension Facebook Business (FBE) :
1. Dans la section FBE > onglet Webhooks, saisissez l’URL de rappel de votre application.
2. Saisissez un token de vérification et validez votre point de terminaison.

Une fois la configuration terminée, vous êtes automatiquement abonné·e au webhook fbe_install.

Pour en savoir plus, consultez la section Webhook.

Notifications

Lorsque vous recevez une notification d’installation via un webhook, vous devez réaliser les actions suivantes :

1. Stockez le token d’accès (ainsi que son type) et enregistrez les éléments auxquels votre application a désormais accès.
2. Activez un ensemble de fonctionnalités en fonction des éléments auxquels vous avez accès.
3. S’il vous manque un élément pour une fonctionnalité spécifique, désactivez uniquement cette fonctionnalité. Par exemple, si une application peut accéder à un catalogue, mais pas à un pixel, implémentez uniquement la fonctionnalité ayant besoin d’accéder au catalogue, pas celle ayant besoin du pixel.
4. Informez l’utilisateur ou l’utilisatrice du comportement de votre application en fonction des éléments auxquels elle a accès.

Lorsque vous êtes informé·e qu’une installation existante a été modifiée, vous devez réaliser les actions suivantes :

1. Modifiez le token d’accès et enregistrez les éléments auxquels vous pouvez désormais accéder.
2. Actualisez l’ensemble de fonctionnalités pour lequel votre application sera activée en fonction des éléments auxquels la plateforme a désormais l’accès.
3. Informez l’utilisateur ou l’utilisatrice du comportement de votre application en fonction des éléments auxquels elle a accès.

Lorsque vous recevez une notification de désinstallation, réalisez les actions suivantes :

1. Désactivez les fonctionnalités disponibles grâce à votre application.
2. Informez le vendeur ou la vendeuse des changements apportés à sa configuration.

Étape 3 : récupérez les détails de l’élément avec le token retourné

Pour obtenir des informations sur les entreprises connectées à votre plateforme par l’intermédiaire de l’extension Facebook Business, vous pouvez utiliser l’une des deux méthodes ci-dessous (ou les deux) :

• Webhook : obligatoire pour l’ensemble des partenaires qui souhaitent intégrer l’App Store. Quand vous choisissez cette méthode, les informations des entreprises utilisant FBE pour l’intégration ou l’édition seront envoyées via la charge utile du webhook configuré à l’étape 2.
• Point de terminaison de l’API "FBE Installs" : recommandé pour les entreprises auto-hébergées. Vous pouvez récupérer les informations de base sur l’installation d’une entreprise qui a installé FBE à l’aide du point de terminaison fbe_installs. Effectuez un appel vers le point de terminaison "FBE Installs" avec le token d’accès et l’ID d’entreprise externe d’une entreprise pour obtenir des informations détaillées sur la configuration de cette entreprise.

Exemple : appel d’API "FBE Installs"

curl -i -X GET \   "https://graph.facebook.com/<version>/fbe_business/fbe_installs?fbe_external_business_id=<external business id>&access_token=<access token sanitized>"

Étape 4 : récupérez le token d’utilisateur système

Une fois qu’un utilisateur a installé FBE, l’extension génère un utilisateur système employé sur le compte Business Manager du client ou de la cliente. Notez que cet utilisateur système n’apparaît plus dans le compte Business Manager, mais existe toujours en backend. Le nom de nouvel utilisateur système suit le schéma {Nom application} System User (FBE).

Pour ce faire, exécutez l’appel d’API suivant :

curl -X POST \
  -F 'app_id={app_id}' \
  -F 'scope=ads_management,catalog_management,manage_business_extension' \ 
  -F 'access_token={user_access_token}' \
  -F 'fbe_external_business_id={fbe_external_business_id}' \ 
https://graph.facebook.com/<API_VERSION>/<client_business_manager_id>/access_token

Pour le champ scope, utilisez l’autorisation manage_business_extension. En fonction de votre situation (référez-vous à l’étape 5), les autorisations ads_management, catalog_management, pages_read_engagement, business_management, instagram_basic et manage_business_extension seront probablement nécessaires.

• Si votre application a besoin d’accéder au compte publicitaire d’une entreprise et de le gérer, demandez l’autorisation ads_management. Celle-ci permet de créer des campagnes publicitaires, de récupérer des indicateurs publicitaires, de créer des outils de gestion des publicités, et bien plus encore.
• Si votre application a besoin de créer, de consulter, de modifier ou de supprimer des catalogues produits d’une entreprise qui en est l’administratrice, vous devez demander l’autorisation catalog_management. Nous recommandons cette autorisation pour toutes les applications. Elle permet à votre application de créer des publicités commerciales dynamiques et des solutions de gestion de l’inventaire.

Étape 5 : configurez la vue de gestion

Pour permettre aux entreprises de personnaliser davantage les fonctionnalités (par rapport aux modalités spécifiées lors de l’installation), vous pouvez les inviter à utiliser la Vue Gestion des fonctionnalités FBE à partir de votre plateforme. Vous pouvez utiliser le SDK JavaScript ou une URL pour ajouter un point de terminaison et lancer la Vue Gestion des fonctionnalités FBE. Les deux méthodes nécessitent l’affichage d’un bouton qui devra être actionné pour ouvrir la fenêtre de la Vue Gestion des fonctionnalités FBE.

Étape 6 : ajoutez un point d'entrée pour désinstaller FBE

Votre plateforme doit proposer un point d’entrée (sous forme de bouton, par exemple) pour permettre aux entreprises de désinstaller FBE. Pour ce faire, nous vous recommandons d’envoyer une requête DELETE au point de terminaison approprié.

Exemple : appel vers notre point de terminaison de suppression

curl -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<FBE_EXTERNAL_BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

Si vous avez mis en œuvre un webhook fbe_install, vous recevrez des évènements lorsque l’utilisateur ou l’utilisatrice désinstallera FBE.

En savoir plus

• Extension Facebook Business
• Étapes de configuration de l’extension Facebook Business
• Developer Panel de l’extension Facebook Business
• Désinstallation de l’extension Facebook Business
• Webhooks