Questions/réponses sur l’extension Meta Business

Réponses aux questions fréquemment posées sur l’intégration de l’extension Mata Business (MBE).

Installation

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

Assurez-vous que la case à cocher « Activer le catalogue » est activée sous le panneau FBE Developer Panel > onglet Configuration dans le tableau de bord de l’application.

Les entreprises/vendeurs peuvent configurer les fonctionnalités professionnelles dans la Vue de gestion, mais ne pourront pas mettre à jour les éléments Facebook connectés à FBE tels que le Business Manager, le compte publicitaire, la Page, le pixel, le catalogue, etc. Les entreprises/vendeurs peuvent également modifier les paramètres dans le processus de configuration de FBE pour se connecter à différents éléments.

Selon les besoins de votre entreprise, vous pouvez choisir de configurer un ou plusieurs des processus suivants en configurant la valeur appropriée sous Configuration > Canal :

  • Processus par défaut (aucun paramètre requis pour le canal) : permet aux vendeurs de configurer le pixel Facebook, la Page Facebook, le compte publicitaire et le catalogue pour les publicités dynamiques.
  • COMMERCE : processus qui permet aux vendeurs de créer un compte marchand avec la boutique Facebook et le canal Instagram Shopping avec paiement sur site. Propose également une option permettant de choisir des boutiques hors site dans le processus.
  • COMMERCE_OFFSITE : processus permettant aux vendeurs de créer un compte marchand avec une boutique Facebook hors site et Instagram Shopping hors site.
  • FEED : processus permettant aux distributeurs de synchroniser les mises à jour de leur catalogue. Recommandé uniquement pour les partenaires disposant de fonctionnalités de flux/catalogue et n’ayant pas d’hébergement de site web.
  • MARKETPLACE : processus spécifique aux Marketplaces s’intégrant avec FBE. Recommandé pour les partenaires qui n’ont besoin que des étapes Page et Business Manager dans le processus de configuration FBE, et qui utilisent ensuite la Vue de gestion FBE pour configurer les publicités collaboratives.
  • SIGNALS : processus permettant aux utilisateurs de déclencher le pixel Facebook et les évènements de l’API Conversions. Ce processus ne prend pas en charge le catalogue Facebook en tant qu’élément. Recommandé uniquement pour les partenaires disposant de fonctionnalités d’hébergement de site web, et n’ayant pas de fonctionnalités de catalogue.

Vous trouverez ci-dessous quelques scénarios courants que vous pouvez rencontrer lors de la sélection des Pages pendant le processus FBE Business Login. Notez que les infobulles dans le processus FBE expliquent la raison exacte pour laquelle vous ne pouvez pas sélectionner un élément. Cette raison peut différer d’un scénario à l’autre.

Une Page sera disponible à la sélection :

  • Si la Page sélectionnée n’appartient à aucun BM, elle sera revendiquée par le BM sélectionné
  • Si la Page sélectionnée appartient à un autre BM et n’est pas une Page principale de ce BM, elle sera transférée au BM sélectionné

Une Page ne sera pas disponible à la sélection :

  • Si la Page appartient à un autre BM et qu’elle est également une Page principale de ce dernier
  • Si la Page appartient à un BM qui a été désactivé, par exemple, pour avoir enfreint des politiques

Les partenaires peuvent demander la fonctionnalité Page Public Metadata Access pour leur application, afin que celle-ci puisse interroger les champs publics de la Page. Pour en savoir plus sur cette fonctionnalité, consultez le présent document et également ici.

Si le champ instagram_profiles n’est pas inclus, cela signifie que l’autorisation Instagram (par exemple, instagram_basic) n’est pas incluse dans le token d’accès et/ou que l’entreprise n’a pas connecté de profil professionnel Instagram à FBE. Pour en savoir plus sur l’API d’installation de FBE, consultez le présent document.

Cela signifie qu’il manque une autorisation dans l’application. Notez que la principale autorisation nécessaire pour les actions liées au Business Manager est business_management.

Nous prenons en charge la plupart des devises de cette liste à l’exception de JMD, BGN, BYN, UAH, KIP, LKR.

