Panduan Migrasi: FBE, v1 ke FBE, v2

Panduan migrasi mendeskripsikan perubahan yang diperlukan untuk migrasi pelapak yang sudah ada di FBE, v1 agar kompatibel dengan FBE, v2.

Perubahan

Karena FBE, v2 secara signifikan berbeda dari FBE, v1 dalam hal penerapan teknis, kami sangat menyarankan untuk mengikuti panduan FBE, v2 untuk penerapan dan praktik terbaik.

Login Bisnis

Saat meluncurkan Login Bisnis untuk FBE, v2, tentukan merchant_settings_id di objek pengaturan. merchant_settings_id di FBE, v1 dikirim dalam penerusan pesan set merchant settings (referensi) dan seharusnya sudah disimpan di sisi partner untuk pop-up tampilan FBE yang tepat bagi pengguna yang kembali di FBE, v1.

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

Melalui 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 idealnya hanya diteruskan di Login Bisnis ketika pengguna belum berhasil bermigrasi ke FBE, v2. Saat merchant_settings_id diteruskan, kami mengambil aset yang dipilih pengguna di FBE, v1 dan merampingkan proses migrasi untuk pengguna.

Saat Anda menyediakan merchant_settings_id di alur pengaturan FBE, pengguna diarahkan ke jalur migrasi berikut:

• Jika pengguna memiliki akses admin ke semua aset dari FBE, v1 dan Pengelola Bisnisnya masing-masing, pengguna diminta untuk migrasi satu layar, seperti yang ditunjukkan di sisi kiri. Dalam migrasi ini, Pengelola Bisnis yang telah dipilih sebelumnya mengikuti Pengelola Bisnis Pixel karena Pixel tidak dapat dimigrasi ke Pengelola Bisnis lain.

• Jika pengguna memiliki akses admin ke semua aset dari FBE, v1, tetapi Pixel tidak dimiliki oleh seorang Pengelola Bisnis, pengguna diminta untuk migrasi satu layar, seperti yang ditunjukkan di sisi kiri, tetapi dengan fungsi Edit. Pengguna dalam skenario ini bisa memilih Pengelola Bisnis yang sudah ada atau membuat yang baru.

• Tanpa akses admin ke semua aset dan Pengelola Bisnisnya masing-masing, pengguna diarahkan kembali ke layar kesalahan, seperti yang ditunjukkan di sisi kanan. Dalam migrasi ini, pengguna diminta untuk mengikuti alur pengaturan FBE normal dan memilih setiap aset.