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

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

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

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

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

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

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

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

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

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

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

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

ב-23 בפברואר 2026, Display & Video 360 יוציא משימוש את הטרגוט של הזמנות קמפיין וקמפיינים. יבוצעו שינויים ב-Display & Video 360 API ובקבצים של נתונים מובְנים (SDF) כדי להתאים לשינוי הזה. ב-Display & Video 360 API, חלק מהשיטות יצאו משימוש ויחזירו שגיאה אם יתבצע ניסיון להפעיל אותן. ב-SDF, עמודות הטירגוט בקבצים Insertion Order ו-Campaign לא יאוכלסו יותר בהורדה, ונדרש שהן יהיו ריקות בהעלאה. מומלץ למשתמשים להקצות טירגוט ישירות לפריטי קמפיין בזמן יצירת פריטי הקמפיין.

השיטות הבאות ב-Display & Video 360 API יחזירו שגיאה 404 אם יופעלו:

העלאה של רשומות Campaign ב-SDF שמוקצים להן ערכים בעמודות הבאות תיכשל:

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

העלאה של רשומות SDF של הזמנות להצגת מודעות שמוקצים להן ערכים בעמודות הבאות תיכשל:

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude
הצהרה לגבי הצגת מודעות שקשורות לפוליטיקה באיחוד האירופי בפריטי מידע ‫8 בספטמבר 2025

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

אם חשבון המפרסם ההורה שלכם לא יכלול פריטי מידע על מודעות שקשורות לפוליטיקה באיחוד האירופי, תוכלו להצהיר על כך ברמת חשבון המפרסם באמצעות השדה containsEuPoliticalAds במשאב Advertiser של Display & Video 360 API. אם השדה הזה מוגדר לערך DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, כל הפריטים החדשים להצגת מודעות בחשבון המפרסם יקבלו את אותו הערך אם לא צוין ערך אחר, וכל הפריטים הקיימים להצגת מודעות בחשבון המפרסם יקבלו את אותו הערך אם לא הוגדר להם ערך קודם. אפשר לעדכן את ההצהרה של פריט קו בכל שלב אחרי היצירה שלו באמצעות ממשק המשתמש, ה-API או SDF.

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

הגדרות של קטגוריות תוכן לפריטי YouTube ושותפים ‫12 ביוני 2025

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

  • השדה contentCategory באובייקטים YoutubeAndPartnersSettings של משאבי YouTube והשותפים LineItem לא יעודכן יותר. בעתיד נסיר אותו לחלוטין.
  • העמודה TrueView Content Filter בטבלאות SDF של פריט לא תהיה יותר ניתנת לכתיבה.
כדי למנוע שיבושים בשירות:
  • כשבודקים פריטים של YouTube והשותפים ב-API, צריך לאחזר את השדה effectiveContentCategory במקום השדה contentCategory.
  • כשמעדכנים רשומות של פריט SDF, מפסיקים לשנות את העמודה TrueView Content Filter. כשיוצרים פריטים חדשים, משאירים את העמודה ריקה.
עדכונים בתקציב של פריטים עם אופטימיזציה של הזמנת קמפיין ‫12 ביוני 2025

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

כדי למנוע הפרעות בשירות:
הגבלות באתרים לגבי קבצים של נתונים מובנים ‫12 ביוני 2025

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

המידע הזה רלוונטי לעמודות Site Targeting - Include ו-Site Targeting - Exclude בקבצים Insertion Order ו-Line Item.
העמודה 'הכפלות של הצעות מחיר' בקבצים של נתונים מובנים של פריטי מידע ‫1 במאי 2025

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

חובה לציין מקור מלאי שטחי פרסום של שותפי וידאו בפריטים מקמפיינים ליצירת ביקוש בקובצי נתונים מובנים ‫22 באפריל 2025

החל מ-22 באפריל 2025, תצטרכו לכלול את הערך 'שותפי וידאו' בעמודה TrueView Inventory Source Targeting של רשומות פריט עם ערך 'יצירת ביקוש' בעמודה Type. אחרי שהאכיפה תתחיל, המערכת תמלא את הערך באופן אוטומטי עבור פריטי מלאי קיימים, והוא ייכלל בהורדה של קובצי נתונים מובְנים חדשים.

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

  • צריך לעדכן את השילוב כך שיכלול את הערך Video Partners (שותפי וידאו) בכל הרשומות של הפריטים מקמפיינים ליצירת ביקוש.
  • כדי לנהל את מקורות מלאי שטחי הפרסום בקמפיינים ליצירת ביקוש ברמת קבוצת המודעות, צריך לעדכן את השילוב באמצעות העמודות Demand Gen Inventory Source Strategy ו-Demand Gen Enabled Inventory Sources של קבוצת מודעות ב-SDF בגרסה 8.1.
קמפיינים של מודעות וידאו עם קריאה לפעולה בקובצי נתונים מובנים ‫22 באפריל 2025

החל מ-22 באפריל 2025, לא תהיה יותר אפשרות ליצור פריטים מקמפיינים של מודעות וידאו עם קריאה לפעולה באמצעות קובצי נתונים מובְנים, כי הם ישודרגו לקמפיינים ליצירת ביקוש. ניסיונות להעלות רשומות של פריטים מקמפיינים עם ערך של 'פעולה' בעמודה Subtype וערך של TrueView בעמודה Type ייכשלו.

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

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

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

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

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

בגרסה 4, השינוי הזה משתקף במשאבי FirstPartyAndPartnerAudience.

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

ב-1 באפריל 2025:

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

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

הוצאות קודמות משימוש של תכונות

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