عودة إلى أخبار المطوّرين

Introducing Graph v8.0 and Marketing API v8.0

٤ أغسطس ٢٠٢٠بواسطة‏‎Yi Wei‎‏

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

إذا كنت مطوّرًا لنظام iOS، فترقب المزيد من الإعلانات حول مجموعة SDK فيما يتعلق بطرح نظام iOS14 المعلق والتابع لشركة Apple.

إجراء المطوّر المطلوب

إجراء تغييرات على الوصول غير المستند إلى رمز لصورة المستخدم ونقاط نهاية FB/IG OEmbed: بحلول 24 أكتوبر 2020، يجب على المطوّرين الاستفادة من المستخدم أو التطبيق أو رمز العميل عند الاستعلام عن واجهة Graph API لصور الملف الشخصي للمستخدم عبر معرف المستخدم (UID) وFB OEmbeds وIG OEmbeds. ويجب على المطوّرين تقديم رمز المستخدم أو التطبيق عند الاستعلام عن صور الملف الشخصي عبر معرف المستخدم (UID) أو المعرف على مستوى التطبيق (ASID)، على الرغم من دعم رموز العميل أيضًا. وللحصول على تفاصيل حول كيفية بدء استدعاء نقاط نهاية واجهة Graph API هذه حاليًا، يرجى زيارة سجل التغييرات لدينا فيما يتعلق بصورة المستخدم وFacebook OEmbed وInstagram OEmbed.

تحديثات إذن إدارة النشاط التجاري: بالنسبة لأي تطبيق يريد الوصول إلى حقل النشاط التجاري في الحسابات الإعلانية، فإننا نطلب الآن من التطبيق الحصول على الأذونات التفصيلية الخاصة بكائن النشاط التجاري المحدد الذي يتم الوصول إليه. وبحلول 2 نوفمبر 2020، سيتعين على التطبيقات طلب الحصول على الأذونات التفصيلية business_management للنشاط التجاري الذي يمتلك الحسابات الإعلانية. ولمزيد من المعلومات حول الأذونات التفصيلية، راجع وثائق الإذن التي نوفرها.

فصل الإذن catalog_management عن ads_management: استجابة إلى اهتمام المطوّر بالوصول إلى هذه الأذونات بشكل منفصل، فإننا نعمل على فصل هذه الأذونات. ويمكن تضمين التعليمات التفصيلية في سجل التغييرات بالإصدار 8.0 لدينا. وبحلول 31 يناير 2021، سيحتفظ المطوّرون الذين لديهم بالفعل حق الوصول إلى الإذن catalog_management بإمكانية الوصول، ولكن سيتعين عليهم مطالبة المستخدمين بمنح إذن الوصول عبر مربع الحوار تسجيل الدخول في FB.

حالات إيقاف الاستخدام في هذا التحديث

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

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

المشاركة للأجهزة: سنزيل الوصول إلى ميزة "المشاركة للأجهزة" التي تتيح للمستخدمين مشاركة المحتوى من أجهزة إنترنت الأشياء إلى Facebook عبر مربع الحوار مشاركة. وسيفقد المطوّرون الوصول إلى هذه الميزة في 2 نوفمبر 2020.

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

  • في 28 سبتمبر 2020 - لن تتوفر واجهة API التسويق بالإصدارين 5.0 و6.0 بعد الآن
  • في 27 أكتوبر 2020 - لن تتوفر واجهة Graph API بالإصدار 3.1 بعد الآن

لا يلزم اتخاذ أي إجراء، وهذا للعلم فقط

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

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

عروض أسعار التكلفة المستهدفة: اعتبارًا من 1 أكتوبر 2020، لن تتوفر عروض أسعار التكلفة المستهدفة بعد الآن للتحديد من بين خيارات عروض الأسعار المتاحة في واجهة المستخدم. لاحظ أنه سيتم إيقاف استخدام التكلفة المستهدفة في واجهة API التسويق بالإصدار 8.0، ولكنها ستظل قابلة للوصول إليها في الإصدار 7.0. بالنسبة للمطوّرين الذين يريدون مواصلة التحكم في التكلفة، نوصي باستخدام إستراتيجية عرض أسعار الحد الأقصى للتكلفة والتي تتيح إمكانية تحديد متوسط التكلفة لكل إجراء في حملتك الإعلانية والحصول على أكبر عدد ممكن من أحداث التحسين المناسبة لميزانيتك دون تجاوز الحد الأقصى. ومقارنةً بالتكلفة المستهدفة، يمكنك توقع المزيد من أحداث التحسين والمزيد من الإنفاق عند استخدام الحد الأقصى للتكلفة.

تقويم عنصر الإجراء

حالات إيقاف استخدام إصدار واجهة API التسويق

  • كن على علم بأنه ستتم إزالة واجهة API التسويق بالإصدارين 5.0 و6.0 من المنصة. | 09/28/2020 | غير متوفر

إجراء تغييرات على الوصول غير المستند إلى رمز لصورة المستخدم ونقاط نهاية FB/IG OEmbed

  • قم بتحديث استخدام الرمز للوصول إلى صورة المستخدم. | 10/24/2020 | صورة المستخدم
  • قم بتحديث استخدام الرمز للوصول إلى نقاط نهاية FB OEmbed. | 10/24/2020 | FB OEmbed
  • قم بتحديث استخدام الرمز للوصول إلى نقاط نهاية IG OEmbed. | 10/24/2020 | IG OEmbed

إيقاف استخدام إصدار واجهة Graph API

  • كن على علم بأنه ستتم إزالة واجهة Graph API بالإصدار 3.1 من المنصة. | 10/27/2020 | غير متوفر

تحديثات إذن إدارة النشاط التجاري

  • سيتعين على التطبيقات طلب الحصول على الأذونات التفصيلية business_management للنشاط التجاري الذي يمتلك الحسابات الإعلانية | 11/02/2020 | وثائق الإذن

نقاط نهاية واجهة API

  • كن على علم بعملية الإزالة القادمة لنقاط نهاية واجهة API من المنصة. | 11/02/2020 أو 08/04/2022 (كما هو محدد في سجل التغييرات) | سجل التغييرات

المشاركة للأجهزة

  • كن على علم بعملية الإزالة القادمة لميزة "المشاركة للأجهزة". | 11/02/2020 | غير متوفر

فصل الإذن catalog_management عن ads_management

  • سيتعين على المطوّرين الذين يمكنهم الوصول إلى الإذن catalog_management مطالبة المستخدمين بمنح إذن الوصول عبر مربع الحوار تسجيل الدخول في FB. | 01/31/2021 | سجل تغييرات الإصدار 8.0