Guía de migración: de la versión 1 a la versión 2 de FBE

En esta guía de migración se describen los cambios necesarios para migrar los comerciantes existentes que usan la versión 1 de FBE para que sean compatibles con la versión 2.

Cambios

Dado que la versión 2 de FBE es considerablemente distinta de la versión 1 en términos de implementación técnica, es muy recomendable que sigas las guías de la versión 2 de FBE para obtener información sobre la implementación y las prácticas recomendadas.

Inicio de sesión empresarial

Al lanzar el inicio de sesión empresarial para la versión 2 de FBE, especifica el campo merchant_settings_id en el objeto setup. El campo merchant_settings_id en la versión 1 de FBE se envía en el paso del mensaje mediante set merchant settings (referencia) y ya debe estar almacenado en el socio para mostrar en una ventana emergente la vista de FBE correspondiente para los usuarios que ya hayan utilizado la versión 1 de FBE.

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

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

El campo merchant_settings_id solo debería pasarse en el inicio de sesión empresarial cuando el usuario aún no haya migrado correctamente a la versión 2 de FBE. Cuando se pasa el campo merchant_settings_id, se recuperan los activos que ha seleccionado el usuario de la versión 1 de FBE y el proceso de migración se agiliza.

Al proporcionar un campo merchant_settings_id en el proceso de configuración de FBE, se muestran al usuario los siguientes recorridos de migración:

• Si un usuario tiene acceso de administrador a todos los activos de la versión 1 de FBE y a las cuentas de Business Manager correspondientes, se muestra un proceso de migración de una sola pantalla, como se ve a la izquierda. En esta migración, una cuenta de Business Manager seleccionada previamente sigue a la cuenta de Business Manager del píxel, ya que este no puede migrarse a otra cuenta de este tipo.

• Si un usuario tiene acceso de administrador a todos los activos de la versión 1 de FBE, pero el píxel no es propiedad de una cuenta de Business Manager, se muestra un proceso de migración de una sola pantalla (como se ve a la izquierda), aunque con una funcionalidad de edición. En esta situación, los usuarios pueden seleccionar una cuenta de Business Manager existente o crear una nueva.

• Si los usuarios no tienen acceso de administrador a todos los activos y a las cuentas de Business Manager correspondientes, se les redirige a una pantalla de error, como se muestra a la derecha. En esta migración, deben seguir un proceso de configuración de FBE normal y seleccionar cada activo.