مصادقة تسجيل دخول النشاط التجاري

تسجيل دخول النشاط التجاري (المعروف باسم تسجيل دخول فيسبوك) هو نقطة دخول تتيح لأصحاب الأنشطة التجارية ربط نشاطهم التجاري على منصتك بملفاتهم الشخصية على Facebook أو Instagram باستخدام زر تضعه في موقعك.

يتواجد تسجيل دخول النشاط التجاري على واجهة المنصة لديك (عادة في لوحدة تحكم داخلية في موقعك) ويؤدي إلى بدء تشغيل دفق تسجيل دخول النشاط التجاري. ويمكن لأصحاب الأنشطة التجارية استخدام هذا الدفق لربط ملفاتهم الشخصية على Facebook بحضور نشاطهم التجاري على موقعك، وكذلك تمكين ميزات ملحق Facebook للأعمال (FBE).

يتم إنشاء حل إنابة (OBO) للنشاط التجاري يربط الأنشطة التجارية للشريك والعميل أثناء تثبيت ملحق FBE. ويتيح للشريك الحصول على رمز وصول مستخدم النظام لملحق FBE باستخدام بيانات اعتماد مستخدم النظام لدى مسؤول مدير أعمال الشريك، إلى جانب بيانات اعتماد مسؤول مدير الأعمال لدى العميل (الأسلوب المُستخدم حاليًا).

المتطلبات

قد يحتاج التطبيق إلى إكمال عملية مراجعة التطبيقات للحصول على الأذونات التالية:

• catalog_management - فقط إذا كان تطبيقك سيسمح بتمكين ميزات الكتالوج. وبدلاً من ذلك، يمكنك طلب إذن ads_management إذا كنت تريد أيضًا إدارة إعلانات البائعين نيابة عن العميل.
• business_creative_management - إذا كان تطبيقك مخصصًا للتصميمات الإبداعية ويستخدم draper api.

إعداد دفق تسجيل الدخول

لإعداد دفق تسجيل الدخول، يمكنك مراجعة الخيارات التالية:

• تحميل تسجيل دخول النشاط التجاري عبر عنوان URL—موصى به إذا كنت لا تنوي استخدام مجموعة Facebook SDK للغة JavaScript. ويتطلب هذا الخيار أن تكون مرتبطًا بعنوان URL تم إنشاؤه ديناميكيًا لكل نشاط تجاري من زر محدد في موقعك.

• تحميل تسجيل دخول النشاط التجاري عبر مجموعة Facebook SDK—توفر مجموعة Facebook SDK الوظائف الشائعة من جانب العميل. ونوصي باستخدام هذا الخيار بالنسبة للمطوّرين الذين على دراية أكبر به حيث إنه يقدم نهجًا قياسيًا بصورة أكبر لطرح الدفق نفسه.

تحميل تسجيل دخول النشاط التجاري عبر عنوان URL

لبدء تسجيل دخول النشاط التجاري عبر عنوان URL، ضع أي زر على موقعك يمكنه فتح عنوان URL.

يجب أن يحتوي عنوان URL لتسجيل دخول النشاط التجاري على معلمات الاستعلام التالية:

إذا كان تطبيقك يتطلب محددات URI لإعادة التوجيه الديناميكي، فاستخدم معلمة الحالة لإدخال المعلومات الديناميكية مرة أخرى في محدد URI لإعادة التوجيه بعد اكتمال دفق تسجيل دخول النشاط التجاري.

في المثال التالي، يتم تنسيق معلمة الاستعلام extras بشكل صحيح، ويمكن تحديد الكائنين business_config وsetup.

مثال على عنوان URL

