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

בדף הזה מפורטים תאריכי ההוצאה משימוש וההוצאה משימוש סופית של גרסאות 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, מגבלות השימוש הקיימות יוחלפו במבנה מכסות היברידי שמאפשר: מבטלים את המכסה של בקשות ביום לכל פרויקט. המערכת קובעת מכסה של בקשות לדקה לכל מפרסם לכל פרויקט בשיטות שעומדות בדרישות. המגבלות החדשות האלה יאפשרו גמישות רבה יותר בשימוש ב-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, וגם את הפריטים הצאצאים שלהן. השינוי הזה ישפיע על הבקשות הבאות: ניסיון להשתמש ב-advertisers.insertionOrders.create כדי ליצור הזמנת קמפיין באמצעות רכישה מבוססת-תוצאות יוביל לשגיאה מסוג 400 ניסיון להשתמש ב-advertisers.lineItems.create, ב-advertisers.lineItems.duplicate או ב-advertisers.lineItems.generateDefault כדי ליצור פריט בהזמנת קמפיין באמצעות רכישה מבוססת-תוצאות יגרום להצגה של שגיאה מסוג 400. מאחר שמשאבים בארכיון לא נכללים בבקשות LIST כברירת מחדל, כברירת מחדל, שיטות advertisers.insertionOrders.list ו-advertisers.lineItems.list לא יחזירו יותר את המשאבים המושפעים.
השדה publisherReviewStatuses במשאבי קריאייטיב	‫26 ביוני 2024	החל מ-26 ביוני 2024, השדה publisherReviewStatuses יוסר משימוש ויהיה ריק בזמן אחזור המשאבים של Creative.
טירגוט לפי תוכן בפריטים של YouTube ושותפים	30 בספטמבר 2024	ב-30 בספטמבר 2024, נפסיק את התמיכה בערכים הבאים של סוגי הטירגוט שצוינו, בפריטי YouTube ושותפים: TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_UNRATED CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_FAMILIES TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO אפשרויות הטירגוט שיוצאות משימוש יוסרו באופן אוטומטי מהטירגוט הקיים של הפריטים. הערכים האלה עדיין יהיו זמינים לשימוש בטירגוט ברמת המפרסם. כדי למנוע שיבושים בשירות, צריך להסיר את הטירגוט הזה מכל פריטי 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.
משך החברות אינסופי בקרב קהלים מאינטראקציה ישירה	7 באפריל 2025	ב-7 באפריל 2025, משאבי FirstAndThirdPartyAudience לא יאפשרו יותר משך חברות אינסופי בקהל. בקשות firstAndThirdPartyAudiences.create ו-firstAndThirdPartyAudiences.patch שמגדירות את ערך השדה membershipDurationDays ל-10,000 יחזירו את השגיאה 400. קהלים קיימים עם ערך השדה membershipDurationDays של 10,000 יעודכנו לערך 540, ומשך החברות החדש יחול רטרואקטיבית על מינויים קיימים. כתוצאה מכך, תוקף כל החברויות שנוצרו לפני יותר מ-540 ימים יפוג. כדי למנוע שיבושים בשירות: מוודאים שהשילוב לא מגדיר את ערך השדה membershipDurationDays של קהלים חדשים או קיימים ל-10,000. מרעננים את החברויות של הקהלים הקיימים בהתאמה ללקוחות באמצעות firstAndThirdPartyAudiences.editCustomerMatchMembers. מומלץ לעדכן באופן קבוע את החברויות בקהלים עם התאמה ללקוחות כדי לוודא שגודל הרשימה של הקהלים לא קטן בטעות.