Hướng dẫn chuyển: FBE v1 sang FBE v2

Hướng dẫn chuyển này mô tả các thay đổi cần thiết để chuyển những người bán hiện có trên FBE v1 cho tương thích với FBE v2.

Các thay đổi

Do FBE v2 khác đáng kể so với FBE v1 về mặt triển khai kỹ thuật, bạn nên triển khai theo hướng dẫn dành cho FBE v2 và áp dụng những cách làm tốt nhất.

Đăng nhập cho doanh nghiệp

Khi khởi chạy phương thức Đăng nhập cho doanh nghiệp đối với FBE v2, hãy chỉ định merchant_settings_id trong đối tượng thiết lập. merchant_settings_id trong FBE v1 được gửi bằng tin nhắn qua set merchant settings (tài liệu tham khảo) và phải được lưu trữ sẵn bên phía đối tác để hiển thị chế độ xem FBE chính xác cho những người dùng quay lại trên FBE v1.

Qua 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>",
     },
     ...
}

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

Tốt nhất là chỉ chuyển merchant_settings_id qua phương thức Đăng nhập cho doanh nghiệp khi người dùng chưa chuyển thành công sang FBE v2. Khi merchant_settings_id được chuyển vào, chúng tôi sẽ tìm nạp các tài sản người dùng đã chọn trong FBE v1 và đơn giản hóa quy trình chuyển cho người dùng đó.

Khi bạn cung cấp merchant_settings_id trong quy trình thiết lập FBE, người dùng được nhắc chuyển theo những cách sau đây:

• Nếu một người dùng có quyền truy cập của quản trị viên vào tất cả tài sản trên FBE v1 và Trình quản lý kinh doanh tương ứng, người dùng đó sẽ được nhắc chuyển đến một màn hình hiển thị các bước chuyển, như hình minh họa ở bên trái. Trong trường hợp chuyển này, Trình quản lý kinh doanh được chọn sẵn sẽ là Trình quản lý kinh doanh của pixel do không thể chuyển pixel sang một Trình quản lý kinh doanh khác.

• Nếu một người dùng có quyền truy cập của quản trị viên vào tất cả tài sản trên FBE v1 nhưng pixel lại không thuộc sở hữu của Trình quản lý kinh doanh nào, người dùng đó sẽ được nhắc chuyển đến một màn hình hiển thị các bước chuyển, như hình minh họa ở bên trái, nhưng có chức năng Chỉnh sửa. Trong trường hợp này, người dùng có thể chọn một Trình quản lý kinh doanh hiện có hoặc tạo một Trình quản lý kinh doanh mới.

• Nếu không có quyền truy cập của quản trị viên vào tất cả tài sản và Trình quản lý kinh doanh tương ứng, người dùng sẽ được chuyển hướng đến một màn hình lỗi, như hình minh họa ở bên phải. Trong trường hợp chuyển này, người dùng cần phải thực hiện quy trình thiết lập FBE thông thường và chọn từng tài sản.