دليل الترحيل: من ملحق FBE بالإصدار 1 إلى ملحق FBE بالإصدار 2

يصف دليل الترحيل هذا التغييرات المطلوبة لترحيل البائعين الحاليين الذين يستخدمون ملحق FBE بالإصدار 1 ليكونوا متوافقين مع ملحق FBE بالإصدار 2.

التغييرات

نظرًا إلى أن ملحق FBE بالإصدار 2 يختلف اختلافًا كبيرًا عن ملحق FBE بالإصدار 1 من حيث التنفيذ الفني، فإننا ننصح بشدة باتباع دلائل ملحق FBE بالإصدار 2 فيما يتعلق بالتنفيذ وأفضل الممارسات.

تسجيل دخول النشاط التجاري

عند بدء استخدام ميزة تسجيل دخول النشاط التجاري لملحق 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 العادي وتحديد كل أصل.