تكوين ميزات النشاط التجاري

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

خيارات التكوين

لتمكين ميزات النشاط التجاري وتكوينها للمستخدم، استخدم أحد الخيارات المتوفرة هذه:

الميزات المدعومة

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

يتم تجميع الميزات التالية حسب المجال الذي يناسبها بشكل أفضل:

الميزات القياسية

الميزات الخاصة بالمواعيد

لا يلزم إجراء أي تنفيذ إضافي

يلزم إجراء تنفيذ إضافي

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>

الإعداد الأولي للميزة عبر تسجيل دخول النشاط التجاري

يمكنك تكوين أي عدد من الميزات لنشاطك التجاري عن طريق تحديدها في الخاصية business_config والتي يتم إدخالها عبر المعلمة extras في تسجيل دخول النشاط التجاري وApp Store. هذا هو المكان الذي يجب أن تحدد فيه كل الميزات التي تريد تمكينها لنشاطك التجاري بمجرد اكتمال تثبيت ملحق FBE.

business_config هو كائن بلغة JSON يحتوي على حقول فرعية لتوضيح كيفية تكوين ميزات متنوعة. تعرف على المزيد حول الحقول الفرعية المطلوب تحديدها، وكذلك business_config. على سبيل المثال، لتكوين زر الدعوة لاتخاذ إجراء (CTA) في صفحة فيسبوك للأنشطة التجارية وزر الدعوة لاتخاذ إجراء (CTA) في Instagram، سيظهر الكائن 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"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

عرض إدارة ميزة ملحق FBE

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

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

يمكنك تحديد علامة التبويب المحددة لعرض إدارة ملحق FBE عن طريق إدخال المعلمة الاختيارية tab مع تضمين اسم علامة التبويب المطلوبة. على سبيل المثال، يمكن تعيينها على "الصفحة الرئيسية" أو "التجارة". ويمكن استخدام هذه المعلمة في مجموعة SDK للغة Javascript أو مع أسلوب عنوان URL.

مجموعة SDK للغة Javascript في فيسبوك

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

أسلوب عنوان URL

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

API تكوين ميزة ملحق FBE

لتكوين ميزات النشاط التجاري وتحديثها من جانبك بعد الانتهاء من عملية التثبيت الأولي، يمكنك استخدام API تكوين ميزة ملحق FBE.

بالنسبة إلى الميزات غير القابلة للتخصيص، يتم عرض معرف مثيل الميزة والتمييز الذي تم تمكينه فقط. يمكن تحديث الميزات القابلة للتخصيص فقط من خلال طلب POST.

تختلف API تكوين الميزة عن API تثبيت ملحق FBE نظرًا لأنها توفر معلومات إضافية حول الميزة بخلاف الأصول المرتبطة بها، بما في ذلك الحالة الممكّنة وتخصيصات الميزة المحددة. بعد استدعاء API تثبيت ملحق FBE، استخدم API تكوين الميزة إذا احتجت إلى معلومات إضافية حول حالة الميزة الممكّنة أو التكوين المرتبط بها.

تسمح لك نقاط نهاية API التالية بتمكين الميزات وتعطيلها وتكوينها لأي نشاط تجاري محدد على منصتك التي قامت بتثبيت ملحق FBE. access_token المُستخدم لنقاط النهاية هذه هو الرمز الذي تم إرجاعه عبر تسجيل دخول النشاط التجاري أو حدث Webhook.

القراءة

يمكنك قراءة حالة تكوين الميزة الحالية الخاصة بأي نشاط تجاري عن طريق إصدار الطلب التالي:

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

الاستجابة

يمكنك الرجوع إلى الكائن business_config.

التحديث

لتحديث أية ميزة أو جميع الميزات، يرجى تقديم الطلب POST التالي:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

الاستجابة

مثال على الاستجابة.

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

تمكين زر الدعوة لاتخاذ إجراء في صفحة المستخدم النهائي، وتكوينه، بالإضافة إلى إرسال طلبات POST:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

معرفة المزيد

الكتالوج

الخطوات التالية

تشغيل أحداث البيكسل