التعرُّف على واجهة Graph API بالإصدار 25.0 وواجهة API التسويق بالإصدار 25.0

فيما يلي أبرز تغييرات واجهة Graph API/واجهة API التسويق الجديدة للإصدار 25. يُرجى الرجوع إلى سجل التغييرات الخاص بنا للحصول على قائمة كاملة بالتغييرات والتفاصيل.

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

واجهة Graph API: طرح أداة قياس "مشاهد الصفحة"

بحلول نهاية يونيو 2026، نخطط لطرح أداة قياس مشاهد الصفحة في واجهة Graph API. تهدف أداة قياس المشاهدين إلى استبدال أداة قياس الوصول القديمة وتوفير قياس متسق عبر المنصات (فيسبوك وInstagram) لعدد الأشخاص الذين شاهدوا محتوى معينًا. يجب على المطوّرين بدء التخطيط لعملية الترحيل إلى أداة قياس "المشاهدين" لضمان استمرار الوصول إلى رؤى الجماهير.

ما الذي تغيّر؟

ستتوفر أدوات قياس "المشاهدين" في رؤى الصفحات ورؤى القصص

رؤى المنشور/الصفحة

• GET {page-id}/insights/page_total_media_view_unique*
• GET {post-id}/insights/post_total_media_view_unique*

رؤى القصص

• ستتم إضافة أداة قياس جديدة
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

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

تحديث شهادة Webhooks mTLS

بدءًا من 31 مارس 2026، ستوقّع Meta شهادات Webhooks mTLS باستخدام جهة إصدار شهادات مختلفة (CA) مملوكة لشركة Meta.

ما الذي يعنيه ذلك بالنسبة للمطوّرين؟

إذا تم تكوين خوادمك لطلب شهادة Webhooks mTLS والتحقق منها، فيجب عليك الوثوق بجهة إصدار الشهادات الجديدة من Meta. سيؤدي عدم تحديث مخزن الثقة قبل الموعد النهائي إلى فشل تعاون TLS، وستتوقف خوادمك عن تلقي جميع أحداث Webhooks.

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

لضمان استمرار تلقي أحداث Webhooks دون انقطاع، يجب عليك

1. تنزيل شهادة اعتماد جهة إصدار الشهادات (CA) لدى Meta: انتقِل إلى بدء استخدام أحداث Webhooks وقم بتنزيل الملف الذي يحمل اسم meta-outbound-api-ca-2025-12.pem.
   ستوقِّع جهة إصدار الشهادات (CA) على الشهادة الفرعية التي سيتم تقديمها في طلبات Webhooks.
2. إضافتها إلى مخزن الثقة: أضِف هذه الشهادة إلى مخزن الثقة إلى أي خوادم تتلقى أحداث Webhooks.
3. الحفاظ على الشهادة الحالية: يجب إضافة الشهادة الجديدة إلى مخزن الثقة بينما لا تزال الشهادة الحالية نشطة.

مهم: لا تنتظر حتى الموعد النهائي. يتعيَّن عليك إضافة الشهادة الجديدة إلى مخزن الثقة لديك فورًا لضمان الانتقال السلس في 31 مارس.

الموعد النهائي: قبل 31 مارس 2026.

أسباب هذا التغيير

تم توقيع شهادة Webhooks mTLS الحالية بواسطة جهة إصدار الشهادات (CA) لدى DigiCert. بسبب قيام DigiCert بإيقاف استخدام EKU مصادقة العميل، لا يمكن تجديد الشهادة باستخدام الشهادة الصادرة من جهة إصدار الشهادات التي تنتهي صلاحيتها في 15 أبريل 2025.

وبالتالي، سيتم توقيع شهادة Webhooks mTLS الجديدة بواسطة جهة إصدار الشهادات الداخلية لدى Meta. وستحتفظ بالاسم الشائع نفسه (client.webhooks.fbclientcerts.com) كالشهادة الحالية.

تم تحديث الوثائق العامة حول Webhooks mTLS بإشعار يتعلق بهذا التغيير. سيتم تحديث التفاصيل الفنية الكاملة الواردة في الوثائق بشكل دائم في أبريل 2026 بمجرد اكتمال الانتقال.

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

تحسين رسائل الأخطاء لواجهة API رؤى الإعلانات غير المتزامنة

