תכונות שהוצאו משימוש והועברו לארכיון

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

תכונה מועד הכניסה הראשוני לתוקף תיאור
הגבלות על פריטים ב-YouTube Reach ב-SDF ‫24 במרץ 2025

החל מ-24 במרץ 2025, כשיוצרים או מעדכנים פריטים, יהיה צורך להשתמש בפורמטים רחבים יותר של מודעות בקבצים של נתונים מובְנים. כלומר:

  • ב-SDF v6 וב-v7 אין יותר תמיכה ביצירת רשומות חדשות בקובץ פריטים עם הערך Subtype 'היקף חשיפה'.
  • אם מוסיפים רשומות חדשות לקובצי SDF Line Item עם הערך Subtype Reach, צריך להשתמש בערך Responsive בעמודה TrueView Video Ad Formats. אי אפשר לעדכן את הערך בעמודה TrueView Video Ad Formats של רשומות קיימות עם הערך Subtype 'היקף החשיפה'.
  • כשמוסיפים רשומות חדשות בקובצי SDF Line Item עם הערך Subtype Reach (היקף חשיפה), צריך למלא את העמודה TrueView Video Ad Inventory Control.
שגיאה חדשה של sdfdownloadtasks.create אי התאמה בין שותף למפרסם ‫6 במרץ 2025

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

עדכון לגודל הדף שמוגדר כברירת מחדל firstAndThirdPartyAudiences.list ‫6 במרץ 2025

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

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

אופטימיזציית טירגוט לפריטי שורה באמצעות הצעת מחיר קבועה ‫6 במרץ 2025

ב-6 במרץ 2025:

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

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

  • עדכון של משאבים קיימים של פריטים שמגדירים בהם גם בידינג קבוע וגם אופטימיזציית טירגוט.
  • מוודאים שהשילוב לא מגדיר שיטת בידינג קבועה ואופטימיזציית טירגוט כשיוצרים או מעדכנים משאבי פריטים באמצעות Display & Video 360 API או קובצי נתונים מובנים.
תקופה של מכסת תדירות מעל 30 ימים ‫28 בפברואר 2025

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

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

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

  • צריך לעדכן את משאבי הקמפיין, הזמנת קמפיין והפריט הקיים שמשתמשים בתקופה של מכסת תדירות מעל 30 ימים ל-30 ימים או פחות.
  • כשיוצרים או מעדכנים משאבים של קמפיינים, הזמנות קמפיין או פריטים באמצעות Display & Video 360 API או קובצי נתונים מובנים, צריך לוודא שהשילוב לא מגדיר תקופה של הגבלת תדירות מעל 30 ימים.
קמפיין ASAP Pacing להזמנות קמפיין ‫5 בנובמבר 2024

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

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

אופטימיזציית טירגוט ברמת פריט לשימוש עם קבוצת משנה של שיטות בידינג ‫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.

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

קהלים מאינטראקציה ישירה וקהלים שהוגדרו על ידי חברה חיצונית (Oracle) ‫30 בספטמבר 2024

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

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

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

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

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

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

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

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

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

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

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

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

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

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

כדי למנוע שיבושים בשירות, צריך להסיר את כל לוגיקת הסינון שמשתמשת בארבעת השדות האלה לפני 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 בפרמטרים של שאילתות advertisers.insertionOrders.list ו-advertisers.lineItems.list filter ו-orderBy, בהתאמה. אחרי התאריך הזה, בקשות שמשתמשות בשדות האלה בפרמטרים של השאילתה filter ו-orderBy יחזירו שגיאה.

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

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

21 ביוני 2023

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

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

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

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

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

מגבלות קיימות של מכסת API ‫30 במאי 2023

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

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

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

סוגים של מכסות תדירות וסינון שמבוסס על פעילות FirstAndThirdPartyAudience ‫20 במאי 2023

ציר הזמן:

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

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

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

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

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

ציר הזמן:

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

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

  • להפסיק מיד את השימוש בהפעלות ידניות כדי להתחיל ולהפסיק את הצגת הפריטים.
  • הפסקת שליחת בקשות לשירות advertisers.manualTriggers.
  • מעדכנים את השדות flight.flightDateType ו-flight.triggerId לכל פריטי הקו באמצעות טריגרים ידניים.
הרחבת הטירגוט ‫25 במרץ 2023 החלפה של התכונה הרחבת הטירגוט באופטימיזציית טירגוט, שהושקה בהדרגה מ-25 במרץ 2023 עד תחילת מאי 2023. בפוסט בבלוג הודענו על שינויים רלוונטיים בהתנהגות של Display & Video 360 API ושל קבצים של נתונים מובנים, וגם על פעולות מומלצות.