轉移指南：FBE v1 至 FBE v2

本轉移指南介紹轉移 FBE v1 上的現有商家時所需的變更，從而與 FBE v2 相容。

變更

由於 FBE v2 與 FBE v1 在技術執行上有巨大差異，我們強烈建議遵循 FBE v2 指南，以了解執行操作和最佳操作實例。

企業登入

啟動 FBE v2 專用企業登入時，在設定物件中指定 merchant_settings_id。FBE v1 中的 merchant_settings_id 會在經 set merchant settings（參考資料）傳遞的訊息中傳送，並應已儲存在合作夥伴端，以彈出合適的 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 中的所有資產及其相應企業管理平台具有管理員權限，系統會提示用戶在單一畫面上轉移內容，如左圖所示。在此轉移中，由於像素無法轉移至其他企業管理平台，因此預選的企業管理平台會跟從像素的企業管理平台。

• 如果用戶對 FBE v1 中的所有資產具有管理員權限，但像素並非歸企業管理平台所有，此時系統便會提示用戶在單一畫面上轉移內容（如左圖所示），並提供編輯功能。在此情況中，用戶可以選擇現有企業管理平台，或建立新的企業管理平台。

• 如果用戶並無所有資產及其相應企業管理平台的管理員權限，系統便會將其重新導向錯誤畫面，如右圖所示。在此轉移中，用戶需要遵循一般的 FBE 設定流程並選擇每項資產。