Google Ads API v23: פירוט ערוצים ל-Performance Max ושינויים שוברים לסקריפטים
ב-28 בינואר 2026 הוציאה Google את Ads API v23: נתוני ערוצים ל-Performance Max, חשבוניות מפורטות ושינוי בשדות התאריך. סקריפטים וכלי דיווח צריכים עדכון.
TL;DR בקצרה
- Google הוציאה ב-28 בינואר 2026 את Google Ads API v23, הגרסה הראשונה של 2026, והודיעה על מעבר למחזור שחרור מהיר.
- ב-PMax אפשר לקבל נתונים לפי Google Search, Search Partners, Gmail, YouTube, Display, Discover ו-Maps. קודם הוחזר MIXED.
- שינויים שוברים כוללים הסרת CallAd, איסור שיתוף מודעות בין קבוצות והחלפת start_date ו-end_date בשדות עם שעה.
- ל-v23 הוגדר מועד סיום משוער בפברואר 2027, לפי טבלת ההוצאה משימוש של Google.
ב-28 בינואר 2026 הוציאה Google את Ads API v23, גרסה 23 של Google Ads API. זו הגרסה הראשונה של 2026, והיא פותחת מעבר למחזור שחרור מהיר. היא כוללת דוח ערוצים ל-Performance Max, פירוט רחב של חשבוניות ושינוי בשדות התאריך של קמפיינים. מי שמריץ סקריפטים או כלי דיווח צריך לעדכן ספריות וקוד.
מה חדש ב-Ads API v23
לפי הבלוג של צוות ה-API, הגרסה מוסיפה כמה יכולות. אפשר לקבל פירוט ערוצים בקמפייני PMax. החשבוניות יכולות לכלול פירוט ברמת קמפיין, עלויות רגולטוריות ופרטי התאמות. פרטי מיקום חנויות זמינים ב-PerStoreView.
יש גם שיטה חדשה, GenerateAudienceDefinition. היא מתרגמת תיאור חופשי של קהל יעד לתכונות קהל בעזרת AI גנרטיבי. מימד Life Events מצטרף לבניית קהלים. בקמפייני Demand Gen אפשר לקבל הערכות המרה לפי משטחים כמו Gmail ו-Shorts.
בצד השני יש שינויים שוברים, לפי הערות הגרסה. שיתוף מודעה בין כמה קבוצות מודעות כבר אינו אפשרי, ובקשה כזו מחזירה שגיאה. Google הסירה את התמיכה ב-CallAd. היא גם הסירה מדדי תוויות ביצועים מצטברים של נכסים. את start_date ו-end_date של קמפיין היא החליפה ב-start_date_time ו-end_date_time.
דוח ערוצים ל-Performance Max ב-Ads API v23
הצוות מגדיר דוח ערוצים ל-Performance Max כאחת היכולות המבוקשות ביותר. מ-v23 אפשר לקבל נתוני ביצועים לפי Google Search, Search Partners, Gmail, YouTube, Display, Discover ו-Maps. הנתונים זמינים ברמת הקמפיין, קבוצת הנכסים והנכס.
בגרסאות קודמות החזיר הסגמנט ad_network_type בקמפייני PMax בדרך כלל את הערך MIXED. ב-v23 הוא מחזיר ערוצים ספציפיים. הצוות מציין שזה שינוי משמעותי בהתנהגות. הוא ממליץ לוודא שמערכות הדיווח יודעות לטפל בערכים החדשים.
יש שני סייגים. נתוני ערוצים זמינים רק לתאריכים מ-1 ביוני 2025. ובדוחות ברמת קבוצת נכסים, פירוט הערוצים זמין רק ב-API ולא בממשק האינטרנט של Google Ads. אפשר לשלב אותו עם הסגמנטים ad_using_product_data ו-ad_using_video, שהגיעו ב-v22.
איך מתכננים את השדרוג ל-v23
כדי להשתמש בחלק מהיכולות צריך לשדרג ספריות לקוח וקוד, וגם דוגמאות הקוד עודכנו. לפי טבלת ההוצאה משימוש של Google, ל-v23 הוגדר מועד סיום משוער בפברואר 2027. התאריך עשוי להשתנות.
מה קרה מאז: לפי הערות הגרסה, ב-22 באפריל 2026 יצאה גרסה 24, וב-14 באוקטובר 2026 גרסה 26. בין לבין יצאו גרסאות משנה של v23, ב-25 בפברואר, ב-25 במרץ וב-24 ביוני. אף אחת מהן לא כללה שינויים שוברים.
מה זה אומר עבורכם
- בדקו את המנתחים: אם הסקריפט שלכם מצפה לערך MIXED ב-ad_network_type, עדכנו אותו לערוצים של v23.
- סרקו את הקוד לשדות שהוסרו: חפשו start_date, end_date, CallAd ושיתוף מודעות בין קבוצות. אלה ישברו בשדרוג.
- הפיקו דוחות לפי ערוץ: אם אתם סוכנות, משכו נתוני PMax לפי ערוץ וקבוצת נכסים. בדקו מאיפה מגיעות ההמרות. זכרו שיש נתונים רק מ-1 ביוני 2025.
- השתמשו בחשבוניות המפורטות: הגדרת include_granular_level_invoice_details מחזירה פירוט ברמת קמפיין, והיא יכולה לעזור בהתאמת חשבוניות.
- שאלו את ספקי הכלים: אם אתם לא מפתחים, שאלו את הסוכנות או את ספק הדיווח אם הם תומכים בפירוט הערוצים של v23.
מקורות והרחבה
- Announcing v23 of the Google Ads APIGoogle Ads Developer Blog
- Introducing channel-level reporting for Performance Max campaignsGoogle Ads Developer Blog
- Google Ads API release notesGoogle Ads API
- Deprecation and sunsetGoogle Ads API
הכתבה נכתבה במקור בעברית על ידי מערכת GEEKLIK, על בסיס המקורות שלמעלה ובדיקת העובדות מולם.
מצאתם טעות? דווחו לנו
