คู่มือการย้าย: FBE เวอร์ชั่น 1 ไปใช้ FBE เวอร์ชั่น 2

คู่มือการย้ายนี้จะอธิบายการเปลี่ยนแปลงที่จำเป็นในการย้ายผู้ค้าบน FBE เวอร์ชั่น 1 เพื่อให้เข้ากันได้กับ FBE เวอร์ชั่น 2

การเปลี่ยนแปลง

เนื่องจาก FBE เวอร์ชั่น 2 นั้นต่างจาก FBE เวอร์ชั่น 1 เป็นอย่างมากในแง่ของการนำไปใช้งานทางเทคนิค เราขอแนะนำอย่างยิ่งให้ปฏิบัติตามคู่มือ FBE เวอร์ชั่น 2 สำหรับการนำไปใช้งานและหลักปฏิบัติที่ดีที่สุด

FBE เวอร์ชั่น 1FBE เวอร์ชั่น 2

เปิดใช้หน้าจอ

ใช้การเข้าสู่ระบบธุรกิจสำหรับการยืนยันตัวตนและการตั้งค่า ระบบจะเปิดใช้มุมมองการจัดการโดยแยกต่างหาก

พิกเซล

การนำไปใช้งานที่คล้ายคลึงกันสำหรับพิกเซล โดยเพิ่ม API ฝั่งเซิร์ฟเวอร์

แค็ตตาล็อก

การนำไปใช้งานที่คล้ายคลึงกัน ขอแนะนำอย่างจริงจังให้ใช้แนวทางการดัน (ผ่าน API) มากกว่าการดึง (ฟีด) ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบแค็ตตาล็อก FBE เวอร์ชั่น 2.0

การผ่านข้อความ

เลิกใช้แล้ว ขณะนี้ มีสองตัวเลือกในการดึงข้อมูลธุรกิจ: Webhooks และตำแหน่งข้อมูลการติดตั้ง FBE

การเข้าสู่ระบบธุรกิจ

เมื่อเปิดใช้การเข้าสู่ระบบธุรกิจสำหรับ FBE เวอร์ชั่น 2 ให้ระบุ merchant_settings_id ในอ็อบเจ็กต์การตั้งค่าmerchant_settings_id ใน FBE เวอร์ชั่น 1 จะถูกส่งในการผ่านข้อความทาง set merchant settings (อ้างอิง) และควรถูกจัดเก็บไว้บนฝั่งของพาร์ทเนอร์แล้ว เพื่อแสดงป๊อปอัพมุมมอง FBE ที่ถูกต้องสำหรับการส่งคืนผู้ใช้ใน FBE เวอร์ชั่น 1

ผ่าน 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>",
     },
     ...
}

ผ่าน 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>",
                },
                ...
            }
        });
    }

ตามหลักการแล้ว ควรจะผ่าน merchant_settings_id ในการเข้าสู่ระบบธุรกิจก็ต่อเมื่อผู้ใช้ยังไม่ได้ย้ายไปยัง FBE เวอร์ชั่น 2 เมื่อผ่าน merchant_settings_id เราจะดึงองค์ประกอบที่เลือกของผู้ใช้ภายใต้ FBE เวอร์ชั่น 1 และปรับกระบวนการย้ายให้เหมาะสำหรับผู้ใช้



เมื่อคุณระบุ merchant_settings_id ในขั้นตอนการตั้งค่า FBE ผู้ใช้จะได้รับข้อความแจ้งไปยังพาธการย้ายต่อไปนี้:

  • หากผู้ใช้มีสิทธิ์ของผู้ดูแลในการเข้าถึงองค์ประกอบทั้งหมดจาก FBE เวอร์ชั่น 1 และตัวจัดการธุรกิจที่เกี่ยวข้อง ผู้ใช้จะได้รับข้อความแจ้งไปยังการย้ายหนึ่งหน้าจอตามที่แสดงทางด้านซ้าย ในการย้ายนี้ ตัวจัดการธุรกิจที่เลือกไว้ล่วงหน้าจะเป็นไปตามตัวจัดการธุรกิจของพิกเซล เนื่องจากไม่สามารถย้ายพิกเซลไปยังตัวจัดการธุรกิจอื่นได้

  • หากผู้ใช้มีสิทธิ์ของผู้ดูแลในการเข้าถึงองค์ประกอบทั้งหมดจาก FBE เวอร์ชั่น 1 แต่ตัวจัดการธุรกิจไม่ได้เป็นเจ้าของพิกเซล ผู้ใช้จะได้รับข้อความแจ้งไปยังการย้ายหนึ่งหน้าจอตามที่แสดงทางด้านซ้าย แต่จะมีฟังก์ชั่นแก้ไข ผู้ใช้ในสถานการณ์นี้สามารถเลือกตัวจัดการธุรกิจที่มีอยู่แล้ว หรือจะสร้างใหม่ก็ได้

  • หากไม่มีสิทธิ์ของของผู้ดูแลในการเข้าถึงองค์ประกอบทั้งหมดและตัวจัดการธุรกิจที่เกี่ยวข้อง ผู้ใช้จะถูกส่งไปยังหน้าจอข้อผิดพลาดตามที่แสดงทางด้านขวา ในการย้ายนี้ ผู้ใช้จะต้องทำตามขั้นตอนการตั้งค่า FBE ปกติ และเลือกแต่ละองค์ประกอบ