Intégration de Marketplace FBE

L’extension Facebook Business (FBE) permet à vos vendeur·ses de diffuser facilement des publicités dans la famille d’applications Facebook en connectant des ressources Facebook existantes, comme une Page Facebook ou Business Manager, ou en créant des ressources entièrement nouvelles. FBE permet aux vendeur·ses de Marketplace de s’intégrer de manière transparente aux solutions Meta.

Vous trouverez ci-dessous les principales étapes spécifiques au flux de Marketplace. Nous vous recommandons de combiner ces étapes à celles des principaux documents de développement.

Flux de Marketplace FBE

Partenaire = Marketplace

FBE = extension Facebook Business (Interface d’utilisation détenue par Facebook)

Avant de commencer

Votre application doit appartenir à un Business Manager qui est une entreprise vérifiée. Découvrez comment obtenir la vérification de votre entreprise.
Une application Facebook dont les autorisations suivantes ont été approuvées par le Contrôle app est requise :

Autorisation privée
1. manage_business_extension : il s’agit d’une autorisation privée qui requiert l’ajout de votre application à la liste d’éléments autorisés par votre représentant·e Meta. Contactez votre représentant·e Meta pour obtenir de l’aide.
Autorisations publiques (devant être demandées par Marketplace via le Contrôle app).
1. business_management : requise pour récupérer l’ID de Business Manager créé via FBE et pour l’utilisation de l’API Business Manager afin de gérer les ressources professionnelles.
2. ads_management : requise pour gérer les publicités du vendeur ou de la vendeuse pour le compte du client ou de la cliente.

Étapes clés pour la FBE et API des Publicités collaboratives

Le vendeur (marque) lance l'écran contextuel de configuration de la FBE via le site web de Marketplace.
Le vendeur ou la vendeuse suit le processus d’intégration de la FBE et effectue la configuration des principales ressources (Business Manager, Page, etc.).
La FBE indique que le vendeur ou la vendeuse a réussi à configurer les ID de ressource (via une API ou un Webhook). Une fois que Marketplace reçoit les ID, le segment de catalogue peut être créé/partagé via l’API ou l’interface d’utilisation (à l’aide de l’outil Espace de collaboration dans Business Manager).
Le vendeur ou la vendeuse lance la vue Gestion FBE, qui lui permet de voir le statut du segment de catalogue créé et d’accepter les conditions de service, si c’est la première fois qu’il ou elle reçoit une demande de segment de catalogue de Marketplace.
Marketplace redirige le vendeur ou la vendeuse vers le processus de création des publicités (flux de production existant - Gestionnaire de publicités, etc.).

Configurations requises

Extras

Champ Type Description

Champ	Type	Description
`setup`	configuration	Obligatoire Paramètres de configuration Facebook du vendeur, tels que son identifiant unique (`external_business_id`) ou la devise de son catalogue (`currency`). Voir Détails sur l’objet de configuration.
`business_config`	business_config	Obligatoire Objet de configuration utilisé par Facebook Business Extension pour configurer le flux de travail de Facebook Business Extension. Voir Détails sur l’objet `business_config`.
`repeat`	booléen	Obligatoire Définir cette valeur sur `false`.

setup

configuration

Obligatoire

Paramètres de configuration Facebook du vendeur, tels que son identifiant unique (external_business_id) ou la devise de son catalogue (currency). Voir Détails sur l’objet de configuration.

business_config

business_config

Obligatoire

Objet de configuration utilisé par Facebook Business Extension pour configurer le flux de travail de Facebook Business Extension. Voir Détails sur l’objet business_config.

repeat

booléen

Obligatoire

Définir cette valeur sur false.

Configuration

Champ	Description
`external_business_id` Type : chaîne	Obligatoire. ID d’entreprise unique pour représenter votre entreprise cliente. Nous l’utilisons en tant qu’identifiant unique. Par exemple, si l’entreprise du vendeur s’appelle « Fubar », « fubar-123 » pourrait être son `external_business_id`.
`timezone` Type : chaîne	Obligatoire. Fuseau horaire dans lequel l’entreprise se trouve. Voir les valeurs de fuseau horaire possibles.
`currency` Type : chaîne	Obligatoire. Code ISO à trois lettres de la devise par défaut utilisée par les articles du catalogue de l’entreprise. Consultez Codes de devise pris en charge.
`business_vertical` Type : énumération	Obligatoire. Le segment vertical associé à l’entreprise pour Marketplace est `ECOMMERCE`.
`merchant_settings_id` Type : chaîne	Facultatif. Utilisation lors de la mise à jour de l’extension Facebook Business, v1. Veuillez contacter votre représentant·e Facebook si vous effectuez une migration de v1 à v2.
`channel` Type : énumération	Obligatoire. Permet à l’entreprise partenaire d’exprimer ses intentions à l’égard de l’utilisateur·ice concernant les fonctionnalités qui nécessitent des étapes ou des contraintes supplémentaires : Remarque : le `channel` du flux FBE spécifique à Marketplace est `MARKETPLACE`. Veillez à le placer dans le champ `channel`.
`business_manager_id` Type : chaîne	Facultatif. ID Business Manager existant qu’une entreprise partenaire peut fournir comme présélection pour l’utilisateur·ice dans le processus de configuration.
`page_id` Type : chaîne	Facultatif. ID de Page Facebook existante qu’une entreprise partenaire peut fournir comme présélection pour l’utilisateur·ice dans le processus de configuration.

Configuration professionnelle

Utilisez cet objet pour configurer les paramètres professionnels d’un·e utilisateur·ice final·e, dont Messenger. Chaque champ comprend un « type » lié aux tableaux respectifs ci-dessous.

Champ	Description
`business` FBEBusinessPropertiesConfigData	Obligatoire. Information pour l’entreprise de l’utilisateur·ice final·e
`messenger_chat` FBEMessengerChatConfigData	Facultatif. Fonctionnalités de discussion Messenger sur la Page Facebook de l’utilisateur·ice final·e, telles que `enabled` et `domains`.
`catalog_feed_scheduled` FBECatalogFeedConfigData	Facultatif. Détermine si l’extension Facebook Business doit utiliser une approche de flux, qui récupère les articles de catalogue à partir d’une `feed_url`.
`page_cta` FBEPageCtaConfigData	Facultatif. Bouton call-to-action (CTA) sur la page de l’utilisateur·ice final·e, tel que `cta_button_text`, `cta_button_url`, etc.
`ig_cta` FBEIGCtaConfigData	Facultatif. Caractéristiques de la fonctionnalité call-to-action d’Instagram, telles que `enabled`, `cta_button_text`, `cta_button_url`, etc.
`messenger_menu` FBEMessengerMenuConfigData	Facultatif. Caractéristiques de la fonctionnalité du menu fixe Messenger, telles que `cta_button-text` et `cta_button_url`.

Après l’installation

Obtenez les ID de ressource, vérifiez les notifications Webhook et les événements de pixel..
Une fois que les ID de ressource ont été reçus, créez/partagez le segment de catalogue via l’API ou l’interface d’utilisation (à l’aide de l’outil du centre de collaboration au sein de Business Manager).
Une fois que l’appel d’API de création de segments de catalogue est réussi, vérifiez ici pour obtenir des informations sur le lancement de la fenêtre contextuelle de la vue Gestion FBE pour que le vendeur ou la vendeuse accepte les segments de catalogue partagés et termine l’intégration.

Lancez la vue Gestion FBE une fois la configuration FBE terminée et les identifiants des actifs renvoyés par les Webhooks/API.