تغييرات لدعم "لائحة الإعلانات السياسية عن الاتحاد الأوروبي" في Display & Video 360 API وملفات البيانات المنظَّمة

الخميس 21 أغسطس 2025

ما الذي سيتغيّر؟

حسبما أعلنّا في العام الماضي، ستتوقف Google عن عرض الإعلانات السياسية في الاتحاد الأوروبي قبل بدء سريان لائحة تنظيمية جديدة في أكتوبر 2025. اعتبارًا من 8 سبتمبر 2025، ستبدأ واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" وملفات البيانات المنظَّمة (SDF) في طرح إجراءات التنفيذ المتعلّقة بهذا التغيير. إذا كنت تستخدم أيًا من هذين المنتجَين لإنشاء تفاصيل الإعلان أو إدارتها، قد تحتاج إلى تعديل تطبيقك للتعامل مع إجراءات التنفيذ هذه قبل 8 سبتمبر 2025 لتجنُّب انقطاع الخدمة.

خلفية

اعتبارًا من 8 سبتمبر 2025، ستطلب "مساحة العرض والفيديو 360" الإقرار الذاتي للإعلانات السياسية عن الاتحاد الأوروبي. عند إنشاء تفاصيل إعلان، عليك الإفصاح عمّا إذا كان سيعرض إعلانات سياسية عن الاتحاد الأوروبي.

يمكنك أيضًا تقديم هذا البيان للمعلِن ككل. سيشير هذا البيان إلى ما إذا كانت أيّ بنود إعلانية تابعة للمعلِن ستعرض إعلانات سياسية عن الاتحاد الأوروبي. قدِّم البيان على مستوى المعلِن باستخدام Display & Video 360 API أو ضمن إعدادات التفاصيل الأساسية للمعلِن في واجهة مستخدم "مساحة العرض والفيديو 360" بعد إطلاقها في 8 سبتمبر. إذا أعلنت أنّ المعلِن لن يعرض إعلانات سياسية عن الاتحاد الأوروبي، ستستخدم العناصر الإعلانية الجديدة التابعة لهذا المعلِن هذا البيان في حال عدم تقديم بيان آخر، وذلك لتجنُّب انقطاع الخدمة.

أضافت واجهة برمجة التطبيقات Display & Video 360 API وملفات البيانات المنظَّمة إمكانية الإفصاح عمّا إذا كان عنصر معيّن يعرض إعلانات سياسية عن الاتحاد الأوروبي. سيتم إطلاق ميزة الإقرار الذاتي في واجهة مستخدم "مساحة العرض والفيديو 360" اعتبارًا من 8 سبتمبر 2025.

Display & Video 360 API

في Display & Video 360 API، تمت إضافة الحقل containsEuPoliticalAds إلى عناصر واجهة برمجة التطبيقات التالية في الإصدارَين 3 و4 لعرض البيان الذاتي على مستويات مختلفة من الموارد:

• كائنات LineItem للحصول على البيان وضبطه على مستوى العنصر.
• Advertiser للحصول على البيان وضبطه على مستوى المعلِن.

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

القيمة	المعنى
CONTAINS_EU_POLITICAL_ADVERTISING	سيتم استخدام المرجع لعرض إعلانات سياسية عن الاتحاد الأوروبي.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	لن يتم استخدام المرجع لعرض إعلانات سياسية عن الاتحاد الأوروبي.

اعتبارًا من 8 سبتمبر 2025، ستتطلّب واجهة Display & Video 360 API ضبط الحقل containsEuPoliticalAds لموارد البنود الإعلانية الجديدة أو لموارد البنود الإعلانية الحالية عند تعديل الاستهداف حسب الموقع الجغرافي للبنود الإعلانية الحالية.

ما هو الإجراء الواجب اتّخاذه؟

يجب أن يتضمّن كل تفصيل إعلان جديد يتم إنشاؤه بيانًا صالحًا باستخدام الحقل containsEuPoliticalAds.

اضبط حقل containsEuPoliticalAds في عنصر Advertiser باستخدام طريقة advertisers.patch، أو اضبط البيان ضمن إعدادات التفاصيل الأساسية للمعلِن في واجهة مستخدم "مساحة العرض والفيديو 360" بعد توفّرها. إذا ضبطت حقل containsEuPoliticalAds على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING للمعلِن الرئيسي، ستستخدم تفاصيل العناصر الجديدة هذه القيمة ما لم يتم ضبط قيمة أخرى عند الإنشاء، وسيتم ملء الحقل تلقائيًا لتفاصيل العناصر الحالية في غضون يوم واحد. ويمكن بعد ذلك تعديل هذا الحقل باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات أو ملفات البيانات المنظَّمة.

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

