التعرف على واجهة Graph API بالإصدار 15.0 وAPI التسويق بالإصدار 15.0في فيسبوك

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

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

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

تبسيط معايير إنشاء التحويل المخصص

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

تحديثات شروط المنصة

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

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

يمكنك عرض شروط المنصة للاطّلاع على التفاصيل الكاملة حول هذه التغييرات هنا.

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

طرح الجمهور المخصص باستخدام Advantage

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

بالنسبة للمعلنين الذين يعتمدون على الجماهير المخصصة، سيتمكنون من تحديد الجماهير المخصصة باستخدام Advantage. من خلال الجماهير المخصصة باستخدام Advantage، سيواصل المعلنون إنشاء جمهور مخصص (موقع الويب أو نشاط التطبيق أو قائمة العملاء أو التفاعل) وتطبيق التضمينات/الاستثناءات ذات الصلة، بينما يستفيدون من تقنيات الأتمتة والتعلُّم الآلي المتقدمة التي تستخدم جمهورك المخصص كمصدر لتوجيه عمليات العرض بحيث تصل إلى المزيد من المستخدمين الذين يُرجح أن يحققوا هدف التحسين الذي حددته.

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

إيقاف استخدام جماهير الإعلان الخاص

كجزء من اتفاقيتنا مع وزارة الإسكان والتنمية الحضرية الأمريكية (HUD)، سنتوقف عن استخدام جماهير الإعلان الخاص، وهي أداة تتيح للمعلنين توسيع نطاق الجماهير ليشمل مجموعات الإعلانات المتعلقة بالإسكان والتوظيف والائتمان. نحن بصدد إزالة إمكانية إنشاء جماهير الإعلان الخاص عبر API التسويق اعتبارًا من 15 سبتمبر 2022.

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

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

بالنسبة لقراءة الجمهور:

• نقطة النهاية gr:get:AdAccount/customaudiences
• الحقل operation_status

بالنسبة لإنشاء المجموعة الإعلانية:

• نقطة النهاية gr:post:AdAccount/adsets
• الحقل subtype

بالنسبة لتعديل المجموعة الإعلانية:

• نقطة النهاية gr:post:AdCampaign
• الحقل subtype

بالنسبة إلى إنشاء الجمهور المخصص:

• نقطة النهاية gr:post:AdAccount/customaudiences
• الحقل subtype

بالنسبة إلى تعديل الجمهور المخصص:

• نقطة النهاية gr:post:CustomAudience

يُرجى الرجوع إلى منشور المدونة السابق ووثائق المطوّر للحصول على مزيد من التفاصيل لدعم تنفيذ الرمز.

تحقيق التوازن بين الاستهداف التفصيلي باستخدام Advantage /الجمهور المشابه باستخدام Advantage

يحقق هذا المشروع التوازن لصالح الاستهداف التفصيلي كإشارة (الاستهداف التفصيلي باستخدام Advantage) لمستخدمي API الذين يستخدمون مجموعات الإعلانات مع تضمين الرسائل/عمليات تثبيت التطبيق كأهداف (ما بعد إصدار مدير الإعلانات). لقد أطلقنا سابقًا ميزة الاستهداف التفصيلي باستخدام Advantage في API للمجموعات الإعلانية التي تتضمن التحويلات كهدف والتحويلات/القيمة كأهداف تحسين (مجموعات VO/OC الإعلانية).

في الوقت الحالي، عندما ينشئ المعلنون مجموعات إعلانية عبر API مع تضمين الرسائل أو عمليات تثبيت التطبيق كهدف، سيتعين عليهم إدخال عنصرين كجزء من معايير الاستهداف (L2). سيتعين على المعلنين إدخال قائمة بمدخلات الاستهداف التفصيلي (على سبيل المثال: لعبة الكريكيت، كرة القدم، الكلاب، وغير ذلك) وإضافة تمييز يشير إلى ما إذا كانوا يريدون إدخال المزيد من العناصر بخلاف هذه المدخلات (يُطلق عليه الاستهداف التفصيلي باستخدام Advantage). إذا تم تمكين التمييز، فإن أنظمتنا ستعرض محتوى إضافي بخلاف تحديدات الاستهداف التفصيلي، إذا كان من المحتمل أن يؤدي ذلك إلى تحسين الأداء. وفي حالة تعطيله، ستقيد أنظمتنا حالات العرض لتقتصر على قائمة التحديدات التي قدمها المعلنون.

ومن الآن فصاعدًا (ما بعد إصدار مدير الإعلانات)، عندما ينشئ المعلنون حملات إعلانية جديدة تتضمن رسائل أو عمليات تثبيت تطبيقات الهاتف المحمول كأهداف، سيتم استخدام تضمينات الاستهداف التفصيلي كإدخال (وليس كتقييد) لتوجيه عملية عرض الإعلانات. وعلى هذا الأساس، فإننا بصدد إيقاف استخدام تمييز توسيع الاستهداف التفصيلي DTE لهذه الأهداف وجعل توسيع الاستهداف سلوكًا افتراضيًا بالنسبة لتحديدات الاستهداف التفصيلي. عند القيام بذلك، قد نتجاوز تضمينات الاستهداف التفصيلي إذا كان من المحتمل أن يؤدي ذلك إلى تحسين الأداء. ستظل كل عمليات تحديد الاستهداف والاستبعادات الأخرى غير متأثرة. لن ينطبق هذا التغيير على الفئات الخاصة.

طريقة العمل:

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

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

• لهذا الغرض، إذا أدخل المعلنون التمييز targeting_optimization عند إنشاء مجموعات إعلانية للرسائل/MAI جديدة أو عند الاستعلام عن تقديرات العرض لهذه المجموعات الإعلانية التي تم إنشاؤها حديثًا، فسنرسل رسالة خطأ نطلب منهم عدم إرسال هذه المعلمة بعد الآن.
• سيتم تعيين حقل جديد يُسمى targeting_as_signal في الخلفية أثناء عمليات إنشاء المجموعة الإعلانية التي تتضمن عمليات تثبيت التطبيق/الرسائل. يتوفر هذا الحقل لأوامر GET فقط لمساعدة المعلنين في التحقق مما إذا كانت المجموعات الإعلانية لديهم تعرض محتوى آخر بخلاف ما تم تضمينه في الاستهداف التفصيلي.

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

نقاط نهاية API المشمولة في النطاق:

• gr:post:/act_XXXX/ adsets
• gr:get:/<adset_id>/delivery_estimate

إيقاف استخدام علامات تبويب الصفحات

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

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

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

واجهة Graph API

• 1 نوفمبر 2022: سيتم إيقاف واجهة Graph API بالإصدار 8.0 وإزالتها من المنصة
• 23 فبراير 2023: سيتم إيقاف استخدام واجهة Graph API بالإصدار 9.0 وإزالتها من المنصة
• 8 يونيو 2023: سيتم إيقاف استخدام واجهة Graph API بالإصدار 10.0 وإزالتها من المنصة

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

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

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

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