التعرف على Graph API بالإصدار 16.0 وAPI التسويق بالإصدار 16.0 من فيسبوك

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

للحصول على قائمة كاملة بكل التغييرات وتفاصيل حولها، يُرجى زيارة سجل التغييرات.

التحديثات والإعلامات العامة

الاستجابات للأخطاء بمنصة واتساب للأعمال

في إطار جهودنا المستمرة لتحسين سلوك الاستجابة لأخطاء واجهة API، أجرينا التغييرات التالية.

• لن يتم تضمين الرموز الفرعية للأخطاء، التي نادرًا ما تستخدم ولا ينبغي الاعتماد عليها، في استجابات الأخطاء بالإصدار 16.0 والإصدارات الأحدث. استخدِم الرمز والتفاصيل بدلاً من ذلك.
• احتوى رمز الخطأ 100 ("الرمز": 100) على عناوين فريدة متعددة أشارت إلى طبيعة الخطأ المحدد. ستستخدم كل أخطاء الرمز 100 الآن "معلمة غير صالحة" كعنوان. تم نقل العناوين القديمة التي تصف طبيعة الخطأ 100 المحدد إلى خاصية التفاصيل. ينعكس هذا التغيير الآن أيضًا في حمولات بيانات أحداث webhooks التي تصف استجابة خطأ بالرمز 100.
• اكتسبت كائنات أخطاء أحداث Webhook خاصية رسالة جديدة تقوم بتعيين خاصية الرسالة في حمولات بيانات الاستجابة لخطأ واجهة API.

ستتطلب منصة المطوّر الآن التحقق من النشاط التجاري للحصول على إمكانية الوصول المتقدم إلى أي واجهة API

كما أُعلِن في 1 فبراير 2023، تطلب Meta الآن من المطورين التحقق من أنشطتهم التجارية من أجل الحصول على إمكانية الوصول المتقدم للحصول على أي إذن على منصة Meta للمطوّرين في إطار عمليتنا للمساعدة في تأكيد مصداقية نشاط تجاري أو مؤسسة، وشرعيتها.

بالنسبة للتطبيقات التي تم إنشاؤها بعد 1 فبراير 2023، سنبدأ في طرح ذلك تدريجيًا عندما تطلب التطبيقات الجديدة وصولاً متقدمًا. سيتعين على التطبيقات التي تم إنشاؤها قبل 1 فبراير 2023، ولديها إمكانية الوصول المتقدم، الارتباط بنشاط تجاري تم التحقق منه بدءًا من 1 مايو 2023. للحصول على قائمة بالأذونات التي تتطلب التحقق من النشاط التجاري قبل اعتماده للوصول المتقدم، راجع هذه الصفحة.

عمليات إيقاف الاستخدام والتغييرات العاجلة

إيقاف استخدام ميزة "مراعاة الرحلة"

في عام 2018، أطلقنا ميزة "مراعاة الرحلة" كأداة تبديل يمكن لمعلني الرحلات تشغيلها، والتي تعطي الأولوية لإظهار الإعلانات للأشخاص الذين عبّروا عن نيتهم في السفر، لكنهم لم يقرروا وجهتهم بعد. تساعد ميزة "مراعاة الرحلة" وخيارات الاستهداف الحالية، المعلنين على إظهار الإعلانات للأشخاص المناسبين في الوقت المناسب عبر فيسبوك وInstagram وAudience Network. على مدار السنوات الأربع الماضية، أصبح بإمكاننا الآن مساعدة معلني الرحلات على الوصول إلى المستهلكين الذين ينوون السفر وتحقيق أهداف أداء مماثلة دون أداة التبديل كخيار، وذلك من خلال التطوير المستمر لأنظمة التعلم الآلي والاختبارات المكثفة.

اعتبارًا من 2 فبراير 2023، ستتم إزالة ميزة "مراعاة الرحلة" كخيار في مدير الإعلانات وواجهة API للحملات الإعلانية الجديدة. لقد قررنا أن التبديل لم يعد ضروريًا، ومن المتوقع أن يشهد المعلنون الأداء نفسه دون أداة التبديل. في هذه الأثناء، من غير المرجح أن يؤثر تشغيل أداة التبديل أو إيقاف تشغيلها بشكل ملحوظ على أداء الحملة الإعلانية.

بفضل تحسن نماذج تعلُّم الآلة، أصبح من الممكن الآن تحقيق نفس الأهداف والأداء دون استخدام أداة التبديل؛ لذلك نعتقد أن إزالتها ستقدم تجربة أبسط.

إيقاف استخدام إعلانات الرحلات الجوية للعملاء المحتملين