https://facebook.com/dialog/oauth?
client_id=<FB_APP_ID>
&display=page
&redirect_uri="https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension
//   alternatively use catalog_management or ads_management
//   &scope=manage_business_extension,catalog_management,ads_management
&extras={
  "setup": {
    "external_business_id": "foo-123",
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "business_vertical": "APPOINTMENTS"
  },
  "business_config": {
    "business": {
      "name": "Foo Business"
    },
    "page_cta": {
      "enabled": true,
      "cta_button_text": "Book Now",
      "cta_button_url": "https://partner-site.com/foo-business",
      "below_button_text": "Powered by FBE Partner"
    },
    "page_card": {
      "enabled": true,
      "see_all_text": "See All",
      "see_all_url": "https://partner-site.com/foo-business",
      "cta_button_text": "Book"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Book Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "messenger_menu": {
      "enabled": true,
      "cta_button_text": "Book Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "thread_intent": {
      "enabled": true,
      "cta_button_url": "https://partner-site.com/foo-business"
    }
  },
  "repeat": false
}

تحميل تسجيل دخول النشاط التجاري عبر مجموعة Facebook SDK

الخطوة الأولى. تحميل مجموعة Facebook SDK للغة JavaScript

يمكنك تنزيل مجموعة SDK واستضافتها على منصتك أو سحب مجموعة SDK المُستضافة على Facebook. ونوصي باستخدام مجموعة SDK المُستضافة على Facebook.

الخطوة الثانية. إرفاق الوظيفة fbAsyncInit بالكائن Window لإعداد إعدادات مجموعة SDK.

قبل تحميل مجموعة SDK للغة javascript، تحتاج الوظيفة fbAsyncInit للتواجد على الكائن window. وستستدعي مجموعة SDK الوظيفة لإعداد window.fbAsyncInit() الصحيح.

يتضمن هذا الإعداد ما يلي:

• appId: معرف تطبيق Facebook.
• cookie: يمكن تمكين ملفات تعريف الارتباط من السماح للخادم بالوصول إلى هذه الجلسة.
• xfbml: يمكن تحليل المكونات الإضافية للتواصل الاجتماعي على هذه الصفحة.
• version: يمكن إعلام مجموعة SDK بإصدار واجهة graph API المطلوب استخدامه (تمت كتابة هذا المستند أثناء طرح الإصدار 10.0 باعتباره أحدث إصدار)

قبل تحميل مجموعة SDK للغة JavaScript، أرفق fbAsyncInit بالكائن window.

الخطوة الثالثة. بدء استخدام ملحق FBE عبر الوظيفة FB.login() (المعروفة أيضًا باسم "تسجيل دخول النشاط التجاري").

بعد تحميل مجموعة SDK أو تهيئة المعلومات الصحيحة، استخدم مجموعة SDK لتحميل FB.login(). وتكون المعلمات المهمة المطلوب إدخالها في الوظيفة FB.login() كما يلي:

1. وظيفة استدعاء الاستجابة
2. كائن لـ scope وحقل extras

للحصول على التفاصيل، يمكنك الرجوع إلى كائنات وأنواع واجهة API ملحق Facebook للأعمال.

مثال:

<script>
    window.fbAsyncInit = function() {
    //2. FB JavaScript SDK configuration and setup
        FB.init({
            appId      : '<app_id>', // FB App ID
            cookie     : true,  // enable cookies to allow the server to access the session
            xfbml      : true,  // parse social plugins on this page
            version    : 'v4.0' // uses graph api version v4.0
        });
    };

    //1. Load the JavaScript SDK asynchronously
    (function(d, s, id) {
        var js, fjs = d.getElementsByTagName(s)[0];
        if (d.getElementById(id)) return;
        js = d.createElement(s); js.id = id;
        js.src = "https://connect.facebook.net/en_US/sdk.js";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'facebook-jssdk'));

     //3. Facebook login with JavaScript 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"
                },
                "business_config":{
                  "business":{
                     "name":"<business_name>"
                  },
                  "ig_cta": {
                    "enabled": true,
                    "cta_button_text": "Book Now",
                    "cta_button_url": "https://partner-site.com/foo-business"
                  }
                },
                "repeat":false
            }
        });
    }
</script>

الخطوة الرابعة. إنشاء زر أو رابط لبدء استخدام ملحق FBE.

لتحميل الشاشة، أضف الدالة onClick للزر أو الرابط والتي تستدعي launchFBE():

<button onclick="launchFBE()"> Launch FBE Workflow </button>

الهاتف المحمول

لتنفيذ ملحق FBE على الهاتف المحمول، يرجى الرجوع إلى وثائق الهاتف المحمول.

تعرَّف على المزيد

• كيفية تنفيذ عملية دمج تطبيقات النشاط التجاري
• تعرف على تسجيل دخول فيسبوك
• اطّلع على كائنات وأنواع واجهة API ملحق FBE
• تعرف على المزيد حول عملية مراجعة التطبيقات والأذونات
• كيفية إلغاء تثبيت ملحق FBE