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

٢٣ يناير ٢٠٢٤بواسطة‏‎Mohamed Amr Abouelhassan‎‏

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

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

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

تمكين الاستهداف التفصيلي باستخدام Advantage لكل أهداف وتحسينات الحملات الإعلانية

في إطار جهودنا المتواصلة لمساعدة المعلنين على تحسين الأداء، فإننا نعمل على توسيع نطاق توفُّر منتج الاستهداف التفصيلي باستخدام Advantage الخاص بنا ليشمل جميع أهداف وتحسينات الحملة الإعلانية.

يُعَد الاستهداف التفصيلي باستخدام Advantage جزءًا من مجموعة منتجات Advantage التي تستفيد من تكنولوجيا الأتمتة وتعلُّم الآلة المتقدمة للمساعدة على تحسين أداء الحملة الإعلانية للمعلن. يمكن أن يساعد الاستهداف التفصيلي باستخدام Advantage تحديدًا على تحسين أداء الحملة الإعلانية من خلال السماح لنظامنا بالوصول إلى مجموعة أكبر من الأشخاص الذين تم تحديدهم في تحديدات الاستهداف التفصيلي الأولية للمعلن، في حال توقع نظامنا أنه يُحتمل أن يؤدي ذلك إلى تحسين الأداء.

سنطرح التغييرات التالية للمعلنين والشركاء الذين يستخدمون واجهة API التسويق في 23 يناير 2024:

سيتوفر الآن للحملات الإعلانية التي تم تحسينها من أجل زيادة مرات الظهور أو مشاهدات الفيديو أو الوصول أو التفاعل أو تحسين معدل تذكُّر الإعلان خيار الاشتراك في الاستهداف التفصيلي باستخدام Advantage.
سيتم تطبيق الاستهداف التفصيلي باستخدام Advantage للحملات الإعلانية التي تم تحسينها من أجل تجميع بيانات العملاء المحتملين تلقائيًا مع توفُّر خيار إلغاء الاشتراك.
- يُرجى العلم أنه سيتم تشغيل خيار الاشتراك للحملات الإعلانية/المجموعات الإعلانية الجديدة والمكررة، ويمكنك استخدام زر التشغيل هذا لإلغاء الاشتراك إذا كنت ترغب في ذلك.
سيتم تطبيق الاستهداف التفصيلي باستخدام Advantage للحملات الإعلانية التي تم تحسينها من أجل النقرات على الرابط أو مشاهدات الصفحة المقصودة تلقائيًا دون أي خيار لإلغاء الاشتراك.

فيما يتعلق بالمعلنين والشركاء الذين يستخدمون واجهة API التسويق، ستشكل هذه التغييرات تغييرًا جذريًا. بدءًا من 23 يناير 2024، يمكن للمطورين بدء تنفيذ تغييرات على الرمز البرمجي، وسيتوفر لهم مهلة حتى 22 أبريل 2024 لإجراء تحديثات. وسيتم طرح هذا التغيير في الإصدار 19 الجديد لواجهة API.

<Impacted endpoints>

نوع الطلب	نقطة النهاية	التغييرات
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	لن يتم قبول حقل "targeting_optimization" للحملات الإعلانية التي تم تحسينها من أجل النقرات على الرابط أو مشاهدات الصفحة المقصودة. وينطبق ذلك أيضًا على التحسينات السابقة التي تم تضمينها في الاستهداف التفصيلي باستخدام Advantage مع عدم وجود خيار إلغاء الاشتراك، بما في ذلك التحويلات والقيمة وعمليات تثبيت التطبيق وأحداث التطبيق والمحادثات. يجب أن يكون حقل targeting_as_signal فارغًا أو بقيمة 0 للحملات الإعلانية التي تم تحسينها من أجل مرات ظهور الإعلان أو مشاهدات الفيديو أو الوصول أو التفاعل أو تحسين معدل تذكُّر الإعلان أو بيانات العميل المحتمل، وإلا فسيظهر خطأ.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	لن يتم قبول حقل "targeting_optimization" للحملات الإعلانية التي تم تحسينها من أجل النقرات على الرابط أو مشاهدات الصفحة المقصودة. وينطبق ذلك أيضًا على التحسينات السابقة التي تم تضمينها في الاستهداف التفصيلي باستخدام Advantage مع عدم وجود خيار إلغاء الاشتراك، بما في ذلك التحويلات والقيمة وعمليات تثبيت التطبيق وأحداث التطبيق والمحادثات. بالنسبة لجميع التحسينات الموجودة في الاستهداف التفصيلي باستخدام Advantage مع عدم وجود خيار إلغاء الاشتراك، سنقوم تلقائيًا بتعيين حقل targeting_as_signal إلى 1 أو 3 حسب مجموعة الأهداف + التحسينات.

