‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

تغییرات برای پشتیبانی از «مقررات تبلیغات سیاسی اتحادیه اروپا» در Display & Video 360 API و «فایل‌های داده ساختاریافته»

پنجشنبه، ۲۱ اوت ۲۰۲۵

چه چیزی تغییر می‌کند؟

همان‌طور که سال گذشته اعلام شد، Google پیش‌از اجرایی شدن مقررات جدید در اکتبر ۲۰۲۵، ارائه تبلیغات سیاسی را در اتحادیه اروپا متوقف خواهد کرد. از ۸ سپتامبر ۲۰۲۵، Display & Video 360 API و فایل‌های داده ساختاریافته (SDF) اجراهای مربوط به این تغییر را عرضه خواهند کرد. اگر از هریک از این محصولات برای ایجاد یا مدیریت ردیف‌های آگهی استفاده می‌کنید، ممکن است لازم باشد برنامه‌تان را به‌روز کنید تا این اجراها را قبل‌از ۸ سپتامبر ۲۰۲۵ مدیریت کند تا از وقفه در سرویس جلوگیری شود.

پس‌زمینه

از ۸ سپتامبر ۲۰۲۵، Display & Video 360 برای آگهی‌های سیاسی اتحادیه اروپا خوداظهاری را الزامی خواهد کرد. هنگام ایجاد ردیف، باید اعلام کنید که آیا این ردیف آگهی‌های سیاسی اتحادیه اروپا را ارائه خواهد داد یا نه.

همچنین می‌توانید این اظهارنامه را برای کل تبلیغ‌کننده ارائه دهید. این اظهارنامه مشخص می‌کند که آیا هیچ‌کدام از سطرهای هدف تحت تبلیغ‌کننده آگهی‌های سیاسی اتحادیه اروپا را ارائه خواهند کرد یا نه. این اظهارنامه را در سطح تبلیغ‌کننده بااستفاده از Display & Video 360 API یا در تنظیمات جزئیات پایه تبلیغ‌کننده در Display & Video 360 UI پس‌از راه‌اندازی آن در ۸ سپتامبر ارائه دهید. اگر اعلام کنید که تبلیغ‌کننده شما آگهی‌های سیاسی اتحادیه اروپا را ارائه نخواهد کرد، سطرهای هدف جدید تحت آن تبلیغ‌کننده از آن اعلامیه استفاده خواهند کرد، مگر اینکه اعلامیه دیگری ارائه شود، تا از وقفه در سرویس جلوگیری شود.

Display & Video 360 API و Structured Data Files پشتیبانی از اعلام اینکه آیا یک ردیف آگهی آگهی‌های سیاسی اتحادیه اروپا را ارائه می‌دهد یا نه را اضافه کرده‌اند. پشتیبانی مشابهی برای خوداظهاری از ۸ سپتامبر ۲۰۲۵ در میانای کاربری Display & Video 360 راه‌اندازی خواهد شد.

Display & Video 360 API

در Display & Video 360 API، فیلد containsEuPoliticalAds به اشیاء API زیر در نسخه ۳ و ۴ اضافه شده است تا خوداظهاری را در سطوح مختلف منابع نشان دهد:

LineItem شیء برای دریافت و تنظیم اظهارنامه در سطح مورد خطی.
Advertiser برای دریافت و تنظیم اظهارنامه در سطح آگهی‌دهنده.

مقادیر قابل‌تنظیم احتمالی برای این فیلد در جدول زیر نشان داده شده است، با معنایی مرتبط با منبعی که به آن اختصاص داده شده است.

مقدار	معنی
`CONTAINS_EU_POLITICAL_ADVERTISING`	از این منبع برای ارائه آگهی‌های سیاسی اتحادیه اروپا استفاده خواهد شد.
`DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING`	از این منبع برای ارائه آگهی‌های سیاسی اتحادیه اروپا استفاده نخواهد شد.

از ۸ سپتامبر ۲۰۲۵، Display & Video 360 API شروع به الزام تنظیم فیلد containsEuPoliticalAds برای منابع جدید ردیف آگهی یا برای منابع موجود ردیف آگهی هنگام به‌روزرسانی هدف‌یابی جغرافیایی ردیف‌های آگهی موجود خواهد کرد.

چه کاری باید انجام دهم؟

هر مورد خطی جدیدی که ایجاد می‌شود باید بااستفاده از فیلد containsEuPoliticalAds اظهارنامه معتبری داشته باشد.

فیلد containsEuPoliticalAds را در شیء Advertiser بااستفاده از روش advertisers.patch تنظیم کنید، یا پس‌از دردسترس قرار گرفتن، اظهارنامه را در تنظیمات جزئیات پایه آگهی‌دهنده در میانای کاربری Display & Video 360 تنظیم کنید. اگر فیلد containsEuPoliticalAds را برای تبلیغ‌کننده اصلی روی DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING تنظیم کنید، موارد خطی جدید از آن مقدار استفاده خواهند کرد مگراینکه مقدار دیگری در زمان ایجاد تنظیم شود، و فیلد برای موارد خطی موجود ظرف یک روز تکمیل خواهد شد. سپس این فیلد را می‌توان بااستفاده از واسط کاربر، API، یا «فایل‌های داده ساختاریافته» به‌روز کرد.

