الإصدار 13.0

واجهة Graph API

تم الطرح في 8 فبراير 2022 | متوفر حتى سيتم تحديده |منشور المدونة

واجهة Instagram Graph API

وسائط IG

سيكون الإصدار 13 الإصدار الأخير الذي يسمح video_title بطلبات الحقل في وسائط IG بدون إرجاع أي خطأ. وكتذكير، يكون سلوك API الحالي المحدد في منشور مدونة بتاريخ 5 أكتوبر 2021 على النحو التالي:

• يعمل الحقل media_product_type على إرجاع FEED لكل الإصدارات
• يتم حذف الحقل video_title من الاستجابات لكل الإصدارات
• الحقلان comments وmentions لأحداث Instagram Webhooks مدعومان لكل الإصدارات

ينطبق السلوك أعلاه على كل وسائط IG، بما في ذلك وسائط IG المنشأة بواسطة تطبيق Instagram TV، بغض النظر عن تاريخ الإنشاء.

رؤى المستخدم

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

لم تعد أدوات قياس رؤى مستخدم IG التالية تدعم المعلمتين since وuntil ولن تتضمن الاستجابات خاصية JSON end_time.

• audience_city
• audience_country
• audience_gender_age
• audience_locale

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

تم الطرح في 8 فبراير 2022 | متوفر حتى 25 يناير 2023 | منشور المدونة

تصميم الإعلان

إعلانات تخصيص أصول المواضع

ينطبق ذلك على الإصدار 13.0 والإصدارات الأحدث.

ستسمح العقدة asset_feed_spec لنقطة النهاية POST /{ad-account-id}/adcreatives بإنشاء إعلانات دوّارة باستخدام إعلانات تخصيص أصول المواضع.

API مكتبة الإعلانات

أرشيف الإعلانات

ينطبق ذلك على الإصدار 13.0 والإصدارات الأحدث.

تم إيقاف استخدام حقول وعناصر ربط الاستعلام التالية في نقطة النهاية GET /ads_archive واستبدالها:

تم إيقاف استخدام معلمات الإرجاع التالية في نقطة النهاية GET /ads_archive واستبدالها:

المجموعات الإعلانية

توسيع نطاق الجماهير المشابهة

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

بالنسبة للمجموعات الإعلانية التي تم إنشاؤها حديثًا ويتم تحسينها للقيمة أو التحويلات أو أحداث التطبيق، سيتم تشغيل توسيع نطاق الجماهير المشابهة بشكل افتراضي ولا يمكن تعطيله. عند الحصول على مجموعة إعلانية يتم تحسينها من أجل القيمة أو التحويلات أو أحداث التطبيق، سنقوم بإرجاع خاصية جماهير مشابهة جديدة في الخريطة targeting_optimization_types التي توضِّح تمكين توسيع نطاق الجماهير المشابهة وإكمال الخاصية detailed_targeting الحالية لتوسيع نطاق الاستهداف التفصيلي.

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

• POST /{ad-account-id}/adsets
• GET /{ad-account-id}/adsets

واجهة API التحويلات

معلمات معلومات العميل

ينطبق ذلك على الإصدار 13.0 والإصدارات الأحدث.

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

• ct + country + st + zp + ge + client_user_agent
• db + client_user_agent
• fn + ge
• ln + ge

للتأكد من عدم إظهار الأحداث لأي خطأ، نوصيك بمراجعة أفضل ممارسات واجهة API التحويلات.

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

• POST /{pixel-id}/events
• POST /{offline_dataset_id}/events

منصة المعاملات التجارية

API الملفات الشخصية للشحن

ينطبق ذلك على الإصدار 13.0 والإصدارات الأحدث.

تم نقل الحقل handling_time لنقطة النهاية GET /{cms-id}/shipping_profiles من الكائن shipping_profile إلى الكائن address_category.

كتالوج المنتجات

API الموجز

ينطبق ذلك على الإصدار 13.0 والإصدارات الأحدث.

تمت إعادة تسمية رمز خطأ تحميل موجز المنتج XML_JUNK_AFTER_DOCUMENT إلى DATA_OUTSIDE_XML_TAGS. هذا تغيير في الاسم فقط.

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

• GET /{feed_upload_session_id}