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, v1 | FBE, v2 |
---|---|
Sfrutta Business Login per l'autenticazione e la configurazione. La Vista di gestione sarà lanciata separatamente. | |
Implementazione simile per il pixel, con aggiunta dell'API lato server. | |
Implementazione simile; consigliamo vivamente di utilizzare l'approccio Push (tramite API) piuttosto che Pull (Feed). Vedi maggiori dettagli nella documentazione Catalogo FBE v2.0. | |
RIMOSSO. Ora sono disponibili due opzioni per recuperare le informazioni aziendali: Webhook ed endpoint FBE Installs. |
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.
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>", }, ... } }); }
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.