اگر تبلیغ‌کننده شما آگهی‌های سیاسی اتحادیه اروپا را ارائه نمی‌دهد، اظهار کردن در سطح تبلیغ‌کننده برای جلوگیری از خطا کافی خواهد بود. اگر نمی‌توانید در سطح تبلیغ‌کننده اعلام کنید یا اعلام کرده‌اید که آگهی‌های سیاسی اتحادیه اروپا ممکن است تحت تبلیغ‌کننده شما ارائه شود، باید استفاده خود از روش‌های API زیر را به‌روز کنید:

هنگام درخواست advertisers.lineItems.create، فیلد containsEuPoliticalAds را در منبع ردیف هدف جدید تنظیم کنید.
هنگام ایجاد درخواست‌های advertisers.lineItems.duplicate و advertisers.lineItems.generateDefault، فیلد containsEuPoliticalAds را در بدنه درخواست تنظیم کنید.
قبل‌از به‌روزرسانی هدف‌یابی جغرافیایی برای آن ردیف‌های هدف، فیلد 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 برای نمایش اظهارنامه مورد خطی استفاده می‌کند.

با این راه‌اندازی، نسخه‌های ۷.۱، ۸، و ۸.۱ از SDF را نیز منسوخ می‌کنیم و توصیه می‌کنیم در اولین فرصت به نسخه ۹ مهاجرت کنید. ما از این نسخه‌ها تا زمان توقف پشتیبانی آن‌ها در مارس ۲۰۲۶ پشتیبانی خواهیم کرد.

از ۸ سپتامبر ۲۰۲۵، «Display & Video 360» از شما می‌خواهد که برای بارگذاری «فایل‌های داده ساختاریافته» از نسخه ۹ استفاده کنید و ستون Contains EU Political Ads را برای ورودی‌های جدید ردیف SDF روی YES یا NO تنظیم کنید. اگر تبلیغ‌کننده شما اعلام کرده است که آگهی‌های سیاسی اتحادیه اروپا را ارائه نخواهد کرد، می‌توانید همچنان از نسخه‌های قبلی برای بارگذاری SDF استفاده کنید.

چه کاری باید انجام دهم؟

هر مورد خطی جدیدی که ایجاد می‌شود باید بااستفاده از ستون Contains EU Political Ads اظهارنامه معتبری داشته باشد.

فیلد containsEuPoliticalAds را در آگهی‌دهنده بااستفاده از روش advertisers.patch در Display & Video 360 API تنظیم کنید، یا پس‌از دردسترس قرار گرفتن، اظهارنامه را در تنظیمات جزئیات اصلی آگهی‌دهنده در Display & Video 360 UI تنظیم کنید. اگر اعلام کنید که تبلیغ‌کننده آگهی‌های سیاسی اتحادیه اروپا را ارائه نخواهد کرد، ردیف‌های جدید از مقدار NO برای ستون Contains EU Political Ads استفاده خواهند کرد، مگراینکه مقدار دیگری در زمان ایجاد تنظیم شود، و این فیلد برای ردیف‌های موجود ظرف یک روز تکمیل خواهد شد. این به شما امکان می‌دهد از نسخه ۷، ۷.۱، ۸، یا ۸.۱ برای بارگذاری SDF استفاده کنید. پس‌از ایجاد مورد خطی، این فیلد را می‌توان بااستفاده از میانای کاربر، میانای برنامه‌سازی کاربردی، یا «فایل‌های داده ساختاریافته» به‌روز کرد.

اگر نمی‌توانید در سطح آگهی‌دهنده اظهار کنید یا اظهار کرده‌اید که آگهی‌های سیاسی اتحادیه اروپا ممکن است تحت آگهی‌دهنده شما ارائه شود، قبل‌از ۸ سپتامبر ۲۰۲۵ کارهای زیر را انجام دهید:

به استفاده از SDF v9 مهاجرت کنید. برای دستورالعمل‌ها، راهنمای انتقال ما را ببینید.
ستون Contains EU Political Ads را روی YES یا NO در ورودی‌های ردیف هدف در بارگذاری SDF تنظیم کنید وقتی:
- درحال ایجاد کردن اقلام ردیفی جدید.
- به‌روزرسانی هرکدام از ستون‌های زیر در ردیف موجود:
- درحال ایجاد گروه‌های آگهی جدید با ستون‌های Geography Targeting تنظیم‌شده در زیر مورد خطی موجود.
- درحال به‌روزرسانی ستون‌های Geography Targeting گروه‌های آگهی تحت مورد خطی موجود.

همچنین، اگر از «فایل‌های داده ساختاریافته» استفاده می‌کنید، حتماً قبل‌از اینکه همه نسخه‌های قبلی در مارس ۲۰۲۶ منسوخ شوند، به نسخه ۹ مهاجرت کنید.

چگونه راهنمایی دریافت کنم؟

اگر درباره این تغییر سؤال بیشتری دارید، با کانال‌های پشتیبانی Display & Video 360 API تماس بگیرید.

- Trevor Mulchay، تیم Display & Video 360 API

برچسب‌ها: deprecation، display-video-360-api، structured-data-files