שינויים לתמיכה ב-European Union Political Ads Regulation (התקנה של האיחוד האירופי בנושא מודעות שקשורות לפוליטיקה בתחומי האיחוד, EU PAR) ב-Google Ads API ובסקריפטים של Google Ads

יום חמישי, 7 באוגוסט 2025

מה משתנה?

כמו שהודענו בשנה שעברה, Google תפסיק להציג פרסום פוליטי באיחוד האירופי, בהתאם לתקנה חדשה שתיכנס לתוקף באוקטובר 2025. ב-3 בספטמבר 2025, נפעיל ב-Google Ads API ובסקריפטים של Google Ads אכיפה שקשורה לשינוי הזה. אם אתם משתמשים באחד מהמוצרים האלה כדי ליצור או לנהל קמפיינים, יכול להיות שתצטרכו לעדכן את האפליקציה שלכם כדי לטפל באכיפות האלה לפני 3 בספטמבר 2025.

תמיכה ב-API בהצהרה עצמית לגבי מודעות שקשורות לפוליטיקה באיחוד האירופי

הוספנו ל-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

ב-3 בספטמבר 2025, נתחיל לאכוף את הבדיקות הבאות ב-Google Ads API ובסקריפטים של Google Ads בגרסאות v19 ו-v20 של ה-API.

• בכל הקמפיינים החדשים שנוצרים דרך Google Ads API או סקריפטים של Google Ads, צריך להגדיר את השדה contains_eu_political_advertising. הקריאה ל-API ליצירת קמפיין חדש באמצעות CampaignService.MutateCampaigns תיכשל עם שגיאת FieldError.REQUIRED אם השדה הזה לא מוגדר. סקריפטים של Google Ads יאכפו את הבדיקות האלה כשיוצרים קמפיינים באמצעות השיטות AdsApp.mutate או AdsApp.mutateAll.
• בכל הקמפיינים הקיימים צריך להגדיר את השדה contains_eu_political_advertising לפני שמנסים לשנות את הטירגוט לפי proximity, location, או location_group ברמת הקמפיין או ברמת קבוצת המודעות. הקריאה ל-API ליצירה או לעדכון של הקריטריונים האלה לקמפיינים קיימים באמצעות השיטה CampaignCriterionService.MutateCampaignCriteria תיכשל עם השגיאה CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION אם לא הושלמה ההצהרה העצמית בקמפיין. גם הקריאה ל-API ליצירה או לעדכון של הקריטריונים האלה של קבוצת המודעות באמצעות AdGroupCriterionService.MutateAdGroupCriteria תיכשל באופן דומה אם הקמפיין לא השלים את ההצהרה העצמית. הסקריפטים של Google Ads יאכפו את הבדיקות האלה כשמנסים לשנות את הטירגוט באמצעות השיטות AdsApp.mutate,‏ AdsApp.mutateAll,‏ AdsApp.Campaign.addProximity ו-AdsApp.Campaign.addLocation.
• האכיפה הזו חלה גם על מנגנונים אחרים שבהם אתם יכולים להשתמש כדי ליצור קמפיינים, כמו הפעלת משימות באצווה ושימוש ב-GoogleAdsService.Mutate כדי ליצור ולעדכן ישויות.
• אם תנסו לתזמן ניסוי חדש באמצעות השיטה ExperimentService.ScheduleExperiment, תופיע השגיאה ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION אם השדה contains_eu_political_advertising declaration חסר בטיוטות של קמפיינים לניסוי.
• אם אתם משתמשים בתכונה "העלאה בכמות גדולה" בסקריפטים של Google Ads, כדאי לעיין בתיעוד המוצר כדי לקבל מידע נוסף על השינויים שצריך לבצע בתבנית הגיליון האלקטרוני כחלק מהשינוי הזה.

הבדיקות האלה כבר נאכפות בגרסה v21 של Google Ads API.

איך זה ישפיע על הצגת המודעות בקמפיין?

כל קמפיין שמוגדרת בו הצהרה על מודעות שקשורות לפוליטיקה באיחוד האירופי (ההגדרה contains_eu_political_advertising מוגדרת כ- true) יפסיק להציג מודעות באיחוד האירופי ב-22 בספטמבר 2025.. מידע נוסף זמין במרכז העזרה.

קמפיינים קיימים בלי הצהרה לא יושפעו בינתיים. מומלץ לעדכן את הקמפיינים הקיימים בחשבונות שלך בהצהרה מתאימה בהקדם האפשרי. כדי לאחזר קמפיינים בלי הצהרה, אפשר להשתמש בשאילתת 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 כדי ליצור או לנהל קמפיינים, חשוב לעדכן את האפליקציה כך שתתמוך באכיפה הזו לפני 3 בספטמבר 2025.

איך אפשר לקבל עזרה?

אם יש לכם שאלות נוספות לגבי השינוי הזה, אתם יכולים לפנות לערוצי התמיכה ב-Google Ads API או התמיכה בסקריפטים של Google Ads.

 – Anash P. אומן, צוות Google Ads API

תוויות: campaign, google-ads-api, google-ads-scripts