الإصدار 11.0

واجهة Graph API

تم الطرح في 8 يونيو 2021 | متوفر حتى 14 سبتمبر 2023 | منشور المدونة

تطبيقات المستهلك

مستويات الوصول

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

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

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

دعم المطوّر

لقد طرحنا أداة حالة فيسبوك للنشاط التجاري لمراقبة جودة المنصة ومنتجات النشاط التجاري مثل مدير الإعلانات وواتساب للأعمال ومنصة فيسبوك للمطورين.

تحليلات فيسبوك

إيقاف الاستخدام

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

لن تصبح أداة Facebook Analytics متوفرة بعد 30 يونيو 2021. بالإضافة إلى ذلك، سنعمل على إيقاف استخدام المكون الإضافي للوحة معلومات التطبيق لدى واجهة API التسويق. لمزيد من المعلومات، تفضل بزيارة مركز مساعدة الأعمال.

لم تعد حقول عقدة التطبيق التالية متوفرة:

• analytics_config
• analytics_platform_metrics_config
• permissible_ad_accounts

لم تعد نقاط النهاية التالية متوفرة:

• GET Application/analytics_cohort_query
• GET Application/analytics_entity_user_config
• GET Application/analytics_event_types
• GET Application/analytics_funnel_query
• GET Application/analytics_query
• GET Application/analytics_segments

API العرض الأساسي في Instagram

مصحح أخطاء رمز الوصول

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

تعمل أداة مصحح أخطاء رمز الوصول الآن على إرجاع معرف على مستوى التطبيق عند تصحيح أخطاء رمز ما.

تعيين إصدارات واجهة API

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

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

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

تتعامل الطلبات غير محددة الإصدار (لا يتوفر لديها رقم الإصدار) مع الإصدار المحدد في إعداد لوحة معلومات التطبيق > الإعدادات > متقدم > ترقية إصدار واجهة API للتطبيق الذي يجري الاستدعاء.

معرفات المستخدم على مستوى التطبيق

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

تم طرح معرفات المستخدم على مستوى التطبيق (ASIDs). وستحل معرفات المستخدم على مستوى التطبيق (ASIDs) محل معرفات المستخدم الأولية خلال عامين تقريبًا، عندما يتم إيقاف استخدام الإصدار 10.0، لذا نوصي ببدء تعيين المعرفات الأولية لمستخدمي التطبيق إلى معرفات المستخدم على مستوى التطبيق (ASIDs) المكافئة.

• تدعم جميع الإصدارات الاستعلامات المستندة إلى معرف المستخدم الأولي.
• تدعم استدعاءات الإصدار 11.0 والإصدارات الأحدث فقط الاستعلامات المستندة إلى معرف المستخدم على مستوى التطبيق (ASID).
• سيستقبل الإصدار 11.0 والإصدارات الأحدث معرفات المستخدم على مستوى التطبيق (ASIDs) في استجابات، حتى عند الاستعلام عن معرفات المستخدم الأولية.

تقسيم الصفحات استنادًا إلى الوقت

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

تمت إضافة المعلمتين since وuntil إلى نقطة النهاية GET /{user-id}/media لدعم تقسيم الصفحات استنادًا إلى الوقت.

واجهة Instagram Graph API

أعداد تسجيلات الإعجاب

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

إذا تم الاستعلام بشكل غير مباشر عن وسائط IG عبر نقطة نهاية أخرى أو توسيع الحقل، فسيتم حذف الحقل like_count من استجابات واجهة API إذا كان مالك الوسائط لديه أعداد تسجيلات إعجاب مخفية عليها. وسيعمل الاستعلام بشكل مباشر عن وسائط IG (والذي يمكن إجراؤه فقط من خلال مالك وسائط IG) على إرجاع عدد تسجيلات الإعجاب الفعلي، حتى إذا كانت أعداد تسجيلات الإعجاب مخفية.

تقسيم الصفحات استنادًا إلى الوقت

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

تمت إضافة المعلمتين since وuntil إلى نقطة النهاية GET /{ig-user-id}/media لدعم تقسيم الصفحات استنادًا إلى الوقت.

التجارب الفورية

القوالب

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

تم نقل قوالب التجارب الفورية من الإصدار التجريبي وأصبحت متوفرة الآن لكل المطوّرين.

منصة Messenger

Webhook لعمليات postback المراسلة

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

تمت إضافة الحقل mid إلى webhook messaging_postbacks للسماح للتطبيقات بالحصول على معرف الرسالة.

إيقاف استخدام قوالب الخطوط الجوية

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

ستفشل الاستدعاءات إلى POST /{page-id}/messages التي تتضمن أي قوالب خطوط جوية (template_type للأنواع airline_boardingpass وairline_checkin وairline_itinerary وairline_update).