نوع الطلب

نقطة النهاية

التغييرات

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

لن يتم قبول حقل "targeting_optimization" للحملات الإعلانية التي تم تحسينها من أجل النقرات على الرابط أو مشاهدات الصفحة المقصودة. وينطبق ذلك أيضًا على التحسينات السابقة التي تم تضمينها في الاستهداف التفصيلي باستخدام Advantage مع عدم وجود خيار إلغاء الاشتراك، بما في ذلك التحويلات والقيمة وعمليات تثبيت التطبيق وأحداث التطبيق والمحادثات.
يجب أن يكون حقل targeting_as_signal فارغًا أو بقيمة 0 للحملات الإعلانية التي تم تحسينها من أجل مرات ظهور الإعلان أو مشاهدات الفيديو أو الوصول أو التفاعل أو تحسين معدل تذكُّر الإعلان أو بيانات العميل المحتمل، وإلا فسيظهر خطأ.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

لن يتم قبول حقل "targeting_optimization" للحملات الإعلانية التي تم تحسينها من أجل النقرات على الرابط أو مشاهدات الصفحة المقصودة. وينطبق ذلك أيضًا على التحسينات السابقة التي تم تضمينها في الاستهداف التفصيلي باستخدام Advantage مع عدم وجود خيار إلغاء الاشتراك، بما في ذلك التحويلات والقيمة وعمليات تثبيت التطبيق وأحداث التطبيق والمحادثات.
بالنسبة لجميع التحسينات الموجودة في الاستهداف التفصيلي باستخدام Advantage مع عدم وجود خيار إلغاء الاشتراك، سنقوم تلقائيًا بتعيين حقل targeting_as_signal إلى 1 أو 3 حسب مجموعة الأهداف + التحسينات.

الإعلانات والمجموعات الإعلانية والحملات الإعلانية الجديدة على واجهة API التسويق التي تستخدم الأهداف الأصلية

بدءًا من الإصدار 19.0 من واجهة API التسويق، لم يَعُد من الممكن إنشاء إعلانات ومجموعات إعلانية وحملات إعلانية جديدة تستخدم الأهداف الأصلية (المدرجة أدناه) عبر نص الإعلان. ويجب تحديث الأهداف الإعلانية لتعكس أهدافنا المبسطة.

بدءًا من الإصدار 20 من واجهة API التسويق، لن يتم دعم إنشاء الإعلانات والمجموعات الإعلانية ضمن الحملات الإعلانية التي تستخدم الأهداف الأصلية. ومع ذلك، فإن أي إصدارات لواجهة API قبل الإصدار 20 (مثل الإصدار 19 والإصدار 18) ستظل تُتيح استخدام هذه الوظيفة. ولا يلزم اتخاذ إجراء فوري للإعلانات الحالية التي تستخدم الأهداف الأصلية.

الأهداف الأصلية المتأثرة

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

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

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

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

الأسئلة المتكررة

س: هل يتطلب هذا التغيير إجراء تحديث على الرمز البرمجي؟

ج: نعم، هناك العديد من استدعاءات واجهة API للإصدار 18 التي لن تعمل على الإصدار 19 (على سبيل المثال، لن يتوفر إنشاء الإعلان والمجموعة الإعلانية والحملة الإعلانية الجديدة التي تستخدم الأهداف الأصلية عبر نص الإعلان).

س: ما السلوك المتوقَّع قبل التغيير وبعده؟

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

س: ما الجدول الزمني لتنفيذ تغييرات على الرمز البرمجي؟

ج: حتى يتم إيقاف استخدام الإصدار 18.0 مؤقتًا في سبتمبر 2024.

وثائق المطوّرين الإضافية

مقالات المساعدة

