Guide de migration : FBE v1 à FBE v2

Ce guide de migration décrit les modifications requises pour permettre aux commerçant·es sur FBE v1 d’être compatibles avec FBE v2.

Modifications

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 v1FBE v2

Écran de lancement

Utilise Business Login pour l’authentification et la configuration. La vue de gestion est lancée séparément.

Pixel

Implémentation similaire pour le pixel, l’API côté serveur en plus.

Catalogue

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.

Transmission des messages

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.

Business Login

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.

Via URL

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>",
     },
     ...
}

Via SDK

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.