في سبتمبر 2018، أطلقنا حل إعلانات الرحلات الجوية للعملاء المحتملين بنجاح. وفي منتصف عام 2021، بدأ المنتج يواجه تحديات فنية وتم تحديد الأخطاء التي حالت دون تنفيذ الحملات الإعلانية بكفاءة. لذلك، قررنا إخبار المعلنين استباقيًا بالتحول إلى خيارات أخرى للإعلان للعملاء المحتملين. لا تزال إمكانية إعادة الاستهداف قائمة، ويمكن للمعلنين استخدامها.

إذا كنت أنت أو أحد شركائك تستخدم حاليًا حل إعلانات الرحلات الجوية للعملاء المحتملين، فإننا نوصي بإيقاف تشغيل أي حملات إعلانية حالية بحلول 1 مايو 2023.

إيقاف استخدام وضع الإعلانات في المقالات الفورية

سنزيل المقالات الفورية وإمكانية وضع الإعلانات فيها من فيسبوك بدءًا من 20 أبريل 2023. لقد قدمنا المقالات الفورية لأول مرة في عام 2015 للسماح للناشرين بإنشاء مقالات وسائط تفاعلية على الهاتف المحمول وتحقيق الأرباح منها من خلال الإعلانات على فيسبوك. ومع ذلك، يعد اكتشاف الأخبار جزءًا صغيرًا من تجربة فيسبوك بالنسبة لغالبية الأشخاص الذين يستخدمون المنصة، ويخبرنا الناس بأنهم يريدون رؤية قدر أقل من هذا المحتوى في موجزاتهم. وبناء على ذلك، نعدّل استثماراتنا لتتماشى بشكل أفضل مع تفضيلات المستخدم.

لن يكون وضع الإعلانات في المقالات الفورية متاحًا لإنشاء حملة إعلانية جديدة داخل مدير الإعلانات وواجهة API التسويق بدءًا من 20 أبريل 2023. بعد 20 أبريل 2023، سيتم الإيقاف المؤقت للمجموعات الإعلانية السابقة التي تحتوي حصريًا على ميزة "وضع المقالات الفورية"، كما سيتم التحديث التلقائي لجميع المجموعات الإعلانية الأخرى التي تتضمن ميزة "وضع المقالات الفورية" لاستبعاد تلك الميزة.

إخفاء التفاعلات والتعليقات والإشارات في المحتوى المنشور في ملفات المستخدمين الشخصية

بفضل هذا الإصدار، فإننا بصدد تنفيذ تغيير سيؤدي إلى إخفاء تعليقات وتفاعلات وإشارات مستخدم الجلسة. سيعرض حقلا "عبر" و"Sharedposts" بيانات فارغة لمنشورات في ملفات المستخدمين الشخصية أيضًا. لن يؤثر هذا التغيير إلا على المحتوى المنشور في ملفات المستخدمين الشخصية.

إيقاف دعم إصدارات TLS الأقدم من 1.2

لتحسين وضعنا الأمني، سنوقف دعم واجهات Graph API لإصدارات TLS الأقدم من TLS 1.2. في حالة استخدام الإصدار TLS 1.2، فسيتم أيضًا إيقاف الوصول باستخدام عمليات تشفير RSA الثابتة (AES128-GCM-SHA256، AES256-GCM-SHA384، AES128-SHA، AES256-SHA، DES-CBC3-SHA). ستتلقى طلبات واجهة API التي يتم إجراؤها باستخدام إصدارات TLS الأقدم خطأً بعد 90 يومًا.

سنرفض أيضًا زيارات الويب لـ developer.facebook.com بعد 1 مايو 2023 من المتصفحات التي تستخدم إصدارات TLS أقدم (أقدم من TLS 1.2 وتستخدم عمليات تشفير RSA ثابتة [AES128-GCM-SHA256، AES256-GCM-SHA384، AES128-SHA، AES256-SHA، DES-CBC3-SHA] في حالة استخدام TLS1.2).

فئات قوالب واتساب

في العام الماضي، قمنا بتحديث أنواع فئات القوالب في مدير واتساب وواجهة API لالتقاط حالات الاستخدام الجديدة التي يتم إرسالها على منصة واتساب للأعمال. في 2 فبراير 2023، سنعيد تسمية فئات القوالب هذه لتعكس حالات الاستخدام بدقة أكبر:

• ستظل قوالب التسويق تحت اسم التسويق (دون تغيير)
• ستُعاد تسمية قوالب المعاملات لتصبح مرافق
• ستُعاد تسمية قوالب كلمة المرور لمرة واحدة لتصبح المصادقة

