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

Introducing Graph API v20.0 and Marketing API v20.0

٢١ مايو ٢٠٢٤بواسطة‏‎Ayyad Farah‎‏

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

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

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

التحديث التلقائي لإصدار واجهة API التسويق

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

للتعرُّف على المزيد حول هذا السلوك، راجِع تعيين إصدارات API التسويق ومدونة الطرح.

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

للحصول على المزيد من التحديثات الخاصة بإصدار 20.0، يُرجى الاستمرار في القراءة.

الإعلانات التذكيرية لواجهة API

قبل 13 مايو 2024، لم يتمكن المطوّرون من دعم إنشاء إعلانات تذكيرية على Instagram عبر واجهة API التسويق على Instagram، وكان بإمكان عملائهم إنشاء إعلانات تذكيرية فقط في مدير الإعلانات من Meta. ولقد شكل عدم التوافق هذا خسارة غير مرغوب فيها للعملاء من شركائنا وعملائهم الذين أرادوا تشغيل إعلانات تذكيرية.

وبعد المعرفة المنتظمة بالملاحظات حول عدم التوافق هذا، أصبحنا ندعم الآن إنشاء إعلانات تذكيرية عبر واجهة API التسويق من Instagram اعتبارًا من 13 مايو 2024.

نقدِّر الملاحظات التي تلقيناها من مجتمع المطوّرين وعملائهم، ونأمل الاستمرار في تحسين تجربة الإعلانات التذكيرية المتوفرة عبر واجهة API التسويق.

حول الإعلانات التذكيرية على Instagram

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

حول إنشاء المناسبات وتعديلها

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

واجهة API جديدة على عقدة الحساب الإعلاني

لا يُعتبَر تحديث عقدة الحساب الإعلاني الجديدة تغييرًا جذريًا؛ بل هو إضافة على واجهة API. يسرد استدعاء ذلك جميع الحملات الإعلانية ضمن هذا الحساب الإعلاني والتي تحتوي على توصيات إرشادية، إلى جانب التوجيه والتحسين المتوقع في التكلفة لكل إجراء (CPA).

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

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

إذا كان نشاطك التجاري يُدير مئات أو آلافًا من الحسابات، فمن الصعب التحقق من أي أداة قياس لدى أي حساب منهم على حدة، خاصة الأدوات الحساسة للوقت (يتم تحديث توصيات RSS يوميًا وتُراعَى الحملات الإعلانية في آخر 28 يومًا). ستمكن واجهة API هذه الوكالات من تحديد أكثر الحملات الإعلانية الواعدة التي يمكن تحسينها باستخدام التوصيات المقدَّمة؛ مما سيتم دمجه تباعًا في أنظمتها.

تمكِّن واجهة CPA_GUIDANCE API على وجه التحديد الوكالات من توفير إرشادات إلى شركاء العلامات التجارية حول المنتجات أو الفئات التي لديها أعلى تكلفة لكل اكتساب (CPA). من خلال مشاركة هذه المعلومات، يمكن للوكالات مساعدة شركاء العلامات التجارية على تحسين الإنفاق الإعلاني الخاص بهم وتحسين أداء حملاتهم الإعلانية التعاونية في المجمل.

ستتمكن الوكالات أيضًا من تتبُّع إذا ما كان قد تم تنفيذ توصية الإرشادات أم لا من خلال مراقبة اتجاه رائج للتكلفة لكل إجراء.

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

نقدم اليوم إمكانية اشتراك المعلنين في الإعلان من معلنين متعددين عبر واجهة API التسويق. وقبل إجراء هذا التحديث، لم يكن بإمكان المطوّرين دعم إنشاء إعلانات من معلنين متعددين عبر الواجهة، وكان بإمكان عملائهم استخدام إعلانات من معلنين متعددين فقط في مدير الإعلانات من Meta.

حول الإعلانات من معلنين متعددين

يمكن أن تساعد الإعلانات من معلنين متعددين الأشخاص على استكشاف المنتجات والخدمات من أنشطة تجارية متعددة. بالنسبة إلى مواضع محددة على فيسبوك وInstagram، يمكن أن تظهر الإعلانات جنبًا إلى جنب مع إعلانات أخرى في نفس الوحدة الإعلانية؛ لمساعدة الأشخاص على اكتشاف المنتجات والخدمات المقدمة من الأنشطة التجارية ذات الطابع الشخصي لهم. الوحدة الإعلانية عبارة عن حاوية تعرض إعلانات متعددة، عادةً ما تكون على نفس الصفحة. تعرَّف على المزيد في مركز مساعدة الأعمال.