oEmbed

ميزة قراءة oEmbed الجديدة

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

تم استبدال منتج oEmbed بميزة قراءة oEmbed جديدة. إذا تم تنفيذ منتج oEmbed قبل 8 يونيو 2021، فستتاح لك فرصة إكمال عملية مراجعة التطبيقات لميزة قراءة oEmbed حتى 7 سبتمبر 2021. إذا لم يتم اعتمادك لميزة قراءة oEmbed بحلول 7 سبتمبر 2021، فسيفشل تحميل عمليات تنفيذ oEmbed.

واجهة API الصفحات

معرفات التعليق

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

لن يتم إرجاع الحقل id للتعليقات بالنسبة لأي تطبيقات تستخدم ميزة الوصول إلى المحتوى العام للصفحة فقط للاستعلام عن نقاط نهاية الصفحات. يتضمن هذا الحقول id/PAGEPOST-ID/comments أو /COMMENT-ID/comments. وللحصول على حقول id للتعليقات بالنسبة للتعليقات على منشورات الصفحة، يجب أن يتمكن مستخدم التطبيق من إجراء المهمة MODERATE على الصفحة التي يتم الاستعلام عنها.

تجربة الصفحة الجديدة

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

تدعم معظم نقاط نهاية واجهة API الصفحات كل من الصفحات القديمة وتجربة الصفحات الجديدة. وتعرض نقاط النهاية التي تدعم صفحات تجربة الصفحات الجديدة (NPE) قسم "تجربة الصفحات الجديدة" في المراجع.

لا تدعم نقاط النهاية التالية صفحات تجربة الصفحات الجديدة (NPE):

• /PAGE-ID/likes
• /PAGE-ID/global_brand_children
• /PAGE-ID/locations
• /PAGE-ID/tabs
• /PAGE-ID/visitor_posts

لا تتوفر حقول الصفحة المتعددة لتجربة الصفحات الجديدة (NPE) وسترجع null أو مجموعة بيانات مختلفة أو خطأ عند استدعائها. يُرجى زيارة نظرة عامة حول تجربة الصفحات الجديدة للحصول على قائمة بحقول هذه الصفحة.

الأذونات

user_likes

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

تم تحديث الاستخدام المسموح به للإذن user_likes. اعتبارًا من 7 سبتمبر 2021، سيتم إلغاء الموافقة على التطبيقات التي تم اعتمادها بالفعل للحصول على هذا الإذن ولكنها تخالف وصف الاستخدام الجديد.

• الاستخدام المسموح به القديم: تحسين جودة تجربة المستخدم في تطبيقك بشكل هادف (ويجب أن يكون واضحًا للمستخدم كيفية استخدام بياناته لتوفير تلك التجربة).
• الاستخدام المسموح به الجديد: توفير تجربة مخصصة من خلال ربط المحتوى المرتبط بتسجيلات إعجاب الشخص أو عرضه. ويتضمن ذلك تجميع المحتوى على نطاق واسع لتخصيص التطبيقات التي تضم قدرًا كبيرًا من المحتوى ولتمكين الأشخاص من مشاركة تسجيلات إعجابهم مع الآخرين، على سبيل المثال في تطبيقات المواعدة وتطبيقات الموسيقى.

user_posts

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

تم تحديث الاستخدام المسموح به للإذن user_posts. اعتبارًا من 7 سبتمبر 2021، سيتم إلغاء الموافقة على التطبيقات التي تم اعتمادها بالفعل للحصول على هذا الإذن ولكنها تخالف وصف الاستخدام الجديد.

• الاستخدام المسموح به القديم: تحسين جودة تجربة المستخدم في تطبيقك بشكل هادف (ويجب أن يكون واضحًا للمستخدم كيفية استخدام بياناته لتوفير تلك التجربة).
• الاستخدام المسموح به الجديد: تمكين الأشخاص من إنشاء كتب أو ألبومات فعلية أو رقمية في اليوميات ومشاركة الذكريات من اليوميات على Facebook أو على تطبيقات التواصل الاجتماعي الأخرى.

مجموعة SDK

يُرجى زيارة سجل تغييرات مجموعة iOS SDK وسجل تغييرات مجموعة Android SDK وسجل تغييرات مجموعة Unity SDK للتعرف على التغييرات المهمة القادمة على مجموعات SDK هذه.

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

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

الجماهير

حذف الجماهير المخصصة والجماهير المشابهة والجماهير المحفوظة

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

اعتبارًا من 8 يونيو 2021 وما يليه، سيتم تمييز أي جمهور مخصص أو جمهور مشابه أو جمهور محفوظ لم يتم استخدامه في أي مجموعة إعلانية نشطة لما يزيد عن عامين كـ "جمهور منتهي الصلاحية". ثم ستتم جدولة الجمهور للحذف بعد 90 يومًا من تحديده كـ "جمهور منتهي الصلاحية".

