دليل الترحيل: Instagram (التجربة الفورية) إلى ملحق Meta للأعمال، بالإصدار 2

باعتبارك أحد شركائنا في "أزرار الإجراء" على Instagram، المدعومة بواسطة دمج التجارب الفورية (IX)، يجب عليك إنشاء المتطلبات التالية لملحق Meta للأعمال (MBE) بالإصدار 2 لمواصلة استخدام أزرار الدعوة لاتخاذ إجراء طلب الطعام ووظيفة ملصق طلبات الطعام في القصص:

1. عنوان URL المصادقة: للسماح بتأهيل نشاطك التجاري لاستخدام ملحق MBE من فيسبوك أو Instagram.
2. حدث Webhook: لاستلام إشعارات فورية في كل مرة يقوم فيها أحد أنشطتك التجارية بتثبيت ملحق MBE أو إلغاء تثبيته.
3. تشغيل أحداث البيكسل: لمساعدة الأنشطة التجارية في استهداف عملاء جدد بشكل أفضل، وزيادة المعاملات على مواقع الويب لديك، وقياس كيفية مساهمة دمج ملحق MBE في تعزيز النتائج بشكل مباشر.

بمجرد اكتمال تطوير ملحق MBE واختباره، ستقوم Meta بمراجعة الدمج والتحقق منه. بمجرد الموافقة على الدمج، سيتوفر تطبيقك لعامة المستخدمين.

قبل البدء

• إذا لم تقم بذلك بعد، فاحرص على التسجيل كمطوَر Meta حتى تتمكن من الوصول إلى أدوات المطوّرين وإنشاء تطبيقات Meta.
• إذا لم تقم بذلك بعد، فأنشئ تطبيق Meta.
• أنشئ تطبيقًا اختباريًا من تطبيق الإنتاج/التطبيق المنشور لديك واستخدمه في إجراء كل عمليات التطوير والاختبار الجديدة.
• يجب أن تكون تطبيقاتك (الإنتاج/وضع النشر والاختبار) تطبيقات من نوع الأعمال ومملوكة بواسطة مدير أعمال يمثل نشاطًا تجاريًا تم التحقق منه. تعرف على المزيد حول كيفية التحقق من النشاط التجاري وكيفية إضافة تطبيقك إليه.
• اتصل بشريك Meta وشارك معرفات التطبيق، حتى يمكن من منحك صلاحية الوصول إلى إمكانية manage_business_extension في ملحق MBE وبمجرد الموافقة، يمكنك بدء أعمال التنفيذ.

إعداد الدمج عبر لوحة تحكم المطوّر

تُعد لوحة تحكم المطوّر في ملحق Meta للأعمال منتجًا متوفرًا في لوحة معلومات تطبيق المطوّر. بمجرد منح تطبيقاتك إمكانية استخدام MBE، يجب استخدام لوحة تحكم المطوّر لإعداد الدمج والتحقق من صحته (بما في ذلك عنوان URL المصادقة ونقطة نهاية Webhook).

الخطوة الأولى: إضافة لوحة تحكم مطوّر MBE إلى تطبيقات مطوّر فيسبوك لديك.

الخطوة الثانية: في علامة تبويب "الإعداد"، حدد Food and Drink باعتباره المجال الوحيد، ثم حدد Instagram Call to Action Button وPage Surface Call To Action Button كميزات، وقم بتضمين جميع النطاقات التي يخدمها تطبيقك في بطاقة Wilcard Domains.

الخطوة الثالثة: بعد إنشاء عنوان URL المصادقة، استخدم واجهة تطبيقات الأعمال الموجودة في علامة تبويب "الإعداد" للتحقق من صحة عنوان URL (في حالة عرض أي أخطاء هناك)، بمجرد الحصول على علامة التحقق الخضراء، يمكنك الانتقال إلى تطبيقات الأعمال في Meta لإجراء اختبار شامل.

الخطوة الرابعة: بعد إنشاء حدث Webhook، انتقل إلى إعداد منتج Webhooks. إذا سارت عملية الإعداد على النحو المتوقع، فستظهر علامة تحقق خضراء في علامة تبويب "نظرة عامة" للعنصر الذي تم التحقق من صحته بواسطة حدث Webhook.

الخطوة الخامسة: بعد تشغيل أحداث البيكسل المطلوبة، أكمل استبيان البيكسل (بما في ذلك فيديو للتحقق من صحة تنفيذ البيكسل).

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

الخطوة السابعة: بمجرد الانتهاء من تنفيذ ملحق MBE، أكمل قائمة التحقق في علامة تبويب "نظرة عامة" ضمن لوحة تحكم المطوّر. الرجاء ملء النماذج الخاصة بتفاصيل التطبيق ومراجعة الدمج في علامة تبويب "مراجعة الدمج". سيؤدي النقر على زر الإرسال إلى بدء عملية المراجعة. بمجرد الموافقة على الدمج، ستتمكن من طرح التطبيق لعامة المستخدمين من خلال علامة تبويب "بدء الاستخدام". تعرف على المزيد حول عملية مراجعة الدمج وكيفية استلام الملاحظات والحالة الحالية من جانب فريقنا