PPCA (إذن الوصول إلى المحتوى العام للصفحة)

لقد تغيرت حالة استخدام البيانات التي تم جمعها باستخدام إذن الوصول إلى المحتوى العام للصفحة. لمعرفة التفاصيل، يُرجى الاطِّلاع على الرابط التالي.

طرح واجهة API الجمهور باستخدام Advantage+‎

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

نطرح اليوم ميزة جمهور باستخدام Advantage+‎ على واجهة API التسويق.

للاشتراك، قم بتعيين المعلمة target_automation ضمن Advantage_audience على القيمة 1.
لإلغاء الاشتراك، قم بتعيين المعلمة target_automation ضمن advantage_audience على القيمة 0.

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

إيقاف استخدام واجهة API مجموعات فيسبوك

تم إيقاف استخدام واجهة API مجموعات فيسبوك في الإصدار 19، وستتم إزالتها من جميع الإصدارات خلال 90 يومًا. ويتضمن هذا الإيقاف جميع الأذونات (publish_to_groups, groups_access_member_info) والميزات القابلة للمراجعة (واجهة API المجموعات) المرتبطة بواجهة API مجموعات فيسبوك.

كانت الردود الخاصة في المجموعات إحدى حالات الاستخدام الرئيسية لواجهة API المجموعات. ونسعى لطرح تغييرًا آخر في الإصدار 19 والذي سيمكن حالة الاستخدام هذه دون حاجة المطورين إلى استخدام واجهة API المجموعات على الإطلاق. وبالنسبة لمعظم مطوري الردود الخاصة، لن يتم إجراء أية تغييرات في الإصدار 19. أما بالنسبة للمطورين الذين كانوا يعتمدون على استدعاءات نقاط نهاية منشورات المجموعات من خلال واجهة API المجموعات بعد تلقي webhook الردود الخاصة، سيتعين على هؤلاء المطورون الآن التأكد من أنهم يستخدمون رمز وصول الصفحة لهذه الطلبات.

يمكن للمطورين غير المتأكدين إذا ما كانت نقاط النهاية الخاصة بهم تستخدم الأذونات القديمة التحقق من ذلك عن طريق اختبار نقاط النهاية في الإصدار 19.0

تغييرات واجهة API رؤى الصفحة - إيقاف استخدام أدوات القياس

عند الترحيل من الصفحات الكلاسيكية إلى تجربة الصفحة الجديدة على فيسبوك، سنقوم بإيقاف استخدام عددًا من أدوات قياس واجهة API رؤى الصفحة. لمعرفة المزيد من المعلومات، يُرجى الاطِّلاع على هذا الرابط.

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

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

واجهة Graph API

8 فبراير 2024: سيتم إيقاف واجهة Graph API بالإصدار 12.0 وإزالتها من المنصة
28 مايو 2024: سيتم إيقاف استخدام واجهة Graph API بالإصدار 13.0 وإزالتها من المنصة
17 سبتمبر 2024: سيتم إيقاف استخدام واجهة Graph API بالإصدار 14.0 وإزالتها من المنصة

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

6 فبراير 2024: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 16.0 وإزالتها من المنصة
14 مايو 2024: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 17.0 وإزالتها من المنصة

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

مجموعة SDK من Meta للأعمال

طرح الإصدار 19 من مجموعة SDK من Meta للأعمال

سيتم نشر الإصدار 19 من مجموعة SDK من Meta للأعمال بعد وقت قصير من طرح الإصدار 19 لواجهة Graph API. وسيتضمن هذا الإصدار إصلاحات الأخطاء وترقيات التبعية وميزات جديدة، والأهم من ذلك، واجهة API مُحدثة لتتوافق مع الإصدار 19 من واجهة Graph API. ونخطط في المستقبل لطرح إصدارات من مجموعة SDK أكثر تكرارًا للتوافق مع معدل تكرار تحديثات واجهة API. وسيساهم ذلك على تمكين المطورين من البقاء في اطِّلاع بأحدث واجهات API والوظائف والميزات.

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

فبراير 2024: سيتم إيقاف الإصدار 12.0 من مجموعة Facebook SDK أو الإصدارات الأقدم

اﻹشارات:

أدوات الأعمال المنصات فيسبوك