سيتمكن المطوّرون من الفلترة لعرض الحالة "جمهور منتهي الصلاحية" باستخدام الحقل operation_status وعرض الوقت المقدر لحذف الجمهور في النظام باستخدام الحقل delete_time. وبإمكان المطوّرين اختيار حذف الجمهور بشكل استباقي أو استخدام الجمهور في مجموعة إعلانية نشطة لتجنب الحذف. وبمجرد حذف جمهور، لن يتمكن المعلنون من إعادة تنشيط الجمهور.

بالنسبة إلى الجماهير المخصصة (باستثناء الجماهير المخصصة لقائمة العملاء) والجماهير المشابهة والجماهير المحفوظة:

• إذا أراد المعلنون حذف الجماهير التي تم تمييزها تلقائيًا اعتبارًا من 6 سبتمبر 2021، فلا داعي لاتخاذ أي إجراء. ومع ذلك، يمكنهم أيضًا حذف الجمهور بشكل استباقي قبل تاريخ الحذف التلقائي إذا أرادوا ذلك.
• بالنسبة للجماهير التي تم تمييزها والتي يريد المعلنون الاحتفاظ بها، عليهم تخطيط استخدام هذه الجماهير في مجموعة إعلانية نشطة قبل 6 سبتمبر 2021 لمنع حذف الجمهور.

بالنسبة إلى الجماهير المخصصة لقائمة العملاء:

• يتم تخزينها نيابة عن المعلنين وفقًا لتعليماتهم. وإذا لم يتخذ المعلنين أي إجراء لاستخدام الجماهير التي تم تمييزها ضمن مجموعة إعلانية نشطة قبل 6 سبتمبر 2021، فسنعتبر هذا بمثابة تعليمات لنا لحذف الجمهور الذي تم تمييزه.

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

• GET /{custom-audience-id}
• GET /act_{ad-account-id}/customaudiences?filtering
• GET /act_{ad-account-id}/saved_audiences?filtering
• GET /{saved-audience-id}

يمكنك الاطلاع على نظرة عامة حول الجماهير: تغييرات حذف الجماهير المخصصة لمزيد من المعلومات حول هذه التحديثات.

واجهة API النشاط التجاري

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

يتم تقييد الوصول إلى نقاط النهاية التالية مؤقتًا. لن يستمر الوصول إلا للتطبيقات التي نجحت في الاتصال بنقاط النهاية هذه خلال آخر 30 يومًا.

• POST /BUSINESS-ID/client_ad_accounts
• POST /ADACCOUNT-ID/agencies

ستتلقى كل التطبيقات الأخرى خطأً عند إجراء الاستدعاءات إلى نقاط النهاية هذه.

واجهة API الكتالوج

إيقاف استخدام حقل مخزون المنتج

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

سيتم إيقاف استخدام الحقل inventory واستبداله بحقل quantity_to_sell_on_facebook جديد. وبينما نستمر في دعم الحقل inventory على المدى القريب، نوصي باستخدام الحقل quantity_to_sell_on_facebook الجديد بدلاً من ذلك.

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

• GET /{product-item-id}
• GET /{catalog-id}/products
• POST /{product-item-id}
• POST /{catalog-id}/items_batch

يمكنك الاطّلاع على "الكمية المطلوب بيعها" والحقول المدعومة للمنتجات - الإعلانات الديناميكية والمعاملات التجارية لمزيد من المعلومات حول هذا التحديث.

حذف مجموعات المنتج غير الفارغة

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

لن نسمح بعد الآن بحذف مجموعات المنتجات غير الفارغة افتراضيًا. ويمكن حذف مجموعات المنتج غير الفارغة من خلال تطبيق deletion_method=delete_items على طلب الحذف. سيعمل ذلك على حذف كل من مجموعة المنتج وعناصرها.

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

• DELETE /<product_group_id>

حذف مجموعات المنتجات المنشورة

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

لن نسمح بعد الآن بحذف كتالوج يحتوي على مجموعات منتجات منشورة بشكل افتراضي. لتمكين حذف كتالوج يحتوي على مجموعة منتج منشورة، يمكنك تعيين معلمة المنتج allow_delete_catalog_with_live_product_set إلى true.

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

• DELETE /<product_catalog_id>

نقطة نهاية التشخيصات الجديدة

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

لقد أضفنا نقطة نهاية جديدة GET /{product_catalog_id}/diagnostics. ويمكن استخدام نقطة النهاية هذه لاسترداد بيانات عمليات التشخيص لكتالوج معين، مثل المشكلات التي تمنع عرض المنتجات في القنوات والفرص التي يمكن أن تحسن قابلية اكتشاف المنتج.

