移轉指南：FBE 第 1 版移轉至 FBE 第 2 版

本移轉指南說明在移轉 FBE 第 1 版上現有的商家時，需要進行哪些變更，才能與 FBE 第 2 版相容。

變更

FBE 第 2 版與 FBE 第 1 版在技術實作方面有著極大差異，因此強烈建議您遵循 FBE 第 2 版指南中的實作方式和最佳作法進行操作。

FBE 第 1 版	FBE 第 2 版
啟動畫面	利用商家登入進行驗證和設定。管理檢視畫面會分開啟動。
像素	與像素的實作方式類似，但需額外使用伺服器端 API。
目錄	實作方式類似；強烈建議採用「推送」（透過 API）方法，而不是「提取」（摘要）方法。如需詳細資訊，請參閱 FBE 第 2 版目錄文件。
訊息傳遞	此功能已停用。現在提供兩種擷取商家資訊的選項：Webhook 和 FBE 安裝端點。

商家登入

啟動 FBE 第 2 版適用的商家登入時，請在 setup 物件中指定 merchant_settings_id。系統會透過 set merchant settings（參考資料），在訊息傳遞中送出 FBE 第 1 版的 merchant_settings_id，此資訊應已儲存在合作夥伴端，這樣用戶回訪 FBE 第 1 版時才會彈出適當的 FBE 檢視畫面。

透過網址

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 第 2 版時，才會將 merchant_settings_id 傳入商家登入。當 merchant_settings_id 傳入後，我們會擷取用戶在 FBE 第 1 版下選擇的資產，並為用戶簡化移轉程序。

當您在 FBE 設定流程中提供 merchant_settings_id 時，系統會提示用戶前往下列移轉路徑：

如果用戶具備 FBE 第 1 版所有資產及其個別企業管理平台的管理員存取權限，則系統會提示用戶進行單一畫面移轉程序，如左圖所示。在這個移轉過程中，預先選擇的企業管理平台遵循像素的企業管理平台，因為像素不能移轉至另一個企業管理平台。
如果用戶具備 FBE 第 1 版所有資產的管理員存取權限，但像素並非企業管理平台所擁有，則系統會提示用戶進行單一畫面移轉程序，如左圖所示，但會另外提供編輯功能。在這種情況下，用戶可以選擇現有的企業管理平台，或建立新的企業管理平台。
如果用戶沒有所有資產及其個別企業管理平台的管理員存取權限，則系統會將用戶重新導向至錯誤畫面，如右圖所示。在這個移轉過程中，用戶必須遵循一般的 FBE 設定流程，並選擇各項資產。