نعمل باستمرار على تحسين تجربة المطورين مع واجهات API الخاصة بنا. لتوفير قدر أكبر من الشفافية وتمكين المطوّرين من تطوير تطبيقات أكثر مرونة، نقوم بتحسين إعداد تقارير الأخطاء لنقطة النهاية GET {AD_REPORT_RUN_ID}واجهة API رؤى الإعلانات غير المتزامنة.

بدءًا من إصدار 25.0 التالي من "واجهة Graph API" الذي سيتم طرحه في 18 فبراير 2026، سيتمكن المطوّرون من الوصول إلى معلومات تفصيلية حول الأخطاء عند فشل تقرير غير متزامن، مما يتيح تشخيص الأخطاء بسهولة أكبر وتحسين فعّالية عمليات دمج واجهة API الخاصة بهم. بالنسبة إلى أي مطوّرين لديهم حاليًا صلاحية الوصول إلى الحقل error_code، سيتم تغيير نوعه من uint إلى int.

ما الذي تغيّر؟

نقدم الحقول الافتراضية الجديدة التالية في استجابة نقطة النهاية GET {AD_REPORT_RUN_ID} واجهة API رؤى الإعلانات غير المتزامنة لكل التطبيقات:

• error_code: رمز الخطأ. ملاحظة: سيتم تغيير الحقل من uint إلى int لأي مطوّرين لديهم حاليًا صلاحية الوصول إليه
• error_message: رسالة تتوافق مع error_code.
• error_subcode: الرمز الفرعي المحدد للخطأ.
• error_user_title: عنوان سهل الفهم للمستخدم يوضح الرمز الفرعي للخطأ.
• error_user_msg: رسالة موجهة للمستخدم توضّح تفاصيل الرمز الفرعي للخطأ.

سيتم ملء هذه الحقول عند فشل تشغيل التقرير. نوصي بمراجعة دمج واجهة API الخاصة بك للتأكد من توافقها مع الحقول الافتراضية الجديدة في الاستجابة.

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

واجهة Graph API: إيقاف استخدام معلمة استعلام بيانات التعريف

بدءًا من الإصدار 25 من واجهة Graph API، سيتم إيقاف استخدام معلمة الاستعلام metadata=1. كانت هذه المعلمة تُستخدم سابقًا لإرجاع بيانات التعريف المتعلقة بحقول العقدة واتصالاتها ضمن استجابات واجهة API. ونظرًا لانخفاض استخدام هذه الميزة، سيتم إيقافها بهدف تبسيط المنصة. بعد إيقاف الاستخدام، سيتم تجاهل المعلمة metadata في طلبات API.

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

ما الذي تغيّر؟

قبل (الإصدار 24 والإصدارات الأقدم):

تؤدي إضافة ?metadata=1 إلى طلب Graph API إلى إرجاع بيانات تعريف إضافية حول العقدة، بما في ذلك الحقول والاتصالات المتاحة.

بعد (الإصدار 25 أو الإصدارات الأحدث):

سيتم تجاهل المعلمة metadata=1. ستستمر الطلبات التي تتضمن هذه المعلمة في إرجاع الاستجابات القياسية دون بيانات التعريف. لن يحدث أي حالات فشل أو تغييرات عاجلة، ولن تظهر أي أخطاء في الطلبات أو يتم تعطيلها إذا كانت تتضمن metadata=1؛ فستكون المعلمة ببساطة غير فعّالة.

واجهة Graph API: إيقاف استخدام أدوات قياس مرات ظهور إعلان/وصول الصفحة

في يونيو 2026، نخطط لإيقاف استخدام أدوات قياس وصول المنشور/الصفحة، ومرات ظهور الفيديو، ومرات ظهور القصة في واجهة Graph API. لم تَعُد أدوات القياس القديمة هذه تظهر في أدوات الرؤى الخاصة بنا، ولكنها ظلت متاحة عبر واجهات API حتى الآن.

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

ما الذي تغيّر؟

سيتم إيقاف استخدام أدوات القياس التالية في يونيو 2026 لجميع إصدارات واجهة API. نوصي المطوّرين بالتحقق من سجل تغييرات واجهة Graph API للحصول على أحدث المعلومات:

وصول المنشور/الصفحة

