Guida alla migrazione: da FBE, v1 a FBE, v2

Questa guida descrive le modifiche necessarie per effettuare la migrazione dei venditori esistenti su FBE, v1 affinché siano compatibili con FBE, v2.

Modifiche

Poiché FBE, v2 differisce notevolmente da FBE, v1 in termini di implementazione tecnica, consigliamo vivamente di seguire le guide FBE, v2 per l'implementazione e le best practice.

FBE, v1FBE, v2

Schermata di avvio

Sfrutta Business Login per l'autenticazione e la configurazione. La Vista di gestione sarà lanciata separatamente.

Pixel

Implementazione simile per il pixel, con aggiunta dell'API lato server.

Catalogo

Implementazione simile; consigliamo vivamente di utilizzare l'approccio Push (tramite API) piuttosto che Pull (Feed). Vedi maggiori dettagli nella documentazione Catalogo FBE v2.0.

Trasferimento dei messaggi

RIMOSSO. Ora sono disponibili due opzioni per recuperare le informazioni aziendali: Webhook ed endpoint FBE Installs.

Business Login

Quando lanci Business Login per FBE, v2, specifica merchant_settings_id nell'oggetto setup. In FBE, v1, merchant_settings_id viene inviato nella trasmissione dei messaggi tramite set merchant settings (riferimento) e dovrebbe essere già archiviato lato partner per far apparire una visualizzazione FBE corretta per gli utenti esistenti di FBE, v1.

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

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

Idealmente, merchant_settings_id dovrebbe essere trasmesso in Business Login solo quando l'utente non ha ancora completato la migrazione a FBE, v2. Quando viene trasmesso merchant_settings_id, recuperiamo le risorse selezionate dall'utente in FBE, v1, ottimizzando così il suo processo di migrazione.



Quando fornisci merchant_settings_id nel flusso di configurazione FBE, l'utente viene guidato ai seguenti percorsi di migrazione:

  • Se un utente ha accesso amministrativo a tutte le risorse da FBE, v1 e ai rispettivi Business Manager, viene indirizzato a una migrazione a schermata singola, come mostrato a sinistra. In questa migrazione, un Business Manager preselezionato segue il Business Manager del pixel perché il pixel non può essere migrato a un altro Business Manager.

  • Se un utente ha accesso amministrativo a tutte le risorse da FBE, v1, ma il pixel non è di proprietà di un Business Manager, l'utente viene indirizzato a una migrazione a schermata singola, come mostrato a sinistra, ma con la funzionalità di modifica. In questo scenario, l'utente può selezionare un Business Manager esistente o crearne uno nuovo.

  • Senza l'accesso amministrativo a tutte le risorse e ai rispettivi Business Manager, l'utente viene reindirizzato a una schermata di errore, come mostrato a destra, dove dovrà seguire un normale flusso di configurazione FBE e a selezionare ciascuna risorsa.