Introducing Graph API v22.0 and Marketing API v22.0
نطرح اليوم Graph API بالإصدار 22.0 وAPI التسويق بالإصدار 22.0. كجزء من هذا الإصدار، نسلط الضوء أدناه على التغييرات التي نعتقد أنها ذات صلة بالأجزاء التي تخص مجتمع المطوّرين لدينا. تتضمن هذه التغييرات إعلامات وتحديثات المنتجات وإشعارات حول حالات إيقاف الاستخدام على عمليات دمج التطبيقات ذات الصلة مع منصتنا.
للحصول على قائمة كاملة بكل التغييرات وتفاصيل حولها، يُرجى زيارة سجل التغييرات.
التحديثات العامة
تغييرات واجهة API التسويق بالإصدار 22 على استخدام الجماهير المخصصة لقائمة العملاء في الحملات الإعلانية للإسكان والتوظيف والمنتجات والخدمات المالية (بما في ذلك الائتمان)
ينطبق هذا على الإصدار "22.0+" وسيتم تطبيقه على جميع الإصدارات في مارس 2025
بعض الجماهير المخصصة لقائمة العملاء لن تكون مؤهلة للاستخدام في الحملات الإعلانية للإسكان والتوظيف والمنتجات والخدمات المالية (بما في ذلك الائتمان). تعرَّف على المزيد حول التحديث هنا وإذا ما كانت التقييدات تنطبق عليك. بالإضافة إلى ذلك، ستتم إضافة الحقل is_sac_cfca_terms_certified إلى مستوى المجموعة الإعلانية، اطَّلِع على هذا المثال. سيُطلب منك استخدام هذا الحقل للتأكيد على أن أي جماهير مخصصة لقائمة عملاء يتم استخدامها في مجموعة إعلانية خاصة بالحملات الإعلانية الخاصة بالإسكان والتوظيف والمنتجات والخدمات المالية (بما في ذلك الائتمان) تتوافق مع شهادة CLCA الخاصة بـ Meta. بدءًا من أوائل أبريل 2025، قد يتم إيقاف الحملات الإعلانية/المجموعات الإعلانية الحالية التي تستخدم جماهير مخصصة من قائمة العملاء لا تتَّبِع المتطلبات مؤقتًا. في حالة حدوث ذلك، ستظهر لك أخطاء في مدير الإعلانات وواجهة API التسويق تتضمن تعليمات.
ستتأثر نقاط النهاية التالية:
واجهة API الجمهور المخصص الإصدار 22
اعتبارًا من 6 يناير 2025، يمكنك استخدام الحقل is_eligible_for_sac_campaigns الجديد لتحديد إذا ما كان من الممكن استخدام جمهور مخصص في المجموعات الإعلانية الخاصة بالحملات الإعلانية للفئة الإعلانية الخاصة. يجب توفير special_ad_categories وspecial_ad_category_countries المخصصة لحملة الفئة الإعلانية الخاصة التي ستستخدم الجمهور، بالإضافة إلى ad_account_id الذي سيستخدم الجمهور لإنشاء المجموعة الإعلانية أو تعديلها.
ستتأثر نقاط النهاية التالية:
الوصول إلى الأشخاص المهتمين داخل المدن والمناطق المحددة
يسعدنا الإعلان عن إطلاق ميزة جديدة لاستهداف الموقع تساعد المعلنين على تعزيز الأداء من خلال التوسع خارج المدن أو المناطق المستهدفة؛ مما يمنح نظام الإعلانات لدينا المرونة لعرض الإعلانات للأشخاص الذين أبدوا اهتمامهم بموقع معين.
تعمل هذه الميزة على توسيع ميزة استهداف الموقع الحالية لدينا داخل البلد نفسه، من خلال تمكينك من الوصول إلى الأشخاص الذين أظهروا نية السفر إلى المدن والمناطق التي تستهدفها أو إجراء عمليات شراء فيها أو أظهروا اهتمامًا عامًا بها.
أثناء الاختبار، شهد العملاء الذين استخدموا ميزة استهداف الموقع الجديدة انخفاضًا بنسبة 6.7% في التكلفة لكل نتيجة.
لمزيد من المعلومات، يُرجى النقر هنا.
عمليات إيقاف الاستخدام والتغييرات العاجلة
استبدال نقاط النهاية الخاصة بمستخدم Instagram ووسائط Instagram والعناصر الدوّارة على Instagram وتعليقات Instagram بنقاط النهاية الخاصة بمستخدم IG وسائط IG وتعليقات IG
نحن بصدد إجراء تغييرات على واجهة Instagram Graph API وواجهة API التسويق لتسهيل الأمر على المطوّرين لإنشاء الحلول للأنشطة التجارية. في إطار هذه التغييرات، سنقوم بإيقاف دعم عناصر مستخدم Instagram ووسائط Instagram والعناصر الدوّارة على Instagram والتعليقات على Instagram في واجهة Graph API بالإصدار 22 لصالح عناصر مستخدم IG ووسائط IG الحالية التي تتضمن العناصر الدوّارة وتعليق IG. لقد أضفنا أيضًا وظائف لهذه العناصر الحديثة لتوفير التكافؤ لمعظم حالات الاستخدام.
سيكون أمام المطوّرين حتى 21 يناير 2026 لتحديث استخدامهم لنقاط النهاية المتأثرة في واجهة API التسويق، وحتى 21 أبريل 2025 لتحديث استخدامهم لنقاط النهاية المتأثرة في واجهة Graph API. إذا كنت تقوم بتحديث إصدارات واجهة Graph API تلقائيًا في استدعاءات واجهة API الخاصة بك، نوصي بمراجعة هذه التغييرات حيث إنها تنطبق فورًا على المطوّرين الذين يستخدمون واجهة Graph API بالإصدار 22.
راجِع مدونة المطوّرين لمزيد من التفاصيل حول هذا التغيير، بما في ذلك النقاط التي يتم تغييرها، وحالات الاستخدام التي لم تَعُد مدعومة، والجدول الزمني لتطبيق التغييرات.
إزالة استبعادات الاستهداف التفصيلي
كجزء من جهودنا المستمر�� لمساعدة المعلنين على تحسين الأداء، نحن بصدد إزالة استبعادات الاستهداف التفصيلي. كجزء من هذه العملية، سنستمر في دعم القدرة على استبعاد جهات العمل ضمن عناصر التحكم في الجمهور على مستوى الحساب. لمزيد من المعلومات حول عناصر التحكم في الحساب، يُرجى الاطِّلاع هنا.
نعتقد أن هذا التغيير سيساعد على تحسين أداء الحملات الإعلانية. أظهر اختبار لأحد المعلنين أن متوسط التكلفة لكل تحويل كان أقل بنسبة 22.6% عند عدم استخدام حالات استبعاد الاستهداف التفصيلي مقارنةً باستخدام عمليات استبعاد الاستهداف التفصيلي.
نتيجةً لهذا التغيير، سيتم إلغاء الجماهير المخصصة في حقل الاستبعادات. لا يزال بإمكانك الاستمرار في استخدام استبعادات الجماهير المخصصة عن طريق استخدام حقل excluded_custom_audiences بدلاً من ذلك.
بدءًا من 21 يناير 2025، يمكن للمطوّرين بدء تنفيذ تغييرات الرمز البرمجي، وسيتوفر لهم حتى 21 أبريل 2025 لإجراء هذه التحديثات. سيتم إصدار هذا التغيير بالإصدار 22. يُرجى الرجوع إلى مدونة المطوّرين للحصول على قائمة بنقاط النهاية المتأثرة المتعلقة بهذا التغيير.
إيقاف استخدام حزمة التحسينات القياسية من واجهة API التسويق
تأثيرات واجهة API التسويق بالإصدار 22.0 في تحسينات تصميم Advantage+
في هذا الإصدار الجديد من واجهة API التسويق، سنوقف استخدام حزمة التحسينات القياسية لتصميم Advantage+، مع استبدالها باشتراك تحسينات التصميم الفردية. يمكنك التعرُّف على المزيد حول تصميم Advantage+ هنا.
يمكنك هنا التعرُّف على مزيد من المعلومات المتعلقة بمجتمع المطوّرين، ويمكن العثور على تفاصيل إضافية في وثائق المطوّرين لدينا من هنا.
سيتم إيقاف دعم التحسينات القياسية مع نقاط النهاية هذه:
- POST /{ad_account_id}/adcreatives
- POST /{ad_account_id}/ads
- GET /{ad_id}/previews
مقدمة عن أداة قياس المشاهدات على Instagram وإيقاف دعم أداتَي القياس مرات ظهور الإعلان ومرات التشغيل
لمواصلة تحقيق التوافق بين وظائف واجهة Instagram API ووظائف تطبيق Instagram، نحن بصدد طرح أداة قياس "المشاهدات" في جميع إصدارات واجهة API لكل من رؤى الوسائط والمستخدم. فيما يتعلق برؤى الوسائط، فإن كائنات الموجز والقصص وريلز ستُرجِع المشاهدات. بالنسبة لرؤى المستخدم، ستدعم واجهة API أداة قياس "المشاهدات" مع تقسيمات متعددة الأبعاد حسب نوع المتابع ونوع منتج الوسائط.
بالإضافة إلى ذلك، سيتم إيقاف استخدام أدوات القياس التالية بدءًا من الإصدار 22:
- مرات التشغيل (رؤى الوسائط): عدد مرات بدء تشغيل مقاطع ريلز بعد احتساب مرة الظهور بالفعل.
- clips_replays_count (رؤى الوسائط): عدد مرات بدء تشغيل مقطع ريلز الخاص بك مرة أخرى بعد التشغيل الأولي له. يتم تعريف هذا على أنه مرات إعادة التشغيل لمدة دقيقة واحدة أو أكثر في جلسة مقطع ريلز نفسها.
- ig_reels_aggregated_all_plays_count (رؤى الوسائط): عدد مرات بدء تشغيل مقطع ريلز أو إعادة تشغيله بعد احتساب مرات الظهور بالفعل.
- مرات ظهور الإعلان (رؤى الوسائط والمستخدمين): إجمالي عدد مرات مشاهدة عنصر وسائط Instagram.
لن يتم إيقاف استخدام أداة قياس رؤى الوسائط "مرات الظهور" سوى للوسائط التي يتم إنشاؤها في 2 يوليو 2024 أو بعد ذلك. بالنسبة ��لوسائط التي تم إنشاؤها قبل هذا التاريخ، ستستمر واجهة API في إرجاع القيم كالمعتاد عبر جميع الإصدارات.
يمكنك العثور على مزيد من المعلومات في وثائق المطوِّرين حول رؤى مستخدم Instagram ورؤى وسائط Instagram. يُرجى تشجيع المطوّرين على إجراء التحديثات بحلول 21 أبريل 2025 لتجنب المشكلات.
مجموعة SDK للأعمال من Meta
طرح إصدار 22 من مجموعة SDK للأعمال من Meta
سيتم نشر الإصدار 22 من مجموعة SDK للأعمال من Meta بعد وقت قصير من طرح الإصدار 22 لواجهة Graph API. وسيتضمن هذا الإصدار إصلاحات الأخطاء وترقيات التبعية وميزات جديدة، والأهم من ذلك، واجهة API مُحدثة لتتوافق مع الإصدار 22 من واجهة Graph API.
كجزء من مخطط الإيقاف لمدة عامين لمجموعات SDK المنصة، يُرجى ملاحظة حالات إيقاف الاستخدام والإلغاء القادمة:
- مايو 2025: سيتم إيقاف الإصدار 17.0 من مجموعة SDK لمنصة فيسبوك أو الإصدارات الأقدم.
حالات إيقاف استخدام إصدار API:
كجزء من مخطط تعيين الإصدارات على فيسبوك لواجهة Graph API وواجهة API التسويق، يُرجى ملاحظة حالات إيقاف الاستخدام القادمة:
واجهة Graph API
- 14 مايو 2025: سيتم إيقاف استخدام واجهة Graph API بالإصدار 16 وإزالتها من المنصة
- 12 سبتمبر 2025: سيتم إيقاف استخدام واجهة Graph API بالإصدار 17 وإزالتها من المنصة
واجهة API التسويق
- 4 فبراير 2025: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 19.0 وإزالتها من المنصة
- 6 مايو 2025: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 20.0 وإزالتها من المنصة
لتجنُّب تعطُل النشاط التجاري، نوصي بترحيل كل الاستدعاءات إلى أحدث إصدار من واجهة API الذي تم طرحه اليوم.
