נתונים מובְנים – גרסה 9.1 – מוצר מדיה

הגרסה הזו של SDF הוצאה משימוש. המשתמשים צריכים לעבור ל-SDF v10 לפני 28 בינואר 2026 כדי להמשיך להשתמש בקבצים של נתונים מובְנים.

בסקירה הכללית מוסבר על הפורמט.

שדה	חובה	סוג	ניתן לכתיבה	תיאור
קוד זיהוי מוצר	לא	מספר שלם	לא	ערך המזהה המספרי של מוצר המדיה.
מזהה תוכנית	לא	מספר שלם	לא	ערך המזהה המספרי של הצעת המדיה.
Campaign Id (מזהה הקמפיין)	לא	מספר שלם	לא
שם	כן	מחרוזת	כן	שם הרשומה.
סוג	לא	מחרוזת	לא	סוג מוצר המדיה. מכרז פתוח לרשת המדיה מודעות אודיו במכרז פתוח מודעת וידאו במכרז פתוח קמפיין לעידוד צפייה בסרטון (VVC) פוטנציאל חשיפה יעיל מודעת וידאו TrueView In-stream ב-YouTube מודעות TrueView Discovery ב-YouTube מודעת באמפר TrueView ב-YouTube TrueView להגדלת פוטנציאל החשיפה ב-YouTube מודעת אודיו ב-YouTube מודעות באמפר שאפשר לדלג עליהן עם תדירות טירגוט תדירות טירגוט של מודעות שאי אפשר לדלג עליהן מודעות שאפשר לדלג עליהן עם תדירות טירגוט מודעות באמפר עם תדירות טירגוט מודעות באמפר ב-Google Preferred Google Preferred Short Google Preferred Long מודעת וידאו In-stream שלא ניתן לדלג עליה, באורך 30 שניות, בתוכנית Google Preferred Google Preferred YouTube Shorts סרטון Shorts בהזמנה רגילה הזמנה רגילה ארוכה מודעת In-stream שאי אפשר לדלג עליה פרטי (בעל תוכן דיגיטלי) פרטי (מקור מלאי) פרטי (משא ומתן) יצירת ביקוש
תאריך התחלה	לא	מחרוזת	לא	תאריך ההתחלה של מוצר המדיה בפורמט MM/DD/YYYY HH:mm
End Date	לא	מחרוזת	לא	תאריך הסיום של מוצר המדיה בפורמט MM/DD/YYYY HH:mm
תקציב	לא	מספר ממשי (float)	לא	סכום תקציב חיובי למוצר המדיה. הוא תמיד מספר עשרוני של סכום במטבע, כי הוא תמיד תקציב כספי. המטבעות יוצגו במטבע של המפרסם ביחידות רגילות (לא במיליוניות של יחידת מטבע)
הפעלת מכסת תדירות	כן	מחרוזת	כן
חשיפות לפי תדירות	חובה אם הערך של 'הפעלת מכסת תדירות' הוא TRUE	מספר שלם	כן	מספר שלם חיובי שמייצג את מספר החשיפות בסכום התדירות הנתון, כלומר, x בביטוי 'הצגת x חשיפות במהלך תקופה של y'.
תקופת התדירות	חובה אם הערך של 'הפעלת מכסת תדירות' הוא TRUE	מחרוזת	כן	דקות שעות ימים שבועות חודשים מאז ההעלאה
סכום התדירות	חובה אם הערך של 'הפעלת מכסת תדירות' הוא TRUE	מספר שלם	כן
טירגוט גיאוגרפי – הכללה	לא	מחרוזת, רשימה	כן	רשימה של מיקומים גיאוגרפיים שרוצים לכלול בטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ TargetingOption לסוג הטירגוט TARGETING_TYPE_GEO_REGION. פורמט רשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט לפי שפה – הכללה	לא	מחרוזת, רשימה	כן	רשימת השפות שרוצים לכלול בטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ TargetingOption לסוג הטירגוט TARGETING_TYPE_LANGUAGE. פורמט רשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט לפי שפה – החרגה	לא	מחרוזת, רשימה	כן	רשימת השפות שיוחרגו מהטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ TargetingOption לסוג הטירגוט TARGETING_TYPE_LANGUAGE. פורמט רשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט ערוצים – הכללה	לא	מחרוזת, רשימה	כן	רשימת הערוצים שרוצים לכלול בטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ Channel. פורמט הרשימה = (Channel.channelId; Channel.channelId; וכו').
טירגוט לערוץ – החרגה	לא	מחרוזת, רשימה	כן	רשימת הערוצים שיוחרגו מהטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ Channel. פורמט הרשימה = (Channel.channelId; Channel.channelId; וכו').
טירגוט לפי קטגוריה – הכללה	לא	מחרוזת, רשימה	כן	רשימת הקטגוריות שרוצים לכלול בטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ TargetingOption לסוג הטירגוט TARGETING_TYPE_CATEGORY. פורמט רשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט לפי קטגוריה – החרגה	לא	מחרוזת, רשימה	כן	רשימת קטגוריות להחרגה בטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ TargetingOption לסוג הטירגוט TARGETING_TYPE_CATEGORY. פורמט רשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט לפי קהל – הכללה	לא	string, list of list of pairs	כן	רשימה של רשימות קהלים שרוצים לכלול בטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ FirstPartyAndPartnerAudience. ברשימות של קהלים מאינטראקציה ישירה, כל קהל מופיע כצמד של FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId והגדרת התדירות האחרונה. זוג הוא (1;1d;), כאשר 1d הוא דגימה של עדכניות שמייצגת עדכניות של יום אחד. המדד 'עדכניות' לא זמין לקהלים של צד שלישי, ולכן פורמט הרשימה הוא (3;);(4;);. כדי להשתמש באופרטורים AND ו-OR לקבוצות של קהלים, אפשר להיעזר בדוגמה הבאה: כדי לשלב זוגות עם נתוני עדכניות ובלי נתוני עדכניות: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. כלומר (רשימה 1 עם נתון עדכני של יום אחד או רשימה 2 עם נתון עדכני של 365 ימים) וגם (רשימה 3 ללא נתון עדכני שצוין או רשימה 4 עם נתון עדכני של 5 דקות או רשימה 5 עם כל המשתמשים). הערכים התקינים של מאפיין העדכניות הם: הכל דקה ‫5 דקות ‫10 דקות ‫15 דקות ‫30 דקות שעה שעתיים 3 שע' ‫6h ‫12 שעות יום אחד דו ממד תלת ממד 5 י' 7 ימים ‫10 ימים 14י ‫15 ימים 21d 28 ימים ‫30 ימים ‫45 ימים ‫60d 90 יום ‫120d ‫180 ימים ‫270d ‫365 ימים
טירגוט לפי קהל – החרגה	לא	string, list of list of pairs	כן	רשימה של רשימות קהלים להחרגה מהטירגוט. הנתונים בעמודה הזו מבוססים על מזהי משאבים של Display & Video 360 API‏ FirstPartyAndPartnerAudience. כל קהל מופיע כצמד של FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId והגדרת העדכניות, אם רשימת הקהלים היא רשימת קהלים מאינטראקציה ישירה. זוג הוא (1;1d;), כאשר 1d הוא דגימה של עדכניות שמייצגת עדכניות של יום אחד. עם זאת, לגבי קהלים של צד שלישי, לא ניתן להשתמש בנתון העדכניות, ולכן פורמט הרשימה הוא (3;);(4;);. פורמט הרשימה = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);) דוגמה: "(1;1d;);(2;);". הערכים התקינים של מאפיין העדכניות הם: הכל דקה ‫5 דקות ‫10 דקות ‫15 דקות ‫30 דקות שעה שעתיים 3 שע' ‫6h ‫12 שעות יום אחד דו ממד תלת ממד 5 י' 7 ימים ‫10 ימים 14י ‫15 ימים 21d 28 ימים ‫30 ימים ‫45 ימים ‫60d 90 יום ‫120d ‫180 ימים ‫270d ‫365 ימים
טירגוט לפי קהל עם תחום עניין משותף וקהל עם כוונת רכישה – הכללה	לא	מחרוזת, רשימה	כן
טירגוט לפי תחום עניין משותף וטירגוט לפי כוונת רכישה – החרגה	לא	מחרוזת, רשימה	כן
טירגוט דמוגרפי לפי מגדר	לא	מחרוזת, רשימה	כן	רשימת המגדרים לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: נקבה גבר לא ידוע
גיל לטירגוט דמוגרפי	לא	מחרוזת, רשימה	כן	טירגוט לפי טווח גילאים של משתמשים. מציינים טווח גילאים על ידי בחירת גיל התחלה וגיל סיום, ובוחרים אם לכלול גילאים לא ידועים (true/false). אפשר לעיין ברשימת הגילאים המותרים בשדות 'מגיל' ו'עד גיל'. דוגמה 1: כדי לטרגט משתמשים בגיל 18 עד 55 ולכלול גילאים לא ידועים, מציינים את הפורמט {מגיל; עד גיל; כולל גיל לא ידוע True/False} = 18;55;true;‎ דוגמה 2: כדי לטרגט רק משתמשים מעל גיל 35 וללא גילאים לא ידועים, מציינים את הפורמט הבא = 35;+;false;. ערכים קבילים בשדה 'מגיל': 18 25 35 45 55 65 ערכים קבילים עבור 'אל': 25 35 45 55 65 +
טירגוט דמוגרפי לפי סטטוס הורה	כן	מחרוזת, רשימה	כן	רשימה של סטטוסי הורה לטירגוט. בוחרים ערך אחד או יותר מהערכים הקבילים. הורה לא הורה לא ידוע
טירגוט לפי מכשיר – הכללה	לא	מחרוזת, רשימה	כן	רשימת המכשירים שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API‏ TargetingOption לסוגי הטירגוט הבאים: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM פורמט רשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט לפי גודל נגן וידאו	לא	מחרוזת, רשימה	כן	רשימה של גדלי נגני מודעות וידאו לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: לא ידוע קטן large HD
פרטי – שם בית העסק	לא	מחרוזת	לא	שם המוציא לאור בעסקה. השדה הזה רלוונטי רק למוצרי מדיה פרטיים.
פרטי – מזהה הזמנה	לא	מחרוזת	לא	מזהה ההזמנה של עסקה מובטחת. השדה הזה רלוונטי רק למוצרי מדיה פרטיים.
פרטי – מזהה מקור מלאי	לא	מחרוזת	לא	המזהה של מקור המלאי ב-DBM. השדה הזה רלוונטי רק למוצרי מדיה פרטיים.