التغييرات الطارئة لعام 2025 التغييرات الطارئة على واجهة API التسويق لعام 2025.

٢٩ أكتوبر ٢٠٢٥

الرؤى تُطبَّق على جميع الإصدارات اعتبارًا من 29 أكتوبر 2025. نقدم أداة قياس الرؤى "instagram_profile_visits" والتي تعمل على قياس عدد المرات التي يزور فيها المستخدمون الملف الشخصي للمعلن على Instagram نتيجة للتفاعل مع الإعلان. يتضمن هذا النقرات على زر الدعوة لاتخاذ إجراء في الإعلان أو صورة الملف الشخصي أو اسم المستخدم الذي يؤدي مباشرةً إلى الملف الشخصي على Instagram. ستتأثر نقاط النهاية التالية: * GET /{campaign-id}/insights * GET /{ad-set-id}/insights * GET /{ad-id}/insights

٢٨ أكتوبر ٢٠٢٥

إعلانات Threads

  • Advantage+ catalog ads are now available for Threads ads. Only images and image carousels are currently supported. Slideshow, video and entry cards are not supported at this time. See Threads Advantage+ Catalog Ads for more information.

١٣ أكتوبر ٢٠٢٥

التغييرات القادمة على واجهة API رؤى الإعلانات تُطبَّق على جميع الإصدارات اعتبارًا من 12 يناير 2026. * فترات الإسناد: لن تكون بيانات فترات إسناد المشاهدة خلال 7 أيام (action_attribution_windows=7d_view) وخلال 28 يومًا (action_attribution_windows=28d_view) متوفرة بعد الآن ولن تُرجع أي بيانات * البيانات القديمة: سيكون الاحتفاظ بالبيانات القديمة لبعض الحقول والتقسيمات محدودًا، ولن تُرجع أي بيانات عند الاستعلام باستخدام start_date تتجاوز حدود فترة الاحتفاظ بها: * محدودة إلى 13 شهرًا: تشمل جميع تقسيمات الحقول unique-count (مثل unique_actions وcost_per_unique_action_type)؛ وكذلك التقسيمات بالساعة لجميع الحقول (على سبيل المثال، breakdowns=hourly_stats_aggregated_by_advertiser_time_zone) * محدودة إلى 6 أشهر: تشمل تقسيمات معدل التكرار (على سبيل المثال، breakdowns=frequency_value) * تقسيمات إنشاء نماذج المزيج التسويقي: ستقتصر تقسيمات إنشاء نماذج المزيج التسويقي (على سبيل المثال، breakdowns=mmm) على الوظائف غير المتزامنة. ستتأثر نقاط النهاية التالية: * GET /{ad-account-id} * GET /{campaign-id} * GET /{ad-set-id} * GET /{ad-id} * POST /{ad-account-id} * POST /{campaign-id} * POST /{ad-set-id} * POST /{ad-id}

٩ أكتوبر ٢٠٢٥

المواضع #### البريد الوارد في Messenger تُطبَّق على الإصدار 23.0 والإصدارات الأحدث. وسينطبق على جميع الإصدارات في 11 نوفمبر 2025. لن يتوفر موضع البريد الوارد في Messenger (messenger_home) بعد الآن للاستهداف عند إنشاء الإعلانات. ستتأثر نقاط النهاية التالية: * GET /{ad-account-id}/adsets * POST /{ad-account-id}/adsets * GET /{ad-set-id}?fields=targeting

٦ أكتوبر ٢٠٢٥

إعلانات Threads

١٨ سبتمبر ٢٠٢٥

الفئات الإعلانية الخاصة #### القضايا الاجتماعية والانتخابات والسياسة تُطبَّق على جميع الإصدارات. اعتبارًا من 6 أكتوبر 2025، واستجابةً للوائح الاتحاد الأوروبي المتعلقة بالشفافية واستهداف الإعلانات السياسية (TTPA)، لن يُسمح بعد الآن بالإعلانات المتعلقة بالقضايا الاجتماعية والانتخابات والسياسة في الاتحاد الأوروبي. تعرَّف على المزيد. ستتأثر نقاط النهاية التالية: * POST /{ad_account_id}/campaigns * POST /{ad_account_id}/ads * POST /{ad_account_id}/adsets * POST /{ad_account_id}/adcreatives

٢ سبتمبر ٢٠٢٥

السعر الخاص المباشر في واجهة API الكتالوج

ينطبق على ‏‎v23.0+‎‏

يمكن للبائعين مزامنة live_special_price مع product_item في الكتالوجات التي تشير إلى سعر ترويجي خاص مباشر فقط فيما يتعلق بمنتج من المنتجات. تتضمن قيمة السعر رقمين إضافيين للسنتات (على سبيل المثال: استخدم "100" لتمثل قيمة 1 أو "599" لتمثل قيمة 5.99).

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

١٩ أغسطس ٢٠٢٥

