الإصدار 9.0

واجهة Graph API

تم الطرح في 10 نوفمبر 2020 | متوفر حتى 23 فبراير 2023 | منشور المدونة

المجموعات

نقاط النهاية التي تم إيقاف استخدامها

تم إيقاف الاستخدام في الإصدار 9.0 والإصدارات الأحدث. وسيتم إيقاف الاستخدام في كل الإصدارات اعتبارًا من 9 فبراير 2021.

• GET /{group-id}?fields=owner

Instagram

الإعلانات

ينطبق على الإصدار 9.0 والإصدارات الأحدث

يمكن الآن استخدام معرفات وسائط IG ومعرفات مستخدم IG مع API إعلانات Instagram لإنشاء الإعلانات. ولمزيد من المعلومات، يمكنك الرجوع إلى إدخال سجل تغييرات API إعلانات Instagram.

الرؤى

ينطبق على الإصدار 9.0 والإصدارات الأحدث. وسينطبق على جميع الإصدارات اعتبارًا من 9 مايو 2021.

تتوافق الآن قيم follower_count لدى مستخدم IG بشكل أوثق مع القيم المقابلة لها والمعروضة في تطبيق Instagram. بالإضافة إلى ذلك، تُرجع قيم follower_count الآن البيانات المسجلة ضمن نطاق 30 يومًا كحدٍ أقصى بدلاً من عامين.

API التسويق

تم الطرح في 10 نوفمبر 2020 | متوفر حتى 25 أغسطس 2021 | منشور المدونة

قواعد تخصيص الأصول

نقاط النهاية التي تم إيقاف استخدامها

تم إيقاف الاستخدام في الإصدار 9.0 والإصدارات الأحدث.

• GET /{asset_customization_rule_id}/

ملاحظة: لا يزال بإمكانك الاستعلام عن قواعد تخصيص الأصول عبر الحقل asset_feed_spec في عقدة تصميم الإعلان.

عروض الأسعار

إيقاف استخدام استراتيجية عرض الأسعار

ينطبق على الإصدار 9.0 والإصدارات الأحدث

تم إيقاف استخدام استراتيجية عرض الأسعارtarget_cost. بدءًا من الإصدار 9.0، لن يعد بإمكانك إنشاء مجموعات إعلانية أو حملات إعلانية أو تحديثها باستخدام هذا الإعداد. وبدلاً من ذلك، نوصي باستخدام استراتيجية عرض الأسعار بحد أقصى للتكلفة.

إيقاف استخدام خيار الفوترة والتحسين

ينطبق على الإصدار 9.0 والإصدارات الأحدث

بدءًا من الإصدار 9.0، سيتم إيقاف استخدام فوترة التكلفة لكل إجراء في إعلانات التطبيق، ولن تتمكّن من تعيين حدث الفوترة وهدف التحسين على APP_INSTALLS. وبدلاً من ذلك، نوصي باستخدام أحداث فوترة impression.

لا يزال بإمكانك تحديد APP_INSTALLS ضمن billing_event أو optimization_goal، ولكن ليس كلاهما معًا.

النشاط التجاري

تقييدات الوصول إلى نقطة النهاية

تنطبق على كل الإصدارات.

يقتصر الوصول إلى نقاط النهاية التالية مؤقتًا على التطبيقات التي استعلمت عنها خلال آخر 90 يومًا:

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

API الكتالوج

مجموعات المنتجات

ينطبق على الإصدار 9.0 والإصدارات الأحدث. وسينطبق على كل الإصدارات اعتبارًا من 9 فبراير 2021.

بشكل افتراضي، لم يعد بإمكان نقطة النهاية DELETE /{product_set_id} حذف مجموعات المنتجات أثناء استخدامها في الإعلانات النشطة أو مجموعات المتاجر أو الاستخدامات الأخرى. ولتجاوز هذا السلوك، يمكنك تضمين المعلمة allow_live_product_set_deletion=true الجديدة في الطلب.

API إعلانات Instagram

ينطبق على الإصدار 9.0 والإصدارات الأحدث

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

أصبح بإمكان نقاط النهاية التالية الآن إرجاع معرف مستخدم Instagram (مستخدم IG)، إذا كان متوفرًا:

• GET /<ad_account_id>/connected_instagram_accounts
• GET /<business_id>/instagram_business_accounts
• GET /<ad_creative_id>

أصبحت نقاط النهاية التالية الآن تقبل معرف وسائط Instagram (وسائط IG) ومعرف مستخدم Instagram (مستخدم IG) كمعلمة:

• POST /<ad_account_id>/adscreatives
• POST /<ad_account_id>/ads

أصبحت نقطة النهاية التالية الآن تقبل معرف وسائط Instagram (وسائط IG) كمعلمة:

• POST /<ad_account_id>/advideos

أصبح بإمكان هذا الحقل الآن إرجاع معرف مستخدم Instagram (مستخدم IG)، إذا كان متوفرًا:

• GET /<page-id>?fields=connected_page_backed_instagram_account

إعلانات تجميع بيانات العملاء المحتملين

استرداد بيانات العملاء المحتملين للتطبيقات في وضع التطوير

ينطبق على الإصدار 9.0 والإصدارات الأحدث. وسينطبق على كل الإصدارات اعتبارًا من 9 فبراير 2021.

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

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