迁移指南：从 FBE v1 迁移到 FBE v2

本迁移指南介绍了将现有商家从 FBE v1 迁移到 FBE v2 时，为使商家与 FBE v2 兼容而需要做出的更改。

更改

由于 FBE v2 与 FBE v1 在技术实现方面存在重大差异，我们强烈建议按照 FBE v2 指南实现迁移并采取最佳实践。

企业登录

当启动适用于 FBE v2 的企业登录时，在 setup 对象中指定 merchant_settings_id。在通过 set merchant settings（参考文档）传递的消息中发送 FBE v1 中的 merchant_settings_id，并且 merchant_settings_id 应该已经存储在合作伙伴端以弹出合适的 FBE 视图，从而在 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>",
     },
     ...
}

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

理想情况下，在用户尚未成功迁移到 FBE v2 之前，仅应在企业登录中传递 merchant_settings_id。传递 merchant_settings_id 后，我们要在 FBE v1 下获取用户所选资产并为用户简化迁移流程。

当您在 FBE 设置流程中提供 merchant_settings_id 时，系统会提示用户遵循以下迁移路径：

• 如果用户对 FBE v1 中的所有资产及这些资产对应的商务管理平台具有管理员权限，系统会提示用户在单个页面上进行迁移（如上方左图所示）。在此迁移中，由于不能将 Pixel 像素代码迁移到其他商务管理平台，用户需要按照 Pixel 像素代码商务管理平台的设置对预选择的商务管理平台进行操作。

• 如果用户对 FBE v1 中的所有资产具有管理员权限，但 Pixel 像素代码并不归某个商务管理平台所有，系统会提示用户在单个页面上进行迁移（如上方左图所示），但是用户可以使用编辑功能。在此情况下，用户可以选择现有商务管理平台，或新建商务管理平台。

• 如果用户没有对所有资产及这些资产对应的商务管理平台的管理员权限，系统会将用户重定向到错误页面（如上方右图所示）。在此迁移情况下，用户需要遵循常规 FBE 设置流程并选择各个资产。