إيقاف الميزات المؤرشفة نهائيًا

يسرد هذا الجدول عمليات إيقاف الميزات التي تم الإعلان عنها والتي أثّرت في إصدارات واجهة برمجة التطبيقات أو ملفات البيانات المنظَّمة في "مساحة العرض والفيديو 360". وتوفّر هذه الرسالة تاريخ السريان الأوّلي ووصفًا لعملية الإيقاف النهائي مع الإجراءات المقترَحة وروابط تؤدي إلى المستندات ذات الصلة:

الميزة تاريخ السريان الأوّلي الوصف
قيود عناصر "مدى الوصول إلى الجمهور على YouTube" في SDF ‫24 مارس 2025

في 24 آذار (مارس) 2025، ستتطلّب "ملفات البيانات المنظَّمة" استخدام أشكال إعلانات أكثر شمولاً عند إنشاء أو تعديل بنود الحملات. ويعني هذا ما يلي:

  • لم يعُد الإصداران v6 وv7 من "تنسيق بيانات Google" يتيحان إنشاء إدخالات جديدة في ملف "البند الإعلاني" تتضمّن القيمة Subtype "الوصول".
  • يجب أن تستخدم الإدخالات الجديدة في ملفات السلعة في خط الإعلان بتنسيق SDF التي تتضمّن القيمة Subtype "الوصول إلى الجمهور" القيمة "متجاوب" في العمود TrueView Video Ad Formats. لا يمكن تعديل قيمة العمود TrueView Video Ad Formats في الإدخالات الحالية التي تتضمّن القيمة "الوصول" في العمود Subtype.
  • تتطلّب الإدخالات الجديدة في ملفات السلعة في "تنسيق بيانات Google" التي تتضمّن القيمة Subtype "الوصول" ملء العمود TrueView Video Ad Inventory Control.
خطأ جديد في عدم تطابق sdfdownloadtasks.create الشريك/المعلِن ‫6 مارس 2025

في 6 مارس 2025، ستبدأ طلبات sdfdownloadtasks.create التي تستخدم فلتر العنصر الرئيسي للفلترة حسب المعلِنين الذين ليسوا عناصر فرعية للمجموعة partnerId في عرض الخطأ 400.

تعديل على حجم الصفحة التلقائي firstAndThirdPartyAudiences.list ‫6 مارس 2025

في 6 مارس 2025، سيتم تعديل حجم الصفحة التلقائي لطلبات firstAndThirdPartyAudiences.list من 100 إلى 5000.

لتجنُّب انقطاع الخدمة، عدِّل عملية الدمج لضبط مَعلمة طلب البحث pageSize في طلبات firstAndThirdPartyAudiences.list على حجم الصفحة المفضّل لديك.

الاستهداف المحسّن للبنود الإعلانية باستخدام عروض الأسعار الثابتة ‫6 مارس 2025

في 6 مارس 2025:

  • ستؤدي الطلبات التي تنشئ موارد LineItem أو تعدّلها لضبط الحقل BiddingStrategy على fixedBid والحقل TargetingExpansionConfig على enableOptimizedTargeting إلى عرض الخطأ 400.
  • لن يتم إنشاء أو تعديل الإدخالات في ملفات البيانات المنظَّمة البند الإعلاني التي تتضمّن قيمة "ثابت" في عمود "نوع استراتيجية عروض الأسعار" وقيمة "صحيح" في عمود "الاستهداف المحسّن" عند تحميل الملف.
  • سيتم تعديل البنود الإعلانية الحالية التي تستخدم عروض الأسعار الثابتة لإيقاف ميزة "الاستهداف المحسّن".

لتجنُّب أي انقطاع في الخدمة، يُرجى اتّخاذ الإجراءات التالية:

  • عدِّل موارد البنود الإعلانية الحالية التي تستخدم كلاً من عروض الأسعار الثابتة والاستهداف المحسّن.
  • تأكَّد من أنّ عملية الدمج لا تضبط استراتيجية عروض أسعار ثابتة واستهداف محسّن عند إنشاء أو تعديل موارد عناصر الحملة باستخدام Display & Video 360 API أو ملفات البيانات المنظَّمة.
فترة تحديد عدد مرات الظهور التي تزيد عن 30 يومًا ‫28 فبراير 2025