• اضبط الحقل containsEuPoliticalAds في مورد البند الإعلاني الجديد عند تقديم طلب advertisers.lineItems.create.
• اضبط الحقل containsEuPoliticalAds في نص الطلب عند إرسال طلبَي advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault.
• اضبط الحقل containsEuPoliticalAds في موارد تفاصيل الإعلان الحالية باستخدام طلب advertisers.lineItems.patch قبل تعديل الاستهداف الجغرافي لتفاصيل الإعلان هذه. يشمل الاستهداف الجغرافي أنواع الاستهداف التالية:
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN
  • TARGETING_TYPE_REGIONAL_LOCATION_LIST
  • TARGETING_TYPE_PROXIMITY_LOCATION_LIST

ملفات البيانات المنظَّمة

في ملفات البيانات المنظَّمة، أطلقنا v9 الذي يضيف العمود Contains EU Political Ads إلى ملف البند الإعلاني. يتيح ذلك استرداد بيان الإعلانات السياسية عن الاتحاد الأوروبي وضبطه على مستوى العنصر. يستخدم هذا العمود القيمتَين YES وNO لتمثيل بيان تفاصيل الإعلان.

مع هذا الإطلاق، سنوقف أيضًا الإصدارات 7.1 و8 و8.1 من ملفات البيانات المنظَّمة، وننصحك بالانتقال إلى الإصدار 9 في أقرب وقت ممكن. سنواصل إتاحة هذه الإصدارات إلى أن نوقفها نهائيًا في مارس 2026.

اعتبارًا من 8 سبتمبر 2025، ستطلب منك "مساحة العرض والفيديو 360" استخدام الإصدار 9 لتحميل ملفات البيانات المنظَّمة وضبط عمود Contains EU Political Ads على YES أو NO لإدخالات البنود الإعلانية الجديدة في ملفات البيانات المنظَّمة. إذا أعلن المعلِن أنّه لن يعرض إعلانات سياسية عن الاتحاد الأوروبي، يمكنك مواصلة استخدام الإصدارات السابقة لتحميل ملفات البيانات المنظَّمة.

ما هو الإجراء الواجب اتّخاذه؟

يجب أن يتضمّن كل تفصيل إعلان جديد يتم إنشاؤه بيانًا صالحًا باستخدام العمود Contains EU Political Ads.

اضبط حقل containsEuPoliticalAds في المعلِن باستخدام طريقة advertisers.patch في Display & Video 360 API، أو اضبط البيان ضمن إعدادات التفاصيل الأساسية للمعلِن في واجهة مستخدم "مساحة العرض والفيديو 360" عند توفّرها. إذا صرّحت بأنّ المعلِن لن يعرض إعلانات سياسية عن الاتحاد الأوروبي، ستستخدم العناصر الجديدة القيمة NO للعمود Contains EU Political Ads ما لم يتم ضبط قيمة أخرى عند الإنشاء، وسيتم ملء الحقل تلقائيًا للعناصر الحالية في غضون يوم واحد. يتيح لك ذلك استخدام الإصدار 7 أو 7.1 أو 8 أو 8.1 لتحميل ملفات البيانات المنظَّمة. بعد إنشاء تفاصيل الإعلان، يمكن تعديل هذا الحقل باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات أو ملفات البيانات المنظَّمة.

إذا لم تتمكّن من تقديم بيان الإفصاح على مستوى المعلِن أو إذا أقررت بأنّه قد يتم عرض إعلانات سياسية عن الاتحاد الأوروبي من خلال حساب المعلِن، يُرجى اتّباع الخطوات التالية قبل 8 سبتمبر 2025:

• يُرجى نقل البيانات لاستخدام الإصدار 9 من ملفات التعريف الهيكلية. يُرجى الاطّلاع على دليل نقل البيانات للحصول على التعليمات.
• اضبط عمود Contains EU Political Ads على YES أو NO في إدخالات تفاصيل الإعلان عند تحميل ملف تعريف الخدمة البسيط في الحالات التالية:
  • إنشاء بنود/أسطر جديدة
  • تعديل أيّ من الأعمدة التالية في البند الحالي:
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Geography Regional Location List Targeting - Include
  • Geography Regional Location List Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • يتم إنشاء مجموعات إعلانية جديدة باستخدام أعمدة Geography Targeting المحدّدة ضمن التفاصيل الإعلانية الحالية.
  • جارٍ تعديل أعمدة Geography Targeting للمجموعات الإعلانية ضمن البند الإعلاني الحالي.

بالإضافة إلى ذلك، إذا كنت تستخدم ملفات البيانات المنظَّمة، احرص على نقل بياناتك إلى الإصدار 9 قبل إيقاف جميع الإصدارات السابقة نهائيًا في مارس 2026.

كيف أحصل على المساعدة؟

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

- تريفور مولتشاي، فريق العمل لواجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"

التصنيفات: deprecation، display-video-360-api، structured-data-files