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

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

١٢ سبتمبر ٢٠٢٣بواسطة‏‎Naveen Santhanavel‎‏

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

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

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

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

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

نحن نُطبِّق هذا التغيير كجزء من جهودنا المستمرة لتقديم قيمة أكبر للأنشطة التجارية وتبسيط نظام الإعلانات لدينا وتسهيل خيارات الاستهداف؛ من أجل زيادة كفاءة الأداء وإزالة الخيارات ذات معدل الاستخدام المنخفض.

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

إضافة "add_security_recommendation" و"code_expiration_minutes" إلى واجهة API قوالب رسائل واتساب

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

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

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

إعادة طرح وثائق المطوّرين وسجلات التغييرات من أجل إنشاء إعلانات للاتصال

  • موضع ريلز من فيسبوك لإعلانات للاتصال
    تطرح Meta القدرة على عرض إعلانات للاتصال من خلال منصة ريلز من فيسبوك. حيث تسمح إعلانات للاتصال للمستخدمين بالاتصال بالأنشطة التجارية وقتما اهتموا بذلك عند عرض الإعلان، كما تساعد الأنشطة التجارية على إجراء محادثات أكثر تعقيدًا مع المستخدمين المهتمين. وهي فرصة بالنسبة للأنشطة التجارية للإعلان باستخدام إعلانات للاتصال استنادًا إلى سلوكيات الأشخاص الفورية على فيسبوك. ضمن مستوى المجموعة الإعلانية في مدير الإعلانات، يمكن للأنشطة التجارية اختيار إضافة "ريلز من فيسبوك" أسفل قسم المواضع.
  • إعادة طرح إعلانات للاتصال عبر API
    في 12 سبتمبر 2023، سنوفر إرشادات محدَّثة حول كيفية إنشاء إعلانات للاتصال عبر واجهة API. نحن بصدد طرح الوثائق من أجل إعلانات للاتصال فقط؛ ولذلك يمكن لمطوري 3P إنشاء حملات إعلانية تتضمن إعلانات للاتصال بمزيد من السهولة والتعرُّف على كيفية عرض رؤى حول حملاتهم الإعلانية الحالية التي تتضمن إعلانات للاتصال، بما في ذلك أدوات القياس المتعلقة بالاتصال. كما نخطط لدعم المكونات الإضافية للاتصال عبر منصة API لدينا مستقبلاً. يجب أن يمتلك منشئو المحتوى صلاحية الوصول إلى الأذونات العامة اللازمة من أجل إنشاء إعلانات عامة لإنشاء إعلانات للاتصال عبر منصة API.

    يُرجى الرجوع إلى وثائق المطوّرين للحصول على المزيد من المعلومات.

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

التغييرات على Graph API لميزة الإذن التفصيلي للمستخدم

نحن بصدد تحديث نقطتين من نقاط نهاية graph API لحسابات واتساب للأعمال. ونقاط النهاية هذه كالتالي:

  • استعادة قوالب الرسائل المرتبطة بحساب واتساب للأعمال
  • استعادة أرقام الهاتف المرتبطة بحساب واتساب للأعمال

بفضل الإصدار 18، سنطرح ميزة جديدة "الإذن التفصيلي للمستخدم". ستتم إعادة تعبئة جميع المستخدمين الحاليين المضافين إلى حساب واتساب للأعمال بالفعل، كما ستظل لديهم صلاحية الوصول (دون تأثير).

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

إيقاف استخدام أسماء أدوات القياس القديمة لوسائط IG رؤى المستخدم

بدايةً من 12 سبتمبر، سيزيل Instagram أدوات قياس الرؤى القديمة والمكررة من واجهة Instagram Graph API؛ لمشاركة مصدر واحد لأدوات القياس مع المطوّرين.

وستقلل هذه الترقية من حدوث أي لبس، وستُزيد مدى موثوقية إعداد التقارير لدينا وجودته.

بعد 90 يومًا من الطرح (أي في 11 ديسمبر 2023)، سنزيل جميع أدوات القياس القديمة والمكررة تلك من واجهة Instagram Graph API على جميع الإصدارات؛ للتمتع بالمزيد من الاتساق مع تطبيق Instagram.

نحن نقدر كل الملاحظات التي تلقيناها من مجتمع المطوّرين، ونتطلَّع إلى متابعة التعاون معًا.

يُرجى الاطّلاع على وثائق رؤى الوسائط ورؤى المستخدم للمطوّرين للتعرُّف على المزيد.

إيقاف استخدام جميع نقاط نهاية الإصدار الأول والثاني من Facebook Wi-Fi

تم تصميم Facebook Wi-Fi لتحسين تجربة الاتصال بنقاط الاتصال اللاسلكية لشبكة Wi-Fi في الأنشطة التجارية. وقد أتاحت لعملاء التجار الحصول على خدمة Wi-Fi مجانية من خلال تسجيل الدخول على فيسبوك ببساطة. كما أتاحت للتجار التحكم في مَن يمكنه استخدام شبكة Wi-Fi الخاصة بهم ولأي مدة، ودمجها بالإعلانات لتمكين استهداف العملاء الذين استخدموا خدمة Wi-Fi الخاصة بالتاجر. تم إيقاف استخدام هذا المنتج في 12 يونيو 2023. وبما أن فترة إشعار الشريك قد انتهت، تم إيقاف استخدام جميع نقاط النهاية المستخدمة من Facebook Wi-Fi بإصداريه الأول والثاني وإزالتها.

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

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

واجهة Graph API

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

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

  • 20 سبتمبر 2023: سيتم إيقاف استخدام API التسويق بالإصدار 14.0 وإزالتها من المنصة
  • 20 سبتمبر 2023: سيتم إيقاف استخدام API التسويق بالإصدار 15.0 وإزالتها من المنصة
  • 6 فبراير 2024: سيتم إيقاف استخدام API التسويق بالإصدار 16.0 وإزالتها من المنصة

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

مجموعة SDK لمنصة فيسبوك

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

  • أكتوبر 2023: سيتم إنهاء العمل بمجموعة SDK لمنصة فيسبوك بالإصدار 11.0 أو الإصدارات الأقدم
  • فبراير 2024: سيتم إنهاء العمل بمجموعة SDK لمنصة فيسبوك بالإصدار 12.0 أو الإصدارات الأقدم