تغییرات برای پشتیبانی از «مقررات تبلیغات سیاسی اتحادیه اروپا» در Google Ads API و جاوااسکریپت Google Ads

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

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

همان‌طور که سال گذشته اعلام شد، Google پیش‌از اجرایی شدن مقررات جدید در اکتبر ۲۰۲۵، ارائه تبلیغات سیاسی را در اتحادیه اروپا متوقف خواهد کرد. در ۳ سپتامبر ۲۰۲۵، Google Ads API و جاوااسکریپت Google Ads اقدامات اجرایی مربوط به این تغییر را عرضه خواهند کرد. اگر از هریک از این محصولات برای ایجاد یا مدیریت پویش‌ها استفاده می‌کنید، ممکن است لازم باشد برنامه خود را پیش‌از ۳ سپتامبر ۲۰۲۵ به‌روز کنید تا بتوانید این اقدامات اجرایی را مدیریت کنید.

پشتیبانی میانای برنامه‌سازی کاربردی برای خوداظهاری آگهی‌های سیاسی اتحادیه اروپا

‫Google Ads API و جاوااسکریپت Google Ads پشتیبانی از خوداظهاری درباره اینکه آیا پویشی دارای آگهی‌های سیاسی اتحادیه اروپا است یا نه را اضافه کرده‌اند. تعریف آگهی سیاسی اتحادیه اروپا را در اینجا یاد بگیرید. نسخه‌های v19.2،‏ v20.1، و v21 از API حاوی فیلد جدیدی به‌نام contains_eu_political_advertising در شیء Campaign هستند. مقادیر ممکن و معنی آن‌ها در جدول زیر نشان داده شده است.

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

می‌توانید وضعیت خوداظهاری پویشی را در Google Ads API با اجرای پُرسمان زیر بااستفاده از روش‌های Search یا SearchStream از GoogleAdsService بازیابی کنید. برای «اسکریپت‌های Google Ads»، از روش‌های AdsApp.search یا AdsApp.report استفاده کنید. 

select campaign.id, campaign.contains_eu_political_advertising from campaign

اگر از کتابخانه‌های کارخواه Google Ads API استفاده می‌کنید، ممکن است لازم باشد جدیدترین نسخه کتابخانه را بارگیری کنید تا بتوانید از این عملکرد در نسخه‌های v19 و v20 از API استفاده کنید.

تغییرات در اعتبارسنجی و اجرای API

در ۳ سپتامبر ۲۰۲۵، Google Ads API و جاوااسکریپت Google Ads شروع به اعمال بررسی‌های زیر در نسخه‌های v19 و v20 از میانای برنامه‌سازی کاربردی خواهند کرد.

  • همه پویش‌های جدیدی که ازطریق Google Ads API یا جاوااسکریپت Google Ads ایجاد می‌شوند باید فیلد contains_eu_political_advertising را تنظیم کنند. اگر این فیلد تنظیم نشده باشد، فراخوانی میانای برنامه‌سازی کاربردی برای ایجاد کمپین جدید بااستفاده از CampaignService.MutateCampaigns با خطای FieldError.REQUIRED مواجه خواهد شد. «جاوااسکریپت Google Ads» هنگام ایجاد پویش بااستفاده از روش‌های AdsApp.mutate یا AdsApp.mutateAll این بررسی‌ها را اعمال خواهد کرد.
  • همه پویش‌های موجود باید فیلد contains_eu_political_advertising را قبل‌از تلاش برای تغییر هدف‌یابی proximity, location, یا location_group در سطح پویش یا گروه آگهی تنظیم کنند. اگر پویش خوداظهاری را تکمیل نکرده باشد، فراخوانی میانای برنامه‌سازی کاربردی برای ایجاد یا به‌روزرسانی این معیارهای پویش بااستفاده از روش CampaignCriterionService.MutateCampaignCriteria برای پویش‌های موجود با خطای CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION مواجه خواهد شد. اگر کمپین خوداظهاری را تکمیل نکرده باشد، فراخوانی میانای برنامه‌سازی کاربردی برای ایجاد یا به‌روزرسانی این معیارهای گروه آگهی بااستفاده از AdGroupCriterionService.MutateAdGroupCriteria نیز به‌طور مشابه ناموفق خواهد بود. جاوااسکریپت Google Ads این بررسی‌ها را هنگام تلاش برای تغییر هدف‌یابی بااستفاده از روش‌های AdsApp.mutate، AdsApp.mutateAll، AdsApp.Campaign.addProximity، و AdsApp.Campaign.addLocation اعمال خواهد کرد.
  • این اجراها برای سازوکارهای دیگری که می‌توانید برای ساختن پویش‌ها استفاده کنید نیز اعمال می‌شود، مثل اجرای کارهای دسته‌ای و استفاده از روش GoogleAdsService.Mutate برای ایجاد و به‌روزرسانی نهادها.
  • اگر contains_eu_political_advertising declaration در پویش‌های پیش‌نویس درمان وجود نداشته باشد، تلاش برای زمان‌بندی آزمایش جدید بااستفاده از روش ExperimentService.ScheduleExperiment خطای ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ایجاد می‌کند.
  • اگر از ویژگی بارگذاری انبوه در جاوااسکریپت Google Ads استفاده می‌کنید، برای کسب اطلاعات بیشتر درباره تغییرات الگوی صفحه‌گسترده که به‌عنوان بخشی از این تغییر لازم است، به اسناد محصول مراجعه کنید.

این بررسی‌ها ازقبل در نسخه v21 از Google Ads API اعمال شده است.

این امر چگونه بر ارائه کمپین من تأثیر می‌گذارد؟

هر پویشی که با تنظیم contains_eu_political_advertising روی true، آگهی‌های سیاسی اتحادیه اروپا را اعلام کرده باشد، در ۲۲ سپتامبر ۲۰۲۵. ارائه آگهی در اتحادیه اروپا را متوقف خواهد کرد. برای کسب اطلاعات بیشتر، به مرکز راهنمایی ما مراجعه کنید.

پویش‌های فعلی بدون اظهارنامه درحال‌حاضر تحت تأثیر قرار نخواهند گرفت. توصیه می‌کنیم در اسرع وقت کمپین‌های موجود در حساب‌هایتان را با اظهارنامه مناسب به‌روز کنید. می‌توانید پویش‌های بدون اظهارنامه را بااستفاده از پُرسمان GAQL زیر و بااستفاده از روش‌های Search یا SearchStream از GoogleAdsService بازیابی کنید. 

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

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

اگر برنامه‌تان از Google Ads API یا جاوااسکریپت Google Ads برای ایجاد یا مدیریت کمپین‌ها استفاده می‌کند، حتماً برنامه‌تان را پیش‌از ۳ سپتامبر ۲۰۲۵ به‌روز کنید تا این موارد اجرایی را مدیریت کند.

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

اگر درباره این تغییر سؤال بیشتری دارید، با کانال‌های پشتیبانی Google Ads API یا پشتیبانی جاوااسکریپت Google Ads تماس بگیرید.

پرتره نویسنده - ، تیم Google Ads API

برچسب‌ها: campaign، google-ads-api، google-ads-scripts