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

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

Cambios

Debido a que la versión 2 de la FBE difiere considerablemente de la versión 1 en cuanto a la implementación técnica, recomendamos seguir las guías de la FBE versión 2 para conocer los requisitos de instalación y las prácticas recomendadas.

Inicio de sesión comercial

Al iniciar el Inicio de sesión comercial para la versión 2 de la FBE, especifica merchant_settings_id en el objeto setup. En la versión 1 de la FBE, merchant_settings_id, se envía mediante el paso de mensajes a través de set merchant settings (referencia) y ya debería estar almacenado en el lado del socio para mostrar una vista emergente adecuada de la FBE para usuarios recurrentes en la versión 1 de la FBE.

Mediante 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 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 solo debería pasarse en el inicio de sesión comercial si el usuario todavía no ha migrado correctamente a la versión 2 de la FBE. Cuando se pasa merchant_settings_id, obtenemos los activos seleccionados del usuario en la versión 1 de la FBE y simplificamos el proceso de migración para el usuario.

Cuando proporcionas merchant_settings_id en la configuración de la FBE, se le solicita al usuario que realice los siguientes pasos de migración:

• Si un usuario tiene acceso de administrador a todos los activos de la versión 1 de la FBE y sus respectivos administradores comerciales, el usuario ve la migración en una pantalla, como se muestra a la izquierda. En esta migración, un administrador comercial seleccionado previamente sigue al administrador comercial del píxel, ya que el píxel no se puede migrar a otro administrador comercial.

• Si un usuario tiene acceso de administrador a todos los activos de la versión 1 de la FBE, pero el píxel no es propiedad de un administrador comercial, el usuario ve la migración en una pantalla, como se muestra a la izquierda, pero con la funcionalidad Edit. En este caso, los usuarios pueden seleccionar un administrador comercial existente o crear uno nuevo.

• Sin acceso de administrador a todos los activos y sus respectivos administradores comerciales, los usuarios ven una pantalla de error, como se muestra a la derecha. En esta migración, deben seguir un flujo normal de configuración de la FBE y seleccionar cada activo.