Avertissement : l’installation de FBE échouera si des devises non prises en charge sont fournies dans les paramètres de configuration de l’URL de connexion. Nous recommandons aux partenaires de vérifier que leurs vendeurs utilisent des devises prises en charge avant de les autoriser à lancer FBE.

Assurez-vous de disposer d’un accès admin dans le Business Manager Facebook associé à la connexion FBE actuelle, en plus de l’accès admin à votre Page Facebook Business ou à votre profil professionnel Instagram. Suivez ces instructions pour ajouter un admin à votre Business Manager Facebook.

Tests

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

  1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

  2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

Dépannage

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

Général

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

This is a closed beta. Please reach out to your Meta partner manager for more information.

Catalogue

L’extension Facebook Business (FBE) v2 utilise le catalogue pour dresser l’inventaire d’une entreprise. Elle optimise différentes fonctionnalités, telles que les publicités dynamiques, les boutiques et la carte de services de page. L’intégration de ce composant est facultative, mais il est indispensable pour ces fonctionnalités.

Consultez la documentation de l’API Catalog FBE pour an savoir plus sur l’implémentation et sur les champs pris en charge.

Votre application devra obtenir l’autorisation Catalogue (catalog_management) via le Contrôle app avant d’être mise en ligne.

Ajoutez l’autorisation catalog_management au paramètre de champ d’application dans votre implémentation de Business Login. Votre application sera ainsi autorisée à créer, lire, mettre à jour et supprimer les catalogues appartenant aux entreprises.

Soumettez une demande de Contrôle app dès que vous disposez d’une version de démonstration fonctionnelle vous permettant de montrer par capture vidéo :

  • comment l’autorisation de catalogue est demandée dans le processus d’intégration ;
  • comment l’inventaire des services est transmis au catalogue connecté ;
  • comment les fonctions alimentées par le catalogue sont activées après la synchronisation du catalogue.

Notre équipe de Contrôle app utilise les instructions et la séquence vidéo que vous nous fournissez pour tester et vérifier l’intégration de votre application dans Facebook pour le catalogue. Si vous avez reçu un refus, assurez-vous de lire les commentaires fournis pour en comprendre la raison. Vous devez soumettre à nouveau votre demande d’examen avec des informations mises à jour qui fournissent plus de détails pour l’examinateur.

Veuillez consulter notre Guide relatif aux rejets de Contrôle app pour obtenir des conseils sur la manière de réussir le Contrôle app et sur la manière d’informer votre responsable des partenaires Facebook de vos rejets et obtenir une assistance supplémentaire

La sélection des éléments dépend de plusieurs facteurs et les motifs de non-éligibilité sont multiples. Cela peut être dû aux raisons suivantes :

  • La page que vous avez sélectionnée est déjà liée à un autre catalogue
  • Votre catalogue est associé à un autre compte marchand
  • Si votre catalogue est utilisé avec l’app test et vous ne pouvez donc pas utiliser le même catalogue pour la production

Migration

Dans FBE 2.0, une Page Facebook ou un profil professionnel Instagram peut être connecté(e) à plusieurs plates-formes partenaires (sur la base de l’ID de l’application). Toutefois, un même profil ne peut être connecté qu’une seule fois pour une plate-forme partenaire donnée.

Non. Pour la discussion instantanée Messenger, les plates-formes des partenaires peuvent l'activer en définissant le messenger_chat de business_config dans Business Login. Pour la boutique de page, les entreprises/vendeurs doivent l’activer dans la Vue de gestion après la migration.

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

Plugins

Non. Ces deux plugins ont été abandonnés dans la vue de gestion de FBE. La discussion Messenger est le seul plugin pris en charge à partir de 2021.

HTTPS est requis pour les domaines figurant sur la liste blanche de Messenger. Les partenaires doivent valider les URL des champs de domaines avec l’ID du protocole, c’est-à-dire https://.

Découvrez comment configurer l’objet FBEMessengerChatConfigData.