ما الذي يعنيه ذلك بالنسبة إلى المطوّرين

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

ميزات تصميم الذكاء الاصطناعي التوليدي التي ستنضم إلى واجهة API التسويق: إنشاء النصوص وتوسيع الصورة وإنشاء الخلفيات

أعلنّا في أكتوبر 2023 طرح ميزات تصميمات الإعلانات المدعومة بالذكاء الاصطناعي التوليدي الأولى من نوعها - إنشاء النصوص وتوسيع الصور وإنشاء الخلفيات - للأنشطة التجارية في مدير الإعلانات. واليوم أردنا أن تضع في اعتبارك أننا نوفر ميزات التصميمات باستخدام الذكاء الاصطناعي التوليدي للمعلنين عبر واجهة API التسويق (MAPI) حتى يتمكن الشركاء والوكالات والمعلنون من الاستفادة مما يقدمه الذكاء الاصطناعي التوليدي من Meta من خلال واجهة API التسويق.

تقوم هذه الميزات بتمكين إنشاء إصدارات مختلفة من التصميم بسرعة وتلقائيًا؛ مما ينذر بعصر جديد من الإبداع يعزز من القدرة الإنتاجية والتخصيص والأداء لجميع المعلنين:

  • إنشاء الخلفيات: هي ميزة تنشئ أربع صور خلفية بحد أقصى لتضفي طابعًا جديدًا على صور المنتجات؛ مما يُتيح خلق تنوع في التصميم من أجل جمهورك. وستستند الخلفيات التي يتم إنشاؤها إلى صور منتجك الأصلية وغالبًا ما تكون خلفيات بسيطة تحتوي على ألوان وأنماط.

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

  • إنشاء النصوص: تنشئ عدة إصدارات لنصوص الإعلان استنادًا إلى النص الأصلي؛ مع التركيز على نقاط بيع المنتجات/الخدمات وإنشاء خيارات نصوص متعددة لتنويع إعلاناتك لكي تتناسب مع جمهورك.

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

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

كيف ستعمل هذه الميزة؟

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

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

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

ملاحظة: يُظهِر المثال السابق الاشتراك في ميزة إنشاء الخلفيات. وبالمثل، لميزة "توسيع الصور" استخدِم مفتاح image_uncrop ومفتاح text_generation لميزة "إنشاء النصوص" في creative_features_spec.

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

واجهة API لمقاطع الفيديو على Instagram: التحميل القابل للاستئناف على واجهة API لمقاطع الفيديو على Instagram

بدءًا من 15 مايو 2024، ستدعم ميزة "بروتوكول التحميل القابل للاستئناف" الجديدة نشر مقاطع فيديو على Instagram (على سبيل المثال، مقاطع ريلز ومقاطع فيديو القصص ومقاطع الفيديو الدوّارة) من كلٍ من مقاطع الفيديو الشخصية ومقاطع الفيديو التي يتم استضافتها على عنوان URL عام. يساعد هذا البروتوكول الجديد على تحميل الملف على الأجهزة الشخصية وتحميل مقاطع الفيديو الطويلة لمقاطع ريلز فقط (على سبيل المثال، 15 دقيقة بحد أقصى)، واستئناف عملية تحميل بعد انقطاع الشبكة أو أي فشل في النقل.

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

يمكن العثور على تفاصيل دفق نشر المحتوى المحسَّن في وثائق نشر المحتوى للمطوّرين بالإضافة إلى تفاصيل إضافية حول وسائط Instagram التي يمكن العثور عليها هنا.

واجهة Instagram Graph API: تأهيل أدوات القياس الجديدة

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

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

يُرجى إضافة مرجع إلى القائمة الكاملة بأدوات القياس هنا من أجل إضافة أدوات القياس الملائمة إلى " واجهة API GET" من أجل منشورات حاويات العناصر الدوّارة اليوم.

الجدول الزمني المحدَّث لإيقاف الاستخدام: واجهة API التحويل دون اتصال الخاصة بـMeta (OCAPI)