يجب أن تستخدم الأنشطة التجارية فئات القوالب المحدثة هذه في حالة إنشاء قوالب أو تحريرها باستخدام الإصدار 16 من Graph. سيتم تطبيق هذا التغيير على جميع الإصدارات في 1 مايو، لذلك فإن أي محاولات لإنشاء قوالب أو تحريرها باستخدام أي إصدار، يجب أن تستخدم هذه الفئات الجديدة. لضمان عدم حدوث أي تعطُّل في عملية إنشاء القالب أو تحريره، يجب على الأنشطة التجارية وموفري حلول الأنشطة التجارية (BSP) إعطاء الأولوية لتحديث استدعاءات واجهة API لها لاستخدام قيم وقوالب بفئات جديدة في موعد أقصاه 1 مايو 2023.

بعض التواريخ والاعتبارات الرئيسية الأخرى موضحة أدناه:

• ترحيل القوالب:في 1 أبريل، سيُرحِّل واتساب جميع القوالب الحالية إلى فئات القوالب الجديدة. يمكن للأنشطة التجارية عرض التصنيف الجديد لقوالبها في مدير واتساب، وسيكون أمامها حتى 15 مايو لمراجعتها. في حالة عدم موافقة نشاط تجاري على التصنيف، يمكنه تقديم طعن حتى 15 مايو. أي قوالب تم إنشاؤها أو تعديلها حديثًا باستخدام الإصدار 15 من واجهة Graph API أو الإصدارات الأقدم خلال الفترة من 1 أبريل إلى 1 مايو سيتم ترحيلها في 5 مايو. ومن ثم، نوصي بالبدء في استدعاء الإصدار 16 لإنشاء القوالب بدءًا من 1 أبريل. اعتبارًا من 1 مايو، سيعكس أي قالب تم إنشاؤه في مدير واتساب أو أي من إصدارات Graph API، فئات القوالب الجديدة.
• إنشاء قالب في فئات القوالب الجديدة: اعتبارًا من 1 أبريل، ستتطلب جميع القوالب التي تم إنشاؤها في الإصدار 16 من Graph API ومدير واتساب، التحقق من صحة الفئة للموافقة عليها. قد يتم رفض أي قوالب تم إنشاؤها أو تعديلها حديثًا إذا اكتشف واتساب أن الفئة المحددة غير صحيحة. سيوضح سبب الرفض أن الفئة المحددة لا تتطابق مع محتوى القالب، وفق إرشادات القوالب. يمكن للأنشطة التجارية بعد ذلك اختيار تعديل اختيار الفئة وإرسالها مرة أخرى، أو تعديل القالب أو الطعن في القرار. اعتبارًا من 1 مايو، ستتطلب القوالب المنشأة حديثًا ذات المتغيرات عينات مُضمّنة. اعتبارًا من 1 يونيو، سيتم فرض رسوم على الأنشطة التجارية استنادًا إلى بطاقات أسعار جديدة حسب فئة القالب.

منصة واجهة Messenger API

نعمل على تبسيط الإشعارات المتكررة عن طريق إزالة خيار تحديد معدل تكرار الرسائل بدءًا من الإصدار 16. لمزيد من المعلومات، راجع سجل التغييرات لمنصة Messenger.

حالات إيقاف استخدام إصدار API:

كجزء من مخطط تعيين الإصدارات على فيسبوك لواجهة Graph API وAPI التسويق، يُرجى ملاحظة حالات إيقاف الاستخدام القادمة:

واجهة Graph API

• 23 فبراير 2023: سيتم إيقاف واجهة Graph API بالإصدار 9.0 وإزالتها من المنصة
• 8 يونيو 2023: سيتم إيقاف استخدام واجهة Graph API بالإصدار 10.0 وإزالتها من المنصة
• 14 سبتمبر 2023: سيتم إيقاف استخدام واجهة Graph API بالإصدار 11.0 وإزالتها من المنصة

واجهة API التسويق

• 25 أبريل 2023: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 14.0 وإزالتها من المنصة

لتجنب تعطُل نشاطك التجاري، نوصي بترحيل كل الاستدعاءات إلى أحدث إصدار من API الذي تم طرحه اليوم.

مجموعة SDK لمنصة فيسبوك

كجزء من مخطط الإيقاف لمدة عامين لمجموعات SDK المنصة، يُرجى ملاحظة حالات إيقاف الاستخدام والإلغاء القادمة:

• يونيو 2023: سيتم إنهاء العمل بمجموعة SDK لمنصة فيسبوك بالإصدار 9.0 أو الإصدارات الأقدم
• أكتوبر 2023: سيتم إنهاء العمل بمجموعة SDK لمنصة فيسبوك بالإصدار 11.0 أو الإصدارات الأقدم
• فبراير 2024: سيتم إنهاء العمل بمجموعة SDK لمنصة فيسبوك بالإصدار 12.0 أو الإصدارات الأقدم