Les partenaires peuvent être mieux placés pour garantir la validité du domaine Messenger et éviter aux entreprises/vendeurs d’avoir à configurer les domaines. Les partenaires peuvent définir messenger_chat.domains dans la business_config de FBE Business Login et définir messenger_chat.enabled=false

Les entreprises/vendeurs peuvent ensuite activer le plugin Messenger dans la vue de gestion, ou les partenaires peuvent fournir aux entreprises/vendeurs un moyen de le faire sur leurs plates-formes via l’API Feature Configuration.

Examen d’intégration

L’examen d’intégration est le processus par lequel Facebook vérifie votre intégration FBE. Une fois l’examen d’intégration de votre application réussi, votre application sera disponible pour les utilisateurs publics (c’est-à-dire les utilisateurs professionnels et les vendeurs).

Vous pouvez demander un examen d’intégration dans l’onglet panneau FBE Developer Panel > Vue d’ensemble de votre application une fois que toutes les conditions requises sont remplies. Pour accélérer le processus d’examen, vous devriez également partager avec nos examinateurs ou votre représentant FB une vidéo de démonstration de bout en bout de toutes les fonctionnalités FBE que vous avez implémentées.

Seuls les administrateurs et les développeurs de votre application seront en mesure de lancer le processus FBE jusqu’à ce que votre application ait passé l’examen avec succès.

Please reach out to your Meta partner manager, or submit a new integration review.

SDK/API/Webhooks/Mobile

Oui, FBE est prise en charge par les navigateurs mobiles et peut également être lancée à l’aide de webviews via votre application native Android/iOS. En savoir plus sur le lancement de FBE sur mobile.

Les tokens d’accès sont nécessaires pour effectuer des appels à l’API Graph. Les différents types de tokens d’accès sont expliqués ici.

Vous pouvez appeler Facebook Login pour obtenir l’access_token avant de lancer la Vue de gestion, puis utiliser cet access_token pour appeler l’API Feature Configuration.

Exemple de code :

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: ’popup’,
      method: ’facebook_business_extension’,
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === ’connected’) {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log(’User cancelled login or did not fully authorize.’);
        }
      }, {});
    }
  });

Boutiques

L’utilisation d’Instagram Shopping pour les processus hors site et sur site requiert un compte business Instagram. Les comptes Instagram personnels ne sont pas éligibles. Si votre compte business Instagram n’a pas une présence établie ou ne vend pas de biens éligibles, votre compte peut ne pas être éligible. Vous pouvez alors demander une nouvelle vérification dans six (6) mois. Consultez les conditions d’éligibilité.

Un compte commercial peut avoir à la fois des boutiques hors site et des boutiques sur site. Vous pouvez également convertir des boutiques sur site en boutiques hors site et vice versa. Si votre entreprise a besoin de boutiques hors site et sur site, vous aurez besoin de deux processus d’intégration avec des éléments différents.

La sélection des éléments dépend de plusieurs facteurs et les motifs de non-éligibilité sont multiples. Voici quelques exemples de ces raisons :

  • L’utilisateur n’est pas un admin de l’entreprise propriétaire de la Page
  • La Page est associée à un autre Business Manager

Nous contacter

Utilisez l’outil Assistance directe dans Business Manager pour obtenir une assistance directement auprès de notre équipe :

  • Partenaires Rendez-vous, Réservations et Commande de nourriture : utilisez la rubrique Extension Facebook Business pour les services
  • Partenaires commerciaux : utilisez la rubrique Partenaire marketing : assistance technique ou contactez directement votre responsable des partenaires Facebook.

Si vous ne voyez pas la rubrique souhaitée dans le menu déroulant Assistance directe, veuillez contacter votre représentant responsable des partenaires Facebook par e-mail pour obtenir l’accès.

L’Assistance directe offre une intégration importante avec le Business Manager. Veillez donc à ajouter tous les membres de votre équipe qui utiliseront l’outil Assistance directe pour soumettre des questions et des bugs en tant qu’utilisateurs du Business Manager de votre entreprise. Pour ce faire, suivez les instructions décrites ici.

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.