הכרזה על גרסה 24 של Google Ads API

יום רביעי, 22 באפריל 2026

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

אנחנו מזמינים אתכם להצטרף אלינו להדרכה בשידור חי על הגרסה הזו באירוע "Google Ads API Release Highlights" בדיסקורד, ב-Ads Developers YouTube בשידור חי או באירוע LinkedIn Live מחר (23 באפריל בשעה 10:00 לפי שעון החוף המזרחי). האירועים גם יוקלטו ויפורסמו ב-YouTube, לטובת מי שלא יוכלו להשתתף באירועים בשידור חי. אם יש לכם שאלות או שאתם רוצים לדון בפוסט הזה, אתם יכולים לפנות אלינו בערוץ ‎#ads-api ב-Discord.

תכונות חדשות

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

בגרסה 24 של Google Ads API נוספה תמיכה בתכונה הזו באופן הבא:

  • הוספנו משאב חדש, CartDataSalesView, שמאפשר לפלח את מדדי ההמרות לא רק לפי קליק על מוצר, אלא גם לפי המוצר שנמכר, באמצעות פלחים כמו product_sold_brand. הדוחות האלה מאפשרים למפרסמים לראות נתונים סטטיסטיים על המוצרים שהלקוחות קנו בפועל אחרי שלחצו על המודעות, גם אם המודעה הייתה למוצר אחר.
  • הוספנו כמה מדדים "כוללים" שלא ניתן להגיש עליהם הצעות מחיר. המדדים האלה כוללים גם את ההמרות שהקמפיינים לא עוברים אופטימיזציה פעילה למטרה שלהן, למשל all_cost_of_goods_sold_micros. המדדים החדשים נוספים לכל המשאבים שתומכים במדדים תואמים שניתן להגיש עליהם הצעות מחיר.
  • הוספנו את הפלח conversion_attribution_event_type למשאב ShoppingPerformanceView, כך שאפשר לבחור אותו עם נתוני עגלות הקניות ומדדי המרות אחרים. הפלח הזה מציין אם ההמרה משויכת לקליק או לצפייה, והוא נדרש כדי לזהות נתונים סטטיסטיים של נתוני עגלות קניות שנוצרו על ידי המרות בעקבות צפייה.

תכונות מעודכנות

גרסה v24 כוללת עדכונים לתכונות קיימות שמחייבים שינויים בקוד כשמשדרגים. אנחנו מתייחסים כאן לשינויים החשובים ביותר. הרשימה המלאה של השינויים מופיעה בהערות המוצר.

הגדרות של החרגת תוכן וידאו בקמפיינים: פישטנו את האפשרות לקבוע הגדרות של החרגת תוכן וידאו בקמפיינים ספציפיים. ההגדרה הזו זמינה ברמת הלקוח, והיא חלה על כל הקמפיינים. הגדרות החרגת התוכן האלה נועדו לתת לכם יותר שליטה ולעזור לכם להחריג סוגי תכנים שלא מתאימים למותג או לעסק שלכם, גם אם המדיניות שלנו לא אוסרת על פרסום תכנים כאלה. מידע נוסף על הגדרות החרגת תוכן של קטעי וידאו זמין בכתובת https://support.google.com/google-ads/answer/7515513.

שינויים ב-AudienceInsightsService: כחלק מארגון הקוד מחדש, העברנו את השדה InsightsAudience.topic_audience_combinations של הבקשה למרחב השמות common. יכול להיות שתצטרכו לעדכן את הוראות הייבוא בשפות תכנות מסוימות.

שינויים ב-ReachPlanService: כחלק מארגון הקוד מחדש, העברנו את השדה youtube_select_lineups מהשירות ReachPlanService.ListPlannableProducts. עכשיו אפשר לראות את ההרכבים בשדה youtube_select_lineup_targeting. חבילות ערוצים של YouTube Select הן מוצרים בהזמנה. לקוחות שעומדים בדרישות יכולים להשתמש בהן כדי לטרגט ערוצים באחוז הפופולריות העליון ב-YouTube. כך ניתן להציג את המודעות לקהלים שמביעים הכי הרבה עניין בשוק נתון. מידע נוסף

שינויים ב-ContentCreatorInsightsService: כחלק מארגון הקוד מחדש, הסרנו את השדה is_brand_connect_creator מהשירותים ContentCreatorInsightsService.GenerateCreatorInsights ו-ContentCreatorInsightsService.GenerateTrendingInsights.
במקום זאת, המשתמשים צריכים לחפש יוצר שהאפשרות CREATOR_PARTNERSHIPS זמינה אצלו ב-partnership_opportunities. החבילה לשיפור השותפות עם יוצרים ב-YouTube שזמינה ב-Google Ads היא המקום שבו אתם יכולים למצוא יוצרים ב-YouTube כדי לעבוד איתם על תוכן ממומן, ולנהל ביעילות את השותפויות עם היוצרים. מידע נוסף

שינויים ב-KeywordPlanIdeaService: כדי לספק חוויה יעילה ואמינה יותר, איחדנו את תשתית החיזוי שלנו. בגרסה 24 של Google Ads API יש שיטה מעודכנת של GenerateKeywordForecastMetrics, שמפשטת את תהליך התכנון ומתמקדת במדדים שהכי משפיעים על הביצועים. בימים הקרובים נפרסם פוסט בבלוג עם פרטים נוספים על השינוי הזה.

שינויים במשאב campaign_budget: הסרנו את הפלח ad_sub_network_type מהמשאב campaign_budget כי הוא לא תואם לתצוגה הזו.

שינויים בתצוגות הנכסים: הסרנו את הפלח click_type מהתצוגות ad_group_asset,‏ campaign_asset ו-customer_asset. השינוי הזה תואם לשינוי שבוצע לאחרונה במוצר, שבמסגרתו הפלח הזה הוסר מ-Google Ads כדי למנוע מצג שווא של נתונים. אפשר להשתמש בפילוח click_type מהמשאב ad_group_ad כדי לקבל פרטים על ביצועי המודעה ועל הנכס שהיא הוצגה איתו.

שינויים במודעת הווידאו הרספונסיבית: VideoResponsiveAdInfo ניתנת עכשיו לשינוי. כחלק מהשינוי הזה, סימנו את videos,‏ business_name ו-logo_images כשדות חובה גם באובייקט DemandGenVideoResponsiveAdInfo וגם באובייקט VideoResponsiveAdInfo.

שינויים ב-ShareablePreviewService: השירות ShareablePreviewService.GenerateShareablePreviews עודכן כך שלא ישתמש יותר בכישלון חלקי. אם הבקשה תיכשל עבור מזהה כלשהו, תופיע הודעת שגיאה. מידע נוסף

מקורות המידע הבאים יעזרו לכם להתחיל:

לבעיות שקשורות לתמיכה טכנית, אפשר לפנות אל https://support.google.com/google-ads/contact/google_ads_api

תמונת דיוקן של המחבר – , צוות Google Ads API

תוויות: google-ads-api, release