إنشاء عنوان URL المصادقة

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

يستخدم ملحق MBE بالإصدار 2 عنوان URL المصادقة كقناة موثوقة لمشاركة تكوين النشاط التجاري للمستخدم (الاسم، وعنوان URL لزر الدعوة لاتخاذ إجراء، وغير ذلك) بين منصتك وInstagram/فيسبوك.

يحتاج عنوان URL للمصادقة إلى قبول معلمة استعلام GET واحدة redirect_uri وفيما يتعلق بعنوان URL هذا نوصي بما يلي:

1. السماح للمستخدمين بتسجيل الدخول إلى منصتك وتوفير خيار لتسجيل حساب جديد في المنصة (مثل، "التسجيل") كذلك.
2. إذا كنت تدعم أنشطة تجارية متعددة لكل حساب في منصتك، فاعرض واجهة مستخدم تتيح للمستخدم تحديد النشاط التجاري الموجود على منصتك والذي يريد ربطه بحضوره على فيسبوك.
3. احصل على معلمة الاستعلام redirect_uri المستلمة وألحق بها كائن extras كمعلمة استعلام.
4. أعد توجيه المستخدمين إلى عنوان URL الذي حصلت عليه (فقط إذا كان redirect_uri المستلم يطابق الصيغة العادية).

مثال — استخدم الكائن extras لتكوين نشاط تجاري وتمكين زر دعوة لاتخاذ إجراء في ملف النشاط التجاري على Instagram وزر دعوة لاتخاذ إجراء في صفحة فيسبوك

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

للحصول على تفاصيل حول عملية التنفيذ والاختبار بالكامل، راجع تطبيقات الأعمال.

إنشاء حدث Webhook

بعد قيام المستخدم بتثبيت تطبيقك أو تحديثه أو إلغاء تثبيته عبر "تطبيقات الأعمال"، فستصلك تفاصيل هذا الإجراء عبر حدث Webhook.

يتطلب منك إعداد حدث Webhook ما يلي:

1. إنشاء نقطة نهاية على خادم آمن يمكنه معالجة طلبات POST من فيسبوك.
2. قم بتكوين منتج أحداث Webhooks في لوحة معلومات التطبيق للاشتراك في حقل fbe_install الخاص بالكائن User.

للحصول على تفاصيل حول عملية التنفيذ والإعداد بالكامل، راجع حدث Webhook.

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

يُعد بيكسل Meta جزءًا حيويًا من ملحق Meta للأعمال، بالإصدار 2. يتعين تشغيل بيكسل الأحداث القياسية التالية بدقة لكل نشاط تجاري أكمل دمج ملحق MBE على منصتك.

الأحداث المطلوبة

• بالنسبة لجميع الصفحات المشاركة في عملية طلب الطعام: قم بتشغيل PageView
• بعد أن يتم اكتمال الطلب: قم بتشغيل Purchase

الأحداث الاختيارية

• قم بتشغيل AddToCart عندما تتم إضافة عنصر ما إلى الطلب.

يمكن تشغيل جميع الأحداث القياسية عن طريق استدعاء الوظيفة fbq('track') في البيكسل باسم الحدث وكائن JSON (اختياريًا) باعتبارهما معلماتها. على سبيل المثال، يتطلب حدث الشراء تضمين العملة والقيمة كمعلمة:

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

للحصول على تفاصيل حول عملية التنفيذ بالكامل، راجع تشغيل أحداث البيكسل.

أداة مساعدة البيكسل

نوصي بشدة بتثبيت ملحق Chrome لأداة مساعدة البيكسل التي نوفرها. توفر أداة مساعدة البيكسل ملاحظات قيمة للغاية يمكن أن تساعدك في التحقق من أن البيكسل المتوفر لديك يعمل بشكل صحيح، خاصةً عندما تبدأ في تتبع التحويلات، حيث تزيد احتمالية ظهور أخطاء التنسيق.

مراجعة الدمج وبدء الاستخدام

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

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

بعد إرسال الدمج في علامة تبويب "مراجعة الدمج" في لوحة تحكم المطوّر، ستتمكن من عرض الحالة والتحديثات والملاحظات الواردة من المراجعين لدينا في قسم "سجل المعلومات المقدمة" ضمن بطاقة "مراجعة الدمج".

سيوفر المراجعون ملاحظات مفصلة. في حالة رفض تطبيقك، يرجى إكمال جميع الخطوات المطلوبة قبل بدء عملية مراجعة جديدة. يمكنك القيام بذلك عن طريق النقر على زر إعادة الإرسال في علامة تبويب "مراجعة الدمج".