واجهة API المعاملات التجارية

تفاصيل الدفع التقديرية لإجمالي الطلب

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

نحن بصدد تغيير طريقة الإبلاغ عن تفاصيل الدفع التقديرية في تسجيلات إجمالي الطلب للاستدعاءات إلى نقطة النهاية {commerce-order-id}/?fields=estimated_payment_details. في السابق، كان يتم استخدام ضرائب تقديرية إذا لم يتم إكمال طلب ما، وكان يتم استخدام ضرائب مكتملة للطلبات المكتملة. وبدءًا من الإصدار 11.0، ستستخدم نقطة النهاية هذه الضرائب التقديرية دائمًا. لاحظ أنه يمكن الوصول إلى تفاصيل حول الضرائب المكتملة باستخدام {commerce-order-id}/items?fields=tax_details.

تحسين التحويل

تغييرات أدوات القياس

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

تم تغيير أدوات القياس التي يتم إرجاعها من الحقل GET /{objective-id}/?fields=result.

تمت إضافة أدوات القياس التالية:

• conversions_incremental_share
• conversions_CPiC
• conversions_multicell_confidence
• conversions_multicell_rank
• sales_incremental_share
• sales_multicell_confidence
• sales_multicell_rank
• buyers_incremental_share
• buyers_CPiB
• buyers_multicell_confidence
• buyers_multicell_rank

تمت إزالة أدوات القياس التالية:

• advancedBuyers.control
• ancedBuyers.informativeMultiCellBayesianConfidence
• advancedBuyers.lift
• advancedBuyers.test
• advancedConversions.control
• advancedConversions.informativeMultiCellBayesianConfidence
• advancedConversions.lift
• advancedConversions.test
• advancedSales.control
• advancedSales.informativeMultiCellBayesianConfidence
• advancedSales.lift
• advancedSales.test
• buyers.baseline
• buyers.bayesianCILower
• buyers.bayesianCIUpper
• buyers.control
• buyers.delta
• buyers.incremental
• buyers.isStatSig
• buyers.lift
• buyers.multiCellBayesianConfidence
• buyers.reachedPercent
• buyers.singleCellBayesianConfidence
• conversions.baseline
• conversions.bayesianCILower
• conversions.bayesianCIUpper
• conversions.control
• conversions.delta
• conversions.incremental
• conversions.isStatSig
• conversions.lift
• conversions.multiCellBayesianConfidence
• conversions.reachedPercent
• conversions.singleCellBayesianConfidence
• frequency
• incrementalROAS
• sales.baseline
• sales.bayesianCILower
• sales.bayesianCIUpper
• sales.control
• sales.delta
• sales.incremental
• sales.isStatSig
• sales.lift
• sales.multiCellBayesianConfidence
• sales.singleCellBayesianConfidence

تمت إعادة تسمية أدوات القياس التالية:

يمكن عرض قائمة كاملة لأدوات القياس المتوفر في مسرد مصطلحات أدوات قياس التحسين في Facebook.

واجهة API الرؤى

إيقاف استخدام أدوات قياس زيارة المتجر

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

سيتم إيقاف استخدام أداتي القياس store_visits_actions وcost_per_store_visit_actions.

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

• GET /{adaccount-id}/insights
• GET /{campaign-id}/insights
• GET /{adset-id}/insights
• GET /{ad-id}/insights
• POST /{adaccount-id}/insights
• POST /{campaign-id}/insights
• POST /{adset-id}/insights
• POST /{ad-id}/insights

واجهة API إعلانات العروض

إيقاف استخدام نقاط نهاية واجهة API إعلانات العروض

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

في إطار جهودنا المتواصلة لتعزيز استقرار المنتج، سيعمل فيسبوك على إنهاء دعم منتج إعلانات العروض اعتبارًا من 8 يونيو 2021. وتُعد إعلانات فيسبوك القياسية هي البديل الموصى به لتوزيع خصوماتك داخل المتجر أو على الإنترنت. ويُنصح بوضع معلومات الخصومات وموقع (مواقع) التحصيل وتاريخ انتهاء الصلاحية والرموز الترويجية مباشرة في التصميم على مستوى الإعلان.

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

• GET /{page-id}/nativeoffers
• POST /[page-id}/nativeoffers
• GET /pagename/nativeoffers
• GET /{native-offer-id}
• GET /{native-offer-id}/views
• POST /{native-offer-id}/codes
• POST /{native-offer-id}/nativeofferviews
• GET /{offer-id}/comments
• GET /{offer-id}/sharedposts
• GET /{offer-id}/likes