في 28 فبراير 2025:

  • ستؤدي الطلبات التي تنشئ أو تعدّل الموارد LineItem وInsertionOrder وCampaign لاستخدام الكائن FrequencyCap مع الحقل timeUnit الذي تم ضبطه على TIME_UNIT_LIFETIME أو الحقل timeUnit الذي تم ضبطه على TIME_UNIT_MONTH والحقل timeUnitCount الذي تم ضبطه على 2 إلى عرض الخطأ 400.
  • لن يتم إنشاء أو تعديل الإدخالات في ملفات البيانات المنظَّمة للبنود الإعلانية وطلبات الإدراج والحملات التي تتضمّن قيمة "مدّة التكرار" في العمود "الفترة" على أنّها "مدى الحياة" أو قيمة "مدّة التكرار" في العمود "الفترة" على أنّها "أشهر" وقيمة "عدد مرات التكرار" في العمود "المبلغ" على أنّه "2" عند تحميل الملف.
  • سيتم تعديل الحملات الحالية وأوامر الإدراج وعناصر الحملة لاستخدام فترة تحديد عدد مرات الظهور بحدّ أقصى 30 يومًا.

لتجنُّب أي انقطاع في الخدمة، يُرجى اتّخاذ الإجراءات التالية:

  • عدِّل موارد الحملة وأمر الإدراج والبند الإعلاني الحالية التي تستخدم فترة تحديد عدد مرات الظهور تزيد عن 30 يومًا لتصبح 30 يومًا أو أقل.
  • تأكَّد من أنّ عملية الدمج لا تضبط فترة تحديد عدد مرات الظهور على أكثر من 30 يومًا عند إنشاء أو تعديل موارد الحملة أو طلب الإدراج أو البند الإعلاني باستخدام مساحة العرض والفيديو 360 API أو ملفات البيانات المنظَّمة.
عرض الإعلانات في أقرب وقت ممكن Pacing لطلبات الإدراج ‫5 نوفمبر 2024

اعتبارًا من 5 نوفمبر 2024، لن يكون PACING_TYPE_ASAP متوافقًا مع PACING_PERIOD_FLIGHT عند ضبط الحقل pacing الخاص بطلب الإدراج. سيتم تعديل pacingType لجميع أوامر الإدراج الحالية التي تتضمّن هذا الإعداد إلى PACING_TYPE_AHEAD.

لتجنُّب أي انقطاع في الخدمة، عدِّل pacing لأي أوامر إدراج حالية باستخدام PACING_TYPE_ASAP وPACING_PERIOD_FLIGHT.

الاستهداف المحسّن على مستوى البند الإعلاني لمجموعة فرعية من استراتيجيات عروض الأسعار ‫30 سبتمبر 2024

في 30 سبتمبر 2024، لن تكون مواد عرض LineItem التي تستخدم مجموعة فرعية من استراتيجيات عروض الأسعار متوافقة مع ميزة "الاستهداف المحسّن". بعد هذا التغيير، سيتم تعديل موارد LineItem التي تم ضبط targetingExpansion.enableOptimizedTargeting فيها على True وbidStrategy.maximizeSpendAutoBid.performanceGoalType على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA أو BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN أو BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED أو bidStrategy.performanceGoalAutoBid.performanceGoalType على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM، وذلك لضبط targetingExpansion.enableOptimizedTargeting على False.

لتجنُّب أي انقطاع في الخدمة، عدِّل وتأكَّد من أنّ بنود حملاتك التي تستخدم استراتيجيات عروض الأسعار هذه لا تتضمّن ميزة "الاستهداف المحسّن" مفعّلة.

شرائح جمهور الطرف الأول والجهات الخارجية في Oracle ‫30 سبتمبر 2024

في 30 سبتمبر 2024، سيتم إيقاف مصادر موارد FirstAndThirdPartyAudience من Oracle نهائيًا. عند إيقاف هذه الميزة نهائيًا، ستتم إزالة شرائح الجمهور هذه من أي استهداف حالي للموارد ومن الجمهور المجمّع. إذا كان البند الإعلاني يستهدف شرائح الجمهور التي سيتم إيقافها فقط أو يستهدف أيًا من شرائح الجمهور التي سيتم إيقافها بشكل سلبي، سيؤدي هذا التعديل إلى إيقاف هذا البند الإعلاني مؤقتًا تلقائيًا.

لتجنُّب أي انقطاع في الخدمة، حدِّد أي شرائح جمهور من Oracle وأزِلها من استهداف الجمهور الحالي على مستوى البند الإعلاني ومن شرائح الجمهور المدمَجة قبل تاريخ الإيقاف النهائي.

استهداف المحتوى في البنود الإعلانية على YouTube ومنصات الشركاء ‫30 سبتمبر 2024

في 30 سبتمبر 2024، سيتم إيقاف القيم التالية لأنواع الاستهداف المحدّدة نهائيًا في "عناصر YouTube والشركاء":

