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

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

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

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

إيقاف استخدام إستراتيجيات الإعلانات

تم إيقاف استخدام منتج الإصدار التجريبي لإستراتيجيات الإعلانات منذ 28 أكتوبر 2022. نتيجة لذلك، نحن بصدد إيقاف استخدام الحقلين ad_strategy_id وad_strategy_group_id في نقطة نهاية الحملات الإعلانية بالتزامن مع طرح الإصدار 17.0 من API التسويق.

إيقاف استخدام واجهة API التحويلات بلا اتصال

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

بدءًا من الإصدار 17 من Graph API والأحدث والذي تم طرحه في 23 مايو 2023، لن تدعم واجهة API التحويلات بلا اتصال بعد الآن الأحداث بلا اتصال. نوصي المعلنين الذين يستخدمون عمليات دمج واجهة API التحويلات بلا اتصال بتحويل الدمج إلى دمج واجهة API التحويلات وعدم تحديث واجهة API التحويلات بلا اتصال حتى يتم إجراء ذلك بنجاح.

إيقاف استخدام إنشاء هدف قديم

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

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

حقل التحسينات القياسية لتصميم Advantage+ المطلوب

في وقت سابق من هذا العام، طرحنا حقل التحسينات القياسية لتصميم Advantage+ على API التسويق. بدءًا من 23 مايو 2023، سيتعين على مستخدمي API التسويق تحديد تسجيل الإعلان في التحسينات القياسية لتصميم Advantage+ عن طريق توفير 'OPT_IN' أو 'OPT_OUT' في الحقل 'enroll_status'. إذا تركت الحقل فارغًا، فسيظهر للمستخدم خطأ وستتم مطالبته بإكمال الحقل. للتعرف على المزيد حول التحسينات القياسية في تصميم Advantage+ على API التسويق، يُرجى عرض منشور مدونة المطوّرين هذا.

ستتأثر نقاط النهاية التالية

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

إيقاف استخدام إعلانات كتالوج Advantage+ للبث

بالتزامن مع طرح الإصدار 17.0 من API التسويق، سيتم إيقاف استخدام كتالوج إعلانات كتالوج Advantage+ للبث (A+CA للبث). تُعد إعلانات كتالوج التجارة هي البديل الموصى به لكتالوج A+CA للبث. فيما يلي دليل إعداد كتالوج التجارة. سيتم إيقاف استخدام نقاط النهاية التالية:

• إنشاء كتالوج A+CA للبث: عنصر الربط owned_product_catalogs الذي يتضمن المجال media_titles
• تحميل موجز عنوان الوسائط: عنصر الربط product_feeds لكتالوج A+CA للبث
• إنشاء عنصر عنوان وسائط: عنصر الربط media_titles لكتالوج A+CA للبث
• إنشاء حملة إعلانية باستخدام كتالوج A+CA للبث: عنصر ربط الحملات الإعلانية بكتالوج DAS إما على L3 أو L2 أو L1

في 21 أغسطس 2023، سيتم تطبيق التغييرات أعلاه على كل إصدارات API التسويق، وسنعمل على إيقاف كل الحملات الإعلانية مؤقتًا التي لديها كتالوجات A+CA للبث مرفقة في المستوى L3 أو L2 أو L1.

إيقاف استخدام واجهة API المقالات الفورية

نظرًا إلى أنه قد تم إيقاف استخدام منتج المقالات الفورية في 20 أبريل 2023، فسيتم الآن إيقاف استخدام API التي تسمح للناشرين بإدارة المقالات الفورية.

إنفاذ إذن إدارة الأعمال على حسابات المستخدمين

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

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

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

Graph API

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

API التسويق

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

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

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

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

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