הודעה על הוצאה משימוש

בדף הזה מפורטים תאריכי ההוצאה משימוש וההוצאה משימוש סופית של גרסאות API ושל תכונות נפרדות ב-Display & Video 360 API.

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

גרסאות שהוצאו משימוש

אנחנו משחררים גרסאות של Display & Video 360 API, מוציאים משימוש גרסאות קודמות ומסיימים את התמיכה בהן באופן קבוע. השלבים האלה מוגדרים כך:

  • גרסה: הגרסה יוצאת מסטטוס אלפא או בטא ונחשבת ליציבה. יכול להיות שעדיין יפורסמו תוספות לתכונות של הגרסה.
  • הוצאה משימוש: הגרסה יוצאת משימוש ומוצהר תאריך סיום התמיכה (sunset). המשתמשים צריכים לעבור לגרסה חדשה יותר לפני תאריך הסגירה. לא יתווספו יותר תכונות לגרסה הזו.
  • הוצאה משימוש: אין יותר תמיכה בגרסה. בקשות שנשלחות לגרסה הזו יחזירו שגיאה.

בטבלה הבאה מפורטות כל הגרסאות הקיימות של ממשק ה-API של Display & Video 360, תאריכי הפרסום שלהן ותאריכי ההוצאה משימוש וההוצאה משימוש סופית, אם פורסמו.

גרסת API תאריך פרסום תאריך ההוצאה משימוש תאריך הסגירה מדריך להעברת נתונים (מיגרציה)
v3 31 באוקטובר 2023
v2 6 בדצמבר 2022 15 בפברואר 2024 ‫3 בספטמבר 2024 מעבר מ-v2 ל-v3
v1 9 במרץ 2020 13 במרץ 2023 14 בספטמבר 2023 מעבר מ-v1 ל-v2

תכונות שהוצאו משימוש

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

בטבלה הבאה מפורטות כל ההודעות על הוצאה משימוש של תכונות, כולל תאריך הכניסה לתוקף הראשוני, תיאור ההוצאה משימוש, פעולות מומלצות וקישורים למסמכים הרלוונטיים:

תכונה מועד הכניסה לתוקף הראשוני תיאור
הרחבת הטירגוט 25 במרץ 2023 החלפת התכונה הרחבת הטירגוט באופטימיזציית טירגוט. ההשקה תתבצע בהדרגה מ-25 במרץ 2023 עד תחילת מאי 2023. בפוסט בבלוג פורסמו פרטים על השינויים הרלוונטיים בהתנהגות של Display & Video 360 API ושל קובצי נתונים מובְנים, וכן פעולות מומלצות.
טריגרים ידניים 17 במאי 2023

קו זמן‬

  • 17 במאי 2023: פריטים שמשתמשים בטריגרים ידניים יפסיקו להופיע ב-Display & Video 360. אם תפעילו טריגר ידני שמקושר לפריט פעיל אחרי התאריך הזה, המודעות לא יוצגו בפריט.
  • 1 באוגוסט 2023: השירות advertisers.manualTriggers בגרסה 1 ובגרסה 2 של DV360 API, ערך המניין LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER בגרסה 1 של DV360 API והשדה LineItemFlight.triggerId בגרסה 1 של DV360 API יוצאו משימוש. אחרי התאריך הזה, בקשות שיישלחו לשירותים האלה או לשדות האלה יחזירו שגיאה.

פעולות מומלצות:

  • להפסיק באופן מיידי את השימוש בטריגרים ידניים כדי להתחיל ולהפסיק את הצגת הפריטים.
  • מפסיקים לשלוח בקשות לשירות advertisers.manualTriggers.
  • מעדכנים את השדות flight.flightDateType ו-flight.triggerId לכל פריטי ה-Line Item באמצעות טריגרים ידניים.
סוגי GoogleAudience של אפליקציות מותקנות ומכשירים ניידים חדשים 20 במאי 2023