في العام الماضي، أعلنا أن الإصدار 17 من واجهة API التحويلات دون اتصال لن يدعم بعد ذلك الأحداث دون اتصال، كما توقعنا إيقاف واجهة API التحويلات دون اتصال في الربع الثالث من عام 2024. تم تحديث هذا المخطط الزمني لإيقاف الاستخدام منذ ذلك الحين ونؤكد أنه سيتم إيقاف استخدام واجهة API التحويلات دون اتصال (OCAPI) في مايو 2025. على الرغم من أن إيقاف استخدام واجهة API التحويلات دون اتصال قد تم تمديده من الربع الثالث لعام 2024 إلى مايو 2025، إلا أننا لا نزال نشجع المعلنين الذين يرسلون حاليًا أحداثًا دون اتصال عبر واجهة API التحويلات دون اتصال (OCAPI)، لمواصلة التخطيط لترحيل إعدادهم الحالي لبدء إرسال الأحداث دون اتصال من خلال واجهة API التحويلات (CAPI في وضع عدم الاتصال).

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

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

لن يتم دعم زر "حجز" بعد الآن في استدعاءات واجهة Messenger API، وسيبدأ تنفيذ ذلك فورًا. لا يؤثر هذا التغيير في القوالب والأزرار الأخرى، ولا يزال بإمكان الأنشطة التجارية إدارة الحجوزات باستخدام Meta Business Suite.

إيقاف إنشاء نوع إعلان الرسائل المدعومة في واجهة API التسويق

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

نوصي بمراجعة عمليات الدمج الحالية وضبط التطبيقات حسب الضرورة لضمان الانتقال السلس للمستخدمين.

إزالة الأطر الزمنية غير الحرجة لأدوات قياس المعلومات الديموغرافية للرؤى (عبر واجهة Instagram Graph API الخارجية)

أطلقنا في 21 مايو 2024 إصدار 20 من واجهة Instagram Graph API.

بعد 90 يومًا من هذا الإطلاق (أي 19 أغسطس 2024)، لن تقوم واجهة Graph API بمشاركة أدوات قياس المعلومات الديموغرافية حول أعضاء الجمهور المتفاعلين والذين تم الوصول إليهم ضمن أطر زمنية غير حرجة لواجهة Instagram Graph API (على سبيل المثال، معلومات توزيع البلدان والمدن والعمر والدولة خلال آخر 14 و90 يومًا).

ستظل واجهة Instagram Graph API تعرض المعلومات الديموغرافية للشهر الماضي (أي "this_month") والأسبوع الماضي (أي "this_week")، على غرار تلك الخاصة بتطبيق Instagram لضمان الاتساق عبر المنصات.

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

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

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

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

واجهة Graph API

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

  • 17 سبتمبر 2024: سيتم إيقاف استخدام واجهة Graph API بالإصدار 14.0 وإزالتها من المنصة.

  • 20 نوفمبر 2024: سيتم إيقاف استخدام واجهة Graph API بالإصدار 15.0 وإزالتها من المنصة.

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

  • 13 أغسطس 2024: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 18.0 وإزالتها من المنصة.

  • 4 فبراير 2025: سيتم إيقاف استخدام واجهة API التسويق بالإصدار 19.0 وإزالتها من المنصة.

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

مجموعة SDK من Meta للأعمال

طرح إصدار 20 من مجموعة SDK للأعمال من Meta

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

ونقدم في هذا الطرح دعمًا إضافيًا لواجهات Instagram API. وهي واجهة IGMediaForIGOnlyAPI وواجهة IGUserForIGOnlyAPI وواجهة IGRefreshAccessTokenForIGOnlyAPI وواجهة IGAccessTokenForIGOnlyAPI. وتُتيح تلك الواجهات المزيد من الأساليب بالإضافة إلى واجهات Instagram API الحالية التي تسمح لك بجلب الوسائط مباشرةً. نحن نهدف إلى تأهيل المزيد من واجهات API التي تغطي منتجات Meta الأخرى لإثراء نظام مجموعة SDK للأعمال.

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

  • مايو 2024: سيتم إيقاف استخدام الإصدار 13.0 من مجموعة SDK لمنصة فيسبوك أو الإصدارات الأقدم.