الجماهير #### الاستهداف الأساسي سينطبق على جميع الإصدارات اعتبارًا من 19 أغسطس 2025. تُعد رموز "COMSCORE_MARKET" مصدرًا جغرافيًا جديدًا للتسويق في استهداف الموقع لإنشاء مجموعة إعلانية. يمكن الآن استخدام أسواق Comscore كمصدر إلى جانب مناطق DMA (مناطق السوق المخصصة) الموجودة. ستتأثر نقاط النهاية التالية: * POST /{ad-account-id}/adsets ### الاستهداف بمعايير البحث سينطبق على جميع الإصدارات اعتبارًا من 19 أغسطس 2025. سيتم إرجاع رموز "COMSCORE_MARKET" إلى جانب مناطق DMA (مناطق السوق المخصصة) عند استخدام الاستهداف بمعايير البحث. ستتأثر نقاط النهاية التالية: * GET /search

١٨ أغسطس ٢٠٢٥

مشاركة ميزانية المجموعة الإعلانية

ينطبق على ‏‎v21.0+‎‎‏

ستتم إضافة الحقل is_adset_budget_sharing إلى واجهة API إنشاء حملة إعلانية. يمكن للمعلنين تمكين [مشاركة ميزانية المجموعة الإعلانية] (https://www.facebook.com/business/help/1388266028979935?ref=search_new_0) من خلال تعيين هذا الحقل إلى صواب. مع مشاركة ميزانية المجموعة الإعلانية، يمكن للمعلنين الآن مشاركة ما يصل إلى 20% من ميزانيتهم مع مجموعات إعلانية أخرى في الحملة الإعلانية نفسها.

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

١٥ أغسطس ٢٠٢٥

إعلانات Threads

١ مايو ٢٠٢٥

إضافة حقل جديد بنوع دلالي للقيمة إلى الكائن الذي يتم ترويجه

ينطبق على ‏‎v22.0+‎‎‏

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

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

٣١ مارس ٢٠٢٥

الجماهير تُطبَّق على جميع الإصدارات اعتبارًا من 31 مارس 2025. * تمت إضافة موضع "الإشعار" إلى "facebook_positions" في استهداف الموضع وتخصيص أصول الموضع.

١٠ مارس ٢٠٢٥

تغيير قادم على واجهة API رؤى الإعلانات يُطبَّق على جميع الإصدارات اعتبارًا من 10 يونيو 2025. في 10 يونيو 2025، سيتغير سلوك واجهة API رؤى الإعلانات بطريقتين: * لتقليل مستويات التباين مع مدير الإعلانات من Meta، سيتم تجاهل المعلمتين "use_unified_attribution_setting" و"action_report_time"، وستحاكي واجهة API استجابات إعدادات مدير الإعلانات من Meta. لمعرفة المزيد، يمكنك زيارة وثائق المطوّرين هنا. * لتحسين الأداء العام لواجهة API، لن يتم إرجاع "reach" بعد الآن للاستعلامات التي تطبق التقسيمات وتستخدم تواريخ "start_date" تزيد عن 13 شهرًا؛ ويمكن للمطوّرين الاستفادة من الوظائف غير المتزامنة لطلب مثل هذه البيانات. لمعرفة المزيد، يمكنك زيارة وثائق المطوّرين هنا.

١٤ يناير ٢٠٢٥

الفئات الإعلانية الخاصة *تُطبَّق على جميع الإصدارات. وفقًا لم تم طرحه في أكتوبر 2024، يتوفر إدخال جديد للفئة الإعلانية الخاصة لحقل "special_ad_categories". هذا الإدخال هو "FINANCIAL_PRODUCTS_SERVICES" والذي يمثل فئة [المنتجات والخدمات المالية] (https://www.facebook.com/business/help/510724041294968)، وسيحل محل الإدخال "CREDIT" اعتبارًا من 14 يناير 2025. يُعد هذا التغيير جزءًا من توسيع الفئات الإعلانية الخاصة لتشمل المنتجات والخدمات المالية في أوائل عام 2025. تعرف على المزيد حول التحديث هنا أو يمكنك زيارة صفحة موارد مستندات المطوّر هنا. لن يُعد الإدخال "CREDIT" اختيارًا صالحًا للفئة الإعلانية الخاصة بعد إيقافه في 14 يناير 2025. يجب على المطوّرين الترحيل إلى استخدام إدخال "FINANCIAL_PRODUCTS_SERVICES" قبل إيقاف الاستخدام لتجنب انقطاع إعداد الحملة. إذا تم إنشاء إعلان بفئة CREDIT بعد 14 يناير، فسيفشل استدعاء API، وسيتم حظره مع عرض رسالة خطأ. يوصى بوضع الأولوية لهذا التحديث قبل حلول تاريخ إيقاف الاستخدام بوقت كافٍ للحد من مشكلات انقطاع الخدمة لدى عملائك. يجب على الأنشطة التجارية التي حددت الإدخال "FINANCIAL_PRODUCTS_SERVICES" الامتثال إلى قيود الجماهير، على غرار فئتي الإسكان والتوظيف. ستتأثر نقاط النهاية الآتية: * POST /{campaign-id}