คู่มือการย้ายนี้จะอธิบายการเปลี่ยนแปลงที่จำเป็นในการย้ายผู้ค้าบน FBE เวอร์ชั่น 1 เพื่อให้เข้ากันได้กับ FBE เวอร์ชั่น 2
เนื่องจาก FBE เวอร์ชั่น 2 นั้นต่างจาก FBE เวอร์ชั่น 1 เป็นอย่างมากในแง่ของการนำไปใช้งานทางเทคนิค เราขอแนะนำอย่างยิ่งให้ปฏิบัติตามคู่มือ FBE เวอร์ชั่น 2 สำหรับการนำไปใช้งานและหลักปฏิบัติที่ดีที่สุด
FBE เวอร์ชั่น 1 | FBE เวอร์ชั่น 2 |
---|---|
ใช้การเข้าสู่ระบบธุรกิจสำหรับการยืนยันตัวตนและการตั้งค่า ระบบจะเปิดใช้มุมมองการจัดการโดยแยกต่างหาก | |
การนำไปใช้งานที่คล้ายคลึงกันสำหรับพิกเซล โดยเพิ่ม API ฝั่งเซิร์ฟเวอร์ | |
การนำไปใช้งานที่คล้ายคลึงกัน ขอแนะนำอย่างจริงจังให้ใช้แนวทางการดัน (ผ่าน API) มากกว่าการดึง (ฟีด) ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบแค็ตตาล็อก FBE เวอร์ชั่น 2.0 | |
เลิกใช้แล้ว ขณะนี้ มีสองตัวเลือกในการดึงข้อมูลธุรกิจ: Webhooks และตำแหน่งข้อมูลการติดตั้ง FBE |
เมื่อเปิดใช้การเข้าสู่ระบบธุรกิจสำหรับ FBE เวอร์ชั่น 2 ให้ระบุ merchant_settings_id
ในอ็อบเจ็กต์การตั้งค่าmerchant_settings_id
ใน FBE เวอร์ชั่น 1 จะถูกส่งในการผ่านข้อความทาง set merchant settings
(อ้างอิง) และควรถูกจัดเก็บไว้บนฝั่งของพาร์ทเนอร์แล้ว เพื่อแสดงป๊อปอัพมุมมอง FBE ที่ถูกต้องสำหรับการส่งคืนผู้ใช้ใน FBE เวอร์ชั่น 1
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>", }, ... }
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 ปกติ และเลือกแต่ละองค์ประกอบ