Ce guide de migration décrit les modifications requises pour permettre aux commerçant·es sur FBE v1 d’être compatibles avec FBE v2.
FBE v2 présentant d’importantes différences avec FBE v1 en termes d’implémentation technique, nous vous recommandons vivement de suivre les guides FBE v2 pour connaître les instructions d’implémentation ainsi que nos recommandations.
FBE v1 | FBE v2 |
---|---|
Utilise Business Login pour l’authentification et la configuration. La vue de gestion est lancée séparément. | |
Implémentation similaire pour le pixel, l’API côté serveur en plus. | |
Implémentation similaire. L’envoi (Push) (via l’API) est vivement recommandé, plutôt que l’extraction (Pull) (via un fil). Voir plus de détails dans la documentation Catalogue FBE v2.0. | |
ABANDONNÉE. Deux options permettent désormais de récupérer les informations sur l’entreprise : le Webhook et le point de terminaison FBE Installs. |
Lorsque vous lancez Business Login pour FBE v2, spécifiez l’ID merchant_settings_id
dans l’objet setup. Dans FBE v1, l’ID merchant_settings_id
est envoyé avec la transmission de message via set merchant settings
(référence) et doit être déjà stocké côté partenaire pour afficher la vue FBE permettant de renvoyer les utilisateur·ices sur FBE v1.
https://facebook.com/dialog/oauth?client_id=<YOUR_FB_APP_ID> &display=<popup|window|page> &redirect_uri=<REDIRECT_URI> // e.g. "https://partner-site.com/redirectlanding" &response_type=token &scope=manage_business_extension,catalog_management &extras={ "setup": { "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", // e.g. "foo-123" "timezone": "<BUSINESS_TIMEZONE>", // e.g. "America/Los_Angeles" "currency": "<BUSINESS_SERVICES_CURRENCY>", // e.g. "USD" "business_vertical": "ECOMMERCE" "merchant_settings_id": "<MERCHANT_SETTINGS_ID_FROM_FBE_V1>", }, ... }
function launchFBE() { FB.login(function (response) { if (response.authResponse) { // returns a User Access Token with scopes requested const accessToken = response.authResponse.accessToken; const message = { 'success':true, 'access_token':accessToken, }; // store access token for later } else { console.log('User cancelled login or did not fully authorize.'); } }, { scope: 'catalog_management,manage_business_extension', // refer to the extras object table for details extras: { "setup":{ "external_business_id":"<external_business_id>", "timezone":"America\/Los_Angeles", "currency":"USD", "business_vertical":"ECOMMERCE", "merchant_settings_id": "<MERCHANT_SETTINGS_ID_FROM_FBE_V1>", }, ... } }); }
Dans l’idéal, merchant_settings_id
ne doit être transmis dans Business Login que lorsque l’utilisateur·ice n’est pas encore passé·e à FBE v2. Une fois la transmission de merchant_settings_id
effectuée, nous récupérons les éléments de l’utilisateur·ice sélectionnés sous FBE v1 et simplifions la migration.
Lorsque vous fournissez merchant_settings_id
dans le flux de configuration FBE, l’utilisateur·ice est invité·e à suivre les chemins de migration suivants :
Si un·e utilisateur·ice dispose d’un accès admin à tous les éléments de FBE v1 et à leurs Business Managers respectifs, il ou elle est invité·e à procéder à une migration à un écran, comme illustré sur la gauche. Au cours de cette migration, un Business Manager présélectionné suit le Business Manager du pixel, car ce dernier ne peut pas être transféré vers un autre Business Manager.
Si un·e utilisateur·ice dispose d’un accès admin à tous les éléments de FBE v1, mais que le pixel n’est pas associé à un Business Manager, l’utilisateur·ice est invité·e à procéder à une migration à un écran, comme illustré sur la gauche, mais avec la fonctionnalité Modifier. Dans ce cas, les utilisateur·ices peuvent sélectionner un Business Manager existant ou en créer un.
Si un·e utilisateur·ice ne dispose pas d’un accès admin à tous les éléments ni à leurs Business Managers respectifs, il ou elle est redirigé·e vers un écran d’erreur, tel qu’illustré sur la droite. Dans ce cas, il ou elle doit suivre la procédure de configuration FBE normale et sélectionner chaque élément.