ستتم تلقائيًا إزالة خيارات الاستهداف التي سيتم إيقافها نهائيًا من استهداف البنود الحالية. ستظلّ هذه القيم متاحة للاستخدام في الاستهداف على مستوى المعلِن.

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

حقل publisherReviewStatuses في الموارد الإبداعية ‫26 يونيو 2024

اعتبارًا من 26 يونيو 2024، سيتم إيقاف الحقل publisherReviewStatuses نهائيًا، وسيكون فارغًا عند استرداد موارد Creative.

الشراء المستند إلى النتائج 1 أغسطس 2023

في 1 أغسطس 2023، سيتم أرشفة طلبات الإدراج التي تستخدم ميزة "الشراء المستند إلى النتائج"، والتي يتم تحديدها من خلال قيمة الحقل billableOutcome التي تبلغ BILLABLE_OUTCOME_PAY_PER_CLICK أو BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION، وبنود حملاتها الفرعية.

سيؤثّر هذا التغيير في الطلبات التالية:

إمكانية فلترة طلبات advertisers.lineItems.list حسب أربعة حقول إضافية ‫21 حزيران (يونيو) 2023

اعتبارًا من 21 يونيو 2023، لن تتيح advertisers.lineItems.list الفلترة حسب الحقول التالية:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

يجب إزالة جميع منطق الفلتر الذي يستخدم هذه الحقول الأربعة قبل 21 يونيو 2023 لتجنُّب انقطاع الخدمة.

إمكانية فلترة طلبات القائمة أو ترتيبها حسب الحقلَين budget.budget_segments.date_range.end_date وflight.dateRange.endDate

تم تعديل تاريخ السريان الأولي

‫21 حزيران (يونيو) 2023

في 21 يونيو 2023، لن يعود الحقلان budget.budget_segments.date_range.end_date وflight.dateRange.endDate من الحقول المقبولة في مَعلمتَي طلب البحث advertisers.insertionOrders.list وadvertisers.lineItems.list filter وorderBy على التوالي. بعد هذا التاريخ، ستؤدي الطلبات التي تستخدم هذه الحقول في مَعلمتَي طلب البحث filter وorderBy إلى عرض رسالة خطأ.

يجب إزالة جميع فلاتر وترتيبات البيانات التي تستخدم هذين الحقلين قبل 21 يونيو 2023 لتجنُّب انقطاع الخدمة.

استخدام عامل التشغيل OR بين قيود الحقول المختلفة في فلاتر LIST

‫21 حزيران (يونيو) 2023

اعتبارًا من 21 يونيو 2023، لن تسمح مَعلمات LIST الطلب filter بعد الآن باستخدام OR عوامل التشغيل المنطقية بين قيود الحقول المختلفة.

على سبيل المثال، يجب بدلاً من ذلك استرداد الموارد المحدّدة باستخدام سلسلة الفلترة lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" من خلال طلبَي LIST مع سلسلتَي الفلترة التاليتَين:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

يُرجى الرجوع إلى دليل كيفية فلترة طلبات LIST للحصول على مزيد من التفاصيل حول القيود المفروضة على عوامل التشغيل المنطقية.

راجِع مَعلمات طلب البحث filter لجميع طلبات LIST الحالية وتأكَّد من أنّها تستخدم عامل التشغيل المنطقي OR بشكل صحيح قبل 21 يونيو 2023 لتجنُّب انقطاع الخدمة.

حدود الحصة الحالية في واجهة برمجة التطبيقات ‫30 مايو 2023

في 30 أيار (مايو) 2023، سيتم استبدال حدود الاستخدام الحالية ببنية حصص مختلطة تنفّذ ما يلي:

  1. تزيل حصة الطلبات اليومية لكل مشروع.
  2. تفرض حصة طلبات في الدقيقة الواحدة لكل معلِن ولكل مشروع على الطرق المؤهّلة.

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

أنواع FirstAndThirdPartyAudience تحديد عدد مرات الظهور استنادًا إلى النشاط ‫20 مايو 2023

المخطّط الزمني:

  • ‫20 أيار (مايو) 2023: لن يعود بإمكانك تعيين موارد FirstAndThirdPartyAudience باستخدام AudienceType بقيمة ACTIVITY_BASED أو FREQUENCY_CAP لاستهداف الجمهور في بنود الحملات أو طلبات الإدراج. وستؤدي الطلبات التي تُعيّن هذه الشرائح إلى استهداف الجمهور في أحد عناصر الحملة إلى ظهور رسالة خطأ. ويشمل ذلك طلبات advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault، إذا كان البند الإعلاني الذي تم إنشاؤه سيتضمّن شرائح جمهور متوقّفة نهائيًا في استهداف الجمهور.
  • ‫8 حزيران (يونيو) 2023: ستتم إزالة شرائح الجمهور المتأثرة من جميع استهدافات البنود الإعلانية وطلبات الإدراج ومن جميع شرائح الجمهور المدمَجة. إذا لم يتمكّن بند إعلان من عرض الإعلانات عند إزالة شرائح الجمهور هذه، سيتم إيقافه مؤقتًا. في هذا التاريخ، لن يكون من الممكن أيضًا استرداد شرائح الجمهور هذه باستخدام خدمة firstAndThirdPartyAudiences.