• GET {page-id}/insights/page_impressions_unique*
• GET {page-id}/insights/page_impressions_paid_unique*
• GET {page-id}/insights/page_impressions_viral_unique*
• GET {page-id}/insights/page_impressions_nonviral_unique*
• GET {page-id}/insights/page_posts_impressions*
• GET {page-id}/insights/page_posts_impressions_unique*
• GET {page-id}/insights/page_posts_impressions_paid*
• GET {page-id}/insights/page_posts_impressions_paid_unique*
• GET {page-id}/insights/page_posts_impressions_organic_unique*
• GET {page-id}/insights/page_posts_served_impressions_organic_unique*
• GET {page-id}/insights/page_posts_impressions_viral*
• GET {page-id}/insights/page_posts_impressions_viral_unique*
• GET {page-id}/insights/page_posts_impressions_nonviral*
• GET {page-id}/insights/page_posts_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_unique*
• GET {post-id}/insights/post_impressions_paid_unique*
• GET {post-id}/insights/post_impressions_fan_unique*
• GET {post-id}/insights/post_impressions_organic_unique*
• GET {post-id}/insights/post_impressions_viral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*

مرات ظهور الفيديو

• GET {video-id}/video_insights/post_impressions_unique
• GET {video-id}/video_insights/total_video_impressions
• GET {video-id}/video_insights/total_video_impressions_unique
• GET {video-id}/video_insights/total_video_impressions_paid_unique
• GET {video-id}/video_insights/total_video_impressions_paid
• GET {video-id}/video_insights/total_video_impressions_organic_unique
• GET {video-id}/video_insights/total_video_impressions_organic
• GET {video-id}/video_insights/total_video_impressions_viral_unique
• GET {video-id}/video_insights/total_video_impressions_viral
• GET {video-id}/video_insights/total_video_impressions_fan_unique
• GET {video-id}/video_insights/total_video_impressions_fan
• GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
• GET {video-id}/video_insights/total_video_impressions_fan_paid

مرات ظهور القصة

• سيتم استبدال أداتَي قياس
• GET {stories-id}/insights/metric
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

نوصي باستخدام أدوات القياس التالية بدلاً من ذلك:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

بالنسبة تحديدًا إلى عمليات التقسيم بين الوصول المدفوع والوصول العادي، نوصي باستخدام أدوات القياس التالية، والتي توفر رؤى مماثلة إلى حد كبير:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

واجهة Graph API: إيقاف استخدام أدوات قياس المشاهدين لمدة 3 ثوانٍ

في يونيو 2026، نخطط لإيقاف استخدام أدوات قياس المشاهدين لمدة 3 ثوانٍ. لم تَعُد أدوات القياس القديمة هذه تظهر في أدوات الرؤى الخاصة بنا، ولكنها ظلت متاحة عبر واجهة Graph API حتى الآن.

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

ما الذي تغيّر؟

سيتم إيقاف استخدام أدوات القياس التالية في يونيو 2026 لجميع إصدارات واجهة API. نوصي المطوّرين بالتحقق من سجل تغييرات واجهة Graph API للحصول على أحدث المعلومات:

• GET {page-id}/insights/page_video_views_unique
• GET {post-id}/insights/post_video_views_organic_unique
• GET {post-id}/insights/post_video_views_paid_unique
• GET {post-id}/insights/post_video_views_unique
• GET {video-id}/video_insights/total_video_views_organic_unique
• GET {video-id}/video_insights/total_video_views_paid_unique
• GET {video-id}/video_insights/total_video_views_unique

نوصي باستخدام أدوات القياس التالية بدلاً من ذلك:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

بالنسبة تحديدًا إلى عمليات التقسيم بين المشاهدين لمدة 3 ثوانٍ المدفوعين والعاديين، نوصي باستخدام أدوات القياس التالية، والتي توفر رؤى مماثلة إلى حد كبير:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

واجهة API التسويق: إيقاف استخدام حملات Advantage‎ الإعلانية للتسوق (ASC) وحملات Advantage الإعلانية للتطبيقات (AAC)

يؤدي "توحيد الأتمتة" إلى تعيين الحملات الإعلانية للتطبيقات وللمبيعات ولتجميع بيانات العملاء المحتملين افتراضيًا على إعداد Advantage+‎ الأمثل الذي يستخدم الأتمتة أولاً ويُتيح للمعلنين والشركاء وصولاً مبسطًا إلى أحدث منتجات الأتمتة وأكثرها فعالية من Meta. نحن بصدد تنفيذ إيقاف استخدام تدريجي لواجهات API القديمة والترحيل إلى إعداد "توحيد الأتمتة" وAdvantage+‎ الجديدين لمطوّري واجهة API التسويق.

بدءًا من الإصدار 25.0 (في 18 فبراير 2026)، لن يكون بالإمكان إنشاء حملات Advantage‎ الإعلانية للتسوق (ASC) وحملات Advantage الإعلانية للتطبيقات (AAC) أو تحديثها باستخدام واجهة API التسويق، وسيتم تطبيق ذلك على جميع إصدارات واجهة API التسويق بعد 90 يومًا (بحلول 19 مايو 2026).

في الإصدار 26.0 (بحلول سبتمبر 2026)، سيتم إيقاف جميع حملات Advantage‎ الإعلانية للتسوق (ASC)، وحملات Advantage الإعلانية للتطبيقات (AAC) مؤقتًا.

ستظل حملات Advantage‎ الإعلانية للتسوق (ASC)، أو حملات Advantage الإعلانية للتطبيقات (AAC) التي تستخدم ميزانية العملاء الحاليين (ECBC) قابلة للتعديل حتى الإصدار 26.0، ولا تتوفر هذه الميزة مع حملات Advantage+‎ الإعلانية. يجب على المطوّرين، الذين لديهم حملة إعلانية تستخدم الحد الأقصى لميزانية العملاء الحاليين، اتخاذ إجراء باستخدام إحدى الطرق التالية لتكرار الحملات الإعلانية التي تستخدم الحد الأقصى لميزانية العملاء الحاليين قبل الإصدار 26.0:

• التكرار اليدوي: افتح حملات Advantage‎ الإعلانية للتسوق (ASC)/حملات Advantage الإعلانية للتطبيقات (AAC) الموجودة تستخدم الحد الأقصى لميزانية العملاء الحاليين في مدير الإعلانات، وسيُطلب منك "تكرار الحملة الإعلانية". هذه الخطوة بنقرة واحدة ستنشئ حملة إعلانية جديدة تُطابق إعدادات الحملة الإعلانية الحالية.
• تكرار الحملات الإعلانية التي تستخدم الحد الأقصى لميزانية العملاء الحاليين باستخدام واجهة API، استخدِم الإرشادات الواردة في وثائق المطورين لتكرار الحملات الإعلانية باستخدام واجهة API، هنا.
• طلب ترحيل مجمَّع على مستوى الحساب الإعلاني، بالنسبة إلى الشركاء المُدارين، يمكننا تنفيذ إجراء لمرة واحدة لنسخ جميع الحملات الإعلانية التي تستخدم الحد الأقصى لميزانية العملاء الحاليين في تاريخٍ متفق عليه. يُرجى التواصل مع جهة الاتصال الرئيسية الخاصة بك في Meta وتوفير معرِّفات الحسابات والتاريخ المفضل لإجراء الترحيل.

ملاحظة: يُرجى العلم أن كل عمليات تكرار الحملة الإعلانية التي تستخدم الحد الأقصى لميزانية العملاء الحاليين ستؤدي إلى الحصول على معرف حملة إعلانية جديد.

يؤثر هذا التغيير في نقاط النهاية التالية:

• POST /{campaign-id}
• POST /{campaign-id}/copies

يُرجى مراجعة وثائق المطوّرين و الأسئلة المتكررة المحدّثة للاطلاع على جميع تفاصيل هذا التغيير.

رابط وثائق المطوّرين

• وثائق المطوّرين - تجربة حملة Advantage+‎ الإعلانية للمبيعات والتطبيقات وتجميع بيانات العملاء المحتملين

رابط مقالة المساعدة بشأن الميزة

• مركز المساعدة - حملات Advantage+‎ الإعلانية
• مركز المساعدة - الفئات الإعلانية الخاصة

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

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

واجهة Graph API

• 21 مايو 2026: سيتم إيقاف استخدام واجهة Graph API بالإصدار 19 وإزالتها من المنصة.
• 24 سبتمبر 2026: سيتم إيقاف استخدام واجهة Graph API بالإصدار 20 وإزالتها من المنصة.

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