קו זמן‬

  • 20 במאי 2023: לא תוכלו יותר להקצות משאבים של GoogleAudience עם GoogleAudienceType של GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS או GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES לטירגוט לפי קהל של פריט שורה או של הזמנת קמפיין. בקשות להקצאת הקהלים האלה לטירגוט לפי קהל של פריט מודעה יחזירו שגיאה. הבקשות האלה כוללות בקשות מסוג advertisers.lineItems.duplicate ו-advertisers.lineItems.generateDefault, אם פריט הרכישה שנוצר יכלול קהלים שהוצאו משימוש בטירגוט לפי קהל.
  • 8 ביוני 2023: הקהלים המושפעים יוסרו מכל הטירגוט של הפריטים ומכל הזמנות ההצגה, ומכל הקהלים המשולבים. אם לא ניתן יהיה להציג מודעות בפריט מסוים אחרי הסרת הקהלים האלה, הוא יושהה. באותו תאריך, לא תהיה יותר אפשרות לאחזר את הקהלים האלה באמצעות השירות googleAudiences.

משימות מומלצות:

  • מומלץ להפסיק באופן מיידי את השימוש בקהלים שהושפעו כשמבצעים עדכונים עתידיים לטירגוט של הפריטים.
  • מסירים את כל הקהלים המושפעים מהטירגוט הקיים של הפריטים והזמנות הקמפיין. מידע נוסף על עדכון הטירגוט לפי קהל זמין במדריך בנושא משתמשי יעד.
סוגי FirstAndThirdPartyAudience של מכסות תדירות ומודעות שמבוססות על פעילות 20 במאי 2023

קו זמן‬

  • 20 במאי 2023: לא תוכלו יותר להקצות משאבים של FirstAndThirdPartyAudience עם AudienceType של ACTIVITY_BASED או FREQUENCY_CAP לטירגוט לפי קהל של פריט שורה או של הזמנת קמפיין. בקשות להקצאת הקהלים האלה לטירגוט לפי קהל של פריט מודעה יחזירו שגיאה. הבקשות האלה כוללות בקשות מסוג advertisers.lineItems.duplicate ו-advertisers.lineItems.generateDefault, אם פריט הרכישה שנוצר יכלול קהלים שהוצאו משימוש בטירגוט לפי קהל.
  • 8 ביוני 2023: הקהלים המושפעים יוסרו מכל הטירגוט של הפריטים ומכל הזמנות ההצגה, ומכל הקהלים המשולבים. אם פריט מסוים לא יוכל להציג מודעות אחרי הסרת הקהלים האלה, הוא יושהה. באותו תאריך, לא תהיה יותר אפשרות לאחזר את הקהלים האלה באמצעות השירות firstAndThirdPartyAudiences.

משימות מומלצות:

  • מומלץ להפסיק באופן מיידי את השימוש בקהלים שהושפעו כשמבצעים עדכונים עתידיים לטירגוט של הפריטים.
  • מסירים את כל הקהלים המושפעים מהטירגוט הקיים של פריט העלויות והזמנת הקמפיין. מידע נוסף על עדכון הטירגוט לפי קהל זמין במדריך בנושא משתמשי יעד.
המגבלות הקיימות על מכסות API 30 במאי 2023

ב-30 במאי 2023, מגבלות השימוש הקיימות יוחלפו במבנה מכסות היברידי שמאפשר:

  1. מבטלים את המכסה של בקשות ביום לכל פרויקט.
  2. המערכת קובעת מכסה של בקשות לדקה לכל מפרסם לכל פרויקט בשיטות שעומדות בדרישות.

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

שימוש באופרטור OR בין הגבלות של שדות שונים במסנני LIST

21 ביוני 2023

ב-21 ביוני 2023, לא תהיה יותר אפשרות להשתמש באופרטורים לוגיים מסוג OR בין הגבלות של שדות שונים בפרמטרים filter של הבקשה LIST.

לדוגמה, כדי לאחזר משאבים שזוהו באמצעות מחרוזת המסנן lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123", צריך להשתמש בשתי בקשות LIST עם מחרוזות המסנן הבאות:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

פרטים נוספים על ההגבלות של אופרטורים לוגיים זמינים במדריך שלנו בנושא סינון בקשות LIST.

כדי למנוע שיבושים בשירות, עליכם לבדוק את פרמטרי השאילתה filter של כל הקריאות הקיימות ל-LIST ולוודא שהן משתמשות באופרטור הלוגי OR בצורה נכונה לפני 21 ביוני 2023.

אפשרות לסנן או למיין את רשימת הבקשות לפי השדות budget.budget_segments.date_range.end_date ו-flight.dateRange.endDate

מועד הכניסה לתוקף הראשוני עודכן

21 ביוני 2023

ב-21 ביוני 2023, השדות budget.budget_segments.date_range.end_date ו-flight.dateRange.endDate לא יתקבלו יותר בפרמטרים של השאילתות filter ו-orderBy ב-advertisers.insertionOrders.list וב-advertisers.lineItems.list, בהתאמה. אחרי התאריך הזה, בקשות שמשתמשות בשדות האלה בפרמטר השאילתה filter ובפרמטר השאילתה orderBy יחזירו שגיאה.

כדי למנוע שיבושים בשירות, צריך להסיר את כל הלוגיקה של הסינון והסדר באמצעות שני השדות האלה לפני 21 ביוני 2023.

אפשרות לסנן בקשות advertisers.lineItems.list לפי ארבעה שדות נוספים 21 ביוני 2023

ב-21 ביוני 2023, advertisers.lineItems.list לא יתמוך יותר בסינון לפי השדות הבאים:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

כדי למנוע שיבושים בשירות, צריך להסיר את כל הלוגיקה של המסננים באמצעות ארבעת השדות האלה לפני 21 ביוני 2023.

רכישה מבוססת-תוצאה ‫1 באוגוסט 2023

ב-1 באוגוסט 2023, המערכת תעביר לארכיון הזמנות להצגת מודעות שמבוססות על רכישה מבוססת-תוצאות, שמוגדרות לפי ערך השדה billableOutcome של BILLABLE_OUTCOME_PAY_PER_CLICK או BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, וגם את הפריטים הצאצאים שלהן.

השינוי הזה ישפיע על הבקשות הבאות:

השדה publisherReviewStatuses במשאבי קריאייטיב ‫26 ביוני 2024

החל מ-26 ביוני 2024, השדה publisherReviewStatuses יוסר משימוש ויהיה ריק בזמן אחזור המשאבים של Creative.

טירגוט לפי תוכן בפריטים של YouTube ושותפים 30 בספטמבר 2024

ב-30 בספטמבר 2024, נפסיק את התמיכה בערכים הבאים של סוגי הטירגוט שצוינו, בפריטי YouTube ושותפים:

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

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

קהלים מאינטראקציה ישירה (first-party) ושל צד שלישי ב-Oracle 30 בספטמבר 2024

ב-30 בספטמבר 2024, נפסיק את השימוש במקורות המשאבים של FirstAndThirdPartyAudience מ-Oracle. עם סיום התמיכה, הקהלים האלה יוסרו מכל טירגוט קיים של משאבים ומכל קהל משולב. אם פריט שורה מטרגט רק קהלים שיצאו משימוש או מטרגט באופן שלילי קהלים שיצאו משימוש, העדכון הזה יושהה את פריט השורה באופן אוטומטי.

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

טירגוט מותאם אישית של פריטים בתת-קבוצה של שיטות בידינג 30 בספטמבר 2024

ב-30 בספטמבר 2024, משאבים של LineItem שמשתמשים בקבוצת משנה של שיטות בידינג לא יהיו תואמים יותר לאופטימיזציית טירגוט. בעקבות השינוי הזה, משאבים מסוג LineItem שהערך של targetingExpansion.enableOptimizedTargeting בהם מוגדר כ-True, והערך של bidStrategy.maximizeSpendAutoBid.performanceGoalType בהם מוגדר כ-BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN או BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED, או שהערך של bidStrategy.performanceGoalAutoBid.performanceGoalType בהם מוגדר כ-BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM, יתעדכנו כך שהערך של targetingExpansion.enableOptimizedTargeting בהם יהיה False.

כדי למנוע שיבושים בשירות, צריך לעדכן את הפריטים שבהם מוגדרות שיטות הבידינג האלה ולוודא שהטירגוט המותאם אישית לא מופעל בהם.

טיסה בהקדם האפשרי Pacing להזמנות קמפיינים 5 בנובמבר 2024

ב-5 בנובמבר 2024, השדה PACING_TYPE_ASAP לא יהיה תואם יותר לשדה PACING_PERIOD_FLIGHT כשמגדירים את השדה pacing בהזמנת ההצגה. הערך של pacingType בכל הזמנות ההצגה הקיימות עם ההגדרה הזו יתעדכן ל-PACING_TYPE_AHEAD.

כדי למנוע שיבושים בשירות, יש לעדכן את pacing של הזמנות קמפיין קיימות באמצעות PACING_TYPE_ASAP ו-PACING_PERIOD_FLIGHT.

תקופת מכסת התדירות על פני 30 ימים 28 בפברואר 2025

ב-28 בפברואר 2025:

  • בקשות ליצירה או לעדכון של משאבים מסוג LineItem, InsertionOrder ו-Campaign שמשתמשות באובייקט FrequencyCap עם שדה timeUnit שמוגדר כ-TIME_UNIT_LIFETIME או עם שדה timeUnit שמוגדר כ-TIME_UNIT_MONTH ושדה timeUnitCount שמוגדר כ-2 יחזירו שגיאה מסוג 400.
  • לא ניתן יהיה ליצור או לעדכן רשומות בקבצים של נתונים מובְנים של פריט, הזמנת קמפיין וקמפיין, אם הערך בעמודה 'תקופת התדירות' הוא 'לכל משך החיים', או אם הערך בעמודה 'תקופת התדירות' הוא 'חודשים' והערך בעמודה 'סכום התדירות' הוא '2', במהלך העלאת הקובץ.
  • קמפיינים, הזמנות להצגת מודעות ופריטים קיימים יעודכנו כך שיכללו תקופת מכסת תדירות של 30 ימים או פחות.

כדי למנוע שיבושים בשירות:

  • מעדכנים את המשאבים הקיימים של הקמפיינים, הזמנות ההצגה ופריטי הרכישה שמשתמשים במכסת תדירות לתקופה של יותר מ-30 יום לתקופה של 30 יום או פחות.
  • מוודאים שהשילוב לא מגדיר תקופת מכסת תדירות של יותר מ-30 יום כשיוצרים או מעדכנים משאבים של קמפיינים, הזמנות להצגת מודעות או פריטים באמצעות Display & Video 360 API או קובצי נתונים מובְנים.
אופטימיזציית טירגוט של פריטים באמצעות בידינג קבוע 6 במרץ 2025

ב-6 במרץ 2025:

  • בקשות ליצירה או לעדכון של משאבים מסוג LineItem, שמגדירות את השדה BiddingStrategy כ-fixedBid ואת השדה TargetingExpansionConfig כ-enableOptimizedTargeting, יחזירו את השגיאה 400.
  • המערכת לא תצליח ליצור או לעדכן רשומות בקובצי נתונים מובְנים של פריט עם הערך 'קבוע' בעמודה 'סוג שיטת הבידינג' והערך 'True' בעמודה 'טירגוט מותאם אישית' בזמן העלאת הקובץ.
  • פריטים קיימים עם שיטת בידינג קבועה יעודכנו כך שאופטימיזציית הטירגוט תושבת.

כדי למנוע שיבושים בשירות:

  • מעדכנים משאבים קיימים של פריטים שכוללים גם בידינג קבוע וגם טירגוט מותאם אישית.
  • מוודאים שהשילוב לא מגדיר שיטת בידינג קבועה וטירגוט מותאם כשאתם יוצרים או מעדכנים משאבים של פריטים באמצעות Display & Video 360 API או קובצי נתונים מובְנים.
עדכון לגודל הדף שמוגדר כברירת מחדל ב-firstAndThirdPartyAudiences.list 6 במרץ 2025

ב-6 במרץ 2025, גודל הדף שמוגדר כברירת מחדל לבקשות firstAndThirdPartyAudiences.list יעודכן מ-100 ל-5, 000.

כדי למנוע שיבושים בשירות, צריך לעדכן את השילוב כך שיגדיר את פרמטר השאילתה pageSize של הבקשות firstAndThirdPartyAudiences.list לגודל הדף המועדף.

שגיאה חדשה מסוג sdfdownloadtasks.create: אי התאמה בין שותף לבין מפרסם 6 במרץ 2025

ב-6 במרץ 2025, בקשות sdfdownloadtasks.create שמשתמשות במסנן ישות הורה כדי לסנן לפי מפרסמים שאינם צאצאים של הקבוצה partnerId יתחילו להחזיר שגיאה מסוג 400.

אי התאמה בין אלגוריתם הבידינג בהתאמה אישית לבין הפעילויות ב-Floodlight 1 באפריל 2025

ב-1 באפריל 2025:

כדי למנוע שיבושים בשירות, צריך לעדכן את השילוב כך:

  • מוודאים שהפעילויות הרלוונטיות ב-Floodlight מוקצות לפריט לפני הקצאת אלגוריתם בידינג מותאם אישית או בזמן הקצאת האלגוריתם.
  • לפני שמנסים לעדכן אלגוריתמים קיימים של בידינג בהתאמה אישית, הם מבטלים את ההקצאה שלהם מכל הפריטים.

משך החברות אינסופי בקרב קהלים מאינטראקציה ישירה 7 באפריל 2025

ב-7 באפריל 2025, משאבי FirstAndThirdPartyAudience לא יאפשרו יותר משך חברות אינסופי בקהל. בקשות firstAndThirdPartyAudiences.create ו-firstAndThirdPartyAudiences.patch שמגדירות את ערך השדה membershipDurationDays ל-10,000 יחזירו את השגיאה 400. קהלים קיימים עם ערך השדה membershipDurationDays של 10,000 יעודכנו לערך 540, ומשך החברות החדש יחול רטרואקטיבית על מינויים קיימים. כתוצאה מכך, תוקף כל החברויות שנוצרו לפני יותר מ-540 ימים יפוג.

כדי למנוע שיבושים בשירות:

  • מוודאים שהשילוב לא מגדיר את ערך השדה membershipDurationDays של קהלים חדשים או קיימים ל-10,000.
  • מרעננים את החברויות של הקהלים הקיימים בהתאמה ללקוחות באמצעות firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • מומלץ לעדכן באופן קבוע את החברויות בקהלים עם התאמה ללקוחות כדי לוודא שגודל הרשימה של הקהלים לא קטן בטעות.

בגרסה 4, השינוי הזה בא לידי ביטוי במשאבים של FirstPartyAndPartnerAudience.

העמודה 'מכפילי הצעות מחיר' בקבצים של נתונים מובְנים של פריטי שורה 1 במאי 2025

ב-1 במאי 2025, רשומות בקובצי נתונים מובְנים של פריט שמנסות להגדיר את העמודה 'מכפילי הצעות מחיר' לא יצליחו ליצור או לעדכן משאב בהעלאת הקובץ.