المهام المقترَحة:

  • ننصحك بالتوقّف فورًا عن استخدام شرائح الجمهور المتأثّرة عند إجراء تعديلات مستقبلية على استهداف بندك الإعلاني.
  • أزِل جميع شرائح الجمهور المتأثّرة من استهداف البند الإعلاني وطلب الإدراج الحاليَين. يمكنك الاطّلاع على معلومات حول تعديل استهداف الجمهور في دليل الجماهير المستهدفة.
أنواع GoogleAudience التطبيقات المثبَّتة والأجهزة الجوّالة الجديدة ‫20 مايو 2023

المخطّط الزمني:

  • ‫20 أيار (مايو) 2023: لن يعود بإمكانك تعيين موارد GoogleAudience باستخدام GoogleAudienceType بقيمة GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS أو GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES لاستهداف الجمهور في بنود الحملات أو طلبات الإدراج. وستؤدي الطلبات التي تُعيّن هذه الشرائح إلى استهداف الجمهور في أحد عناصر الحملة إلى ظهور رسالة خطأ. ويشمل ذلك طلبات advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault، إذا كان البند الإعلاني الذي تم إنشاؤه سيتضمّن شرائح جمهور متوقّفة نهائيًا في استهداف الجمهور.
  • ‫8 حزيران (يونيو) 2023: ستتم إزالة شرائح الجمهور المتأثرة من جميع استهدافات البنود الإعلانية وطلبات الإدراج ومن جميع شرائح الجمهور المدمَجة. إذا لم يتمكّن بند إعلان من عرض الإعلانات عند إزالة شرائح الجمهور هذه، سيتم إيقافه مؤقتًا. في هذا التاريخ، لن يكون من الممكن أيضًا استرداد شرائح الجمهور هذه باستخدام خدمة googleAudiences.

المهام المقترَحة:

  • ننصحك بالتوقّف فورًا عن استخدام شرائح الجمهور المتأثّرة عند إجراء تعديلات مستقبلية على استهداف بندك الإعلاني.
  • أزِل جميع شرائح الجمهور المتأثّرة من استهداف البند الإعلاني وطلب الإدراج الحاليَين. يمكنك الاطّلاع على معلومات حول تعديل استهداف الجمهور في دليل الجماهير المستهدفة.
المشغّلات اليدوية ‫17 أيار (مايو) 2023

المخطّط الزمني:

  • ‫17 أيار (مايو) 2023: سيتوقف عرض عناصر الحملات التي تستخدم مشغّلات يدوية في "مساحة العرض والفيديو 360". إذا فعّلت مشغّلاً يدويًا مرتبطًا بعنصر نشط في الحملة بعد هذا التاريخ، لن يعرض عنصر الحملة إعلانات.
  • 1 أغسطس 2023: سيتم إيقاف خدمة advertisers.manualTriggers نهائيًا في الإصدار 1 والإصدار 2 من Display & Video 360 API، والقيمة التعدادية LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER في الإصدار 1 من Display & Video 360 API، والحقل LineItemFlight.triggerId في الإصدار 1 من Display & Video 360 API. بعد هذا التاريخ، ستؤدي الطلبات المُرسَلة إلى هذه الخدمات أو إلى هذه الحقول إلى ظهور رسالة خطأ.

الإجراءات المقترحة:

  • توقَّف فورًا عن استخدام المشغّلات اليدوية لبدء عرض البند الإعلاني وإيقافه.
  • التوقّف عن إرسال طلبات إلى خدمة advertisers.manualTriggers
  • عدِّل الحقلَين flight.flightDateType وflight.triggerId لجميع عناصر الحملة باستخدام المشغّلات اليدوية.
توسيع نطاق الاستهداف ‫25 مارس 2023 استبدال ميزة توسيع نطاق الاستهداف بميزة الاستهداف المحسّن، وتمّ طرحها تدريجيًا من 25 مارس 2023 إلى أوائل مايو 2023 تم الإعلان عن التغييرات ذات الصلة في سلوك واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360" وملفات البيانات المنظَّمة، بالإضافة إلى الإجراءات المقترَحة، في مشاركة على المدونة.