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

הגרסה הזו של SDF יצאה משימוש. כדי להמשיך להשתמש בקבצים של נתונים מובְנים, המשתמשים צריכים לעבור ל-SDF v9. צריך להשתמש במסמכי התיעוד האלה רק כשמתייחסים לקבצים שנוצרו בעבר.

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

שדה	חובה	סוג	ניתן לכתיבה	תיאור
קוד זיהוי מוצר	לא	מספר שלם	לא	ערך המזהה המספרי של מוצר המדיה.
מזהה תוכנית	לא	מספר שלם	לא	ערך המזהה המספרי של הצעת המדיה.
Campaign Id (מזהה הקמפיין)	לא	מספר שלם	לא
שם	כן	מחרוזת	כן	שם הרשומה.
סוג	לא	מחרוזת	לא	סוג מוצר המדיה. מכרז פתוח לרשת המדיה מודעות אודיו במכרז פתוח מודעת וידאו במכרז פתוח מודעת וידאו TrueView In-stream ב-YouTube מודעות TrueView Discovery ב-YouTube מודעות באמפר ב-TrueView ב-YouTube פוטנציאל החשיפה של TrueView ב-YouTube מודעת אודיו ב-YouTube Google Preferred Bumper סרטון Shorts מועדף של Google Google Preferred Long סרטון Shorts בהזמנה רגילה הזמנה רגילה ארוכה מודעת In-stream שאי אפשר לדלג עליה פרטי (בעל תוכן דיגיטלי) פרטי (מקור מלאי) פרטי (משא ומתן)
תאריך התחלה	לא	מחרוזת	לא	תאריך ההתחלה של מוצר המדיה בפורמט MM/DD/YYYY HH:mm
End Date	לא	מחרוזת	לא	תאריך הסיום של מוצר המדיה בפורמט MM/DD/YYYY HH:mm
תקציב	לא	מספר ממשי (float)	לא	סכום תקציב חיובי למוצר המדיה. הערך תמיד יהיה מספר עשרוני של סכום במטבע, כי זה תמיד יהיה תקציב כספי. המטבעות יוצגו במטבע של המפרסם ביחידות רגילות (לא במיליוניות של יחידת מטבע)
התדירות מופעלת	כן	מחרוזת	כן
חשיפות לפי תדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מספר שלם	כן	מספר שלם חיובי שמייצג את מספר החשיפות בסכום התדירות הנתון, כלומר x בביטוי 'הצגת x חשיפות במהלך תקופה של y'.
תקופת התדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מחרוזת	כן	דקות שעות ימים שבועות חודשים מאז ההעלאה
סכום התדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מספר שלם	כן
טירגוט גיאוגרפי – הכללה	לא	מחרוזת, רשימה	כן	רשימה של מיקומים גיאוגרפיים שרוצים לכלול בטירגוט. פורמט הרשימה = (GeoLocation.id; GeoLocation.id;etc.).
טירגוט לפי שפה – הכללה	לא	מחרוזת, רשימה	כן	רשימה של שפות שרוצים לכלול בטירגוט. פורמט הרשימה = (Language.id;Language.id;etc.).
טירגוט לפי שפה – החרגה	לא	מחרוזת, רשימה	כן	רשימה של שפות שיוחרגו מהטירגוט. פורמט הרשימה = (Language.id;Language.id;etc.).
טירגוט לערוצים – הכללה	לא	מחרוזת, רשימה	כן	רשימה של ערוצים שצריך לכלול בטירגוט. פורמט הרשימה = (UniversalChannel.id;UniversalChannel.id; etc.).
טירגוט ערוצים – החרגה	לא	מחרוזת, רשימה	כן	רשימה של ערוצים שצריך לכלול בטירגוט. פורמט הרשימה = (UniversalChannel.id;UniversalChannel.id; etc.).
טירגוט לפי קטגוריה – הכללה	לא	מחרוזת, רשימה	כן	רשימת הקטגוריות שצריך לכלול בטירגוט, מתוך מזהי הקטגוריות האנכיות של AdX. פורמט הרשימה = (Verticals.Id;Verticals.Id;‎etc.).
טירגוט לפי קטגוריה – החרגה	לא	מחרוזת, רשימה	כן	רשימת קטגוריות להחרגה בטירגוט, מתוך מזהי קטגוריות אנכיות ב-AdX. פורמט הרשימה = (Verticals.Id;Verticals.Id;‎etc.).
טירגוט לפי קהל – הכללה	לא	מחרוזת, רשימה של רשימות של זוגות	כן	רשימה של רשימות קהלים שרוצים לכלול בטירגוט. ברשימות קהלים של צד ראשון, כל קהל מופיע כצמד של מזהה רשימת משתמשים והגדרת עדכניות. זוג הוא (1;1d;), כאשר 1d הוא דוגמה של עדכניות שמייצגת עדכניות של יום אחד. המדד 'עדכניות' לא זמין לקהלים של צד שלישי, ולכן פורמט הרשימה הוא (3;);(4;);. כדי להשתמש באופרטורים AND ו-OR לקבוצות של קהלים, אפשר להיעזר בדוגמה הבאה: כדי לשלב זוגות עם נתוני עדכניות ובלי נתוני עדכניות: ' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. המשמעות היא (רשימה 1 עם נתון עדכני של יום אחד או רשימה 2 עם נתון עדכני של 365 ימים) וגם (רשימה 3 ללא נתון עדכני שצוין או רשימה 4 עם נתון עדכני של 5 דקות או רשימה 5 עם כל המשתמשים). הערכים התקינים של נתון עדכני הם: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
טירגוט לפי קהל – החרגה	לא	מחרוזת, רשימה של רשימות של זוגות	כן	רשימה של רשימות חברים בקהל שיוחרגו מהטירגוט. כל קהל מופיע כצמד של מזהה רשימת משתמשים והגדרת עדכניות, אם רשימת הקהלים היא רשימת קהלים מאינטראקציה ישירה. זוג הוא (1;1d;), כאשר 1d הוא דוגמה של עדכניות שמייצגת עדכניות של יום אחד. עם זאת, לגבי קהלים של צד שלישי, לא ניתן להשתמש במאפיין 'עדכניות', ולכן פורמט הרשימה הוא (3;);(4;);. פורמט הרשימה= (UserList.id; recency optional;); (UserList.id; recency optional;); דוגמה: "(1;1d;);(2;);". ערכי התדירות האחרונה האפשריים: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
טירגוט לפי קהל עם תחום עניין משותף וקהל עם כוונת רכישה – הכללה	לא	מחרוזת, רשימה	כן
טירגוט לפי תחום עניין משותף וטירגוט לפי כוונת רכישה – החרגה	לא	מחרוזת, רשימה	כן
טירגוט דמוגרפי לפי מגדר	לא	מחרוזת, רשימה	כן	רשימת המגדרים לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: נקבה גבר לא ידוע
גיל לטירגוט דמוגרפי	לא	מחרוזת, רשימה	כן	טירגוט לפי טווח גילאים של משתמשים. מציינים טווח גילאים על ידי בחירת גיל התחלה וגיל סיום, ובוחרים אם לכלול גילאים לא ידועים (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 +
טירגוט דמוגרפי לפי סטטוס הורה	כן	מחרוזת, רשימה	כן	רשימה של סטטוסי הורה לטירגוט. בוחרים ערך אחד או יותר מהערכים הקבילים. הורה לא הורה לא ידוע
טירגוט לפי מכשיר – הכללה	לא	מחרוזת, רשימה	כן	רשימת המכשירים שייכללו בטירגוט. פורמט הרשימה = (DeviceCriteria.id;DeviceCriteria.id;etc.).
טירגוט לפי גודל נגן וידאו	לא	מחרוזת, רשימה	כן	רשימה של גדלי נגני מודעות וידאו לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: לא ידוע קטן large HD
פרטי – שם בית העסק	לא	מחרוזת	לא	שם המוציא לאור בעסקה. השדה הזה רלוונטי רק למוצרי מדיה פרטיים.
פרטי – מזהה הזמנה	לא	מחרוזת	לא	מזהה ההזמנה של עסקה מובטחת. השדה הזה רלוונטי רק למוצרי מדיה פרטיים.
פרטי – מזהה מקור מלאי	לא	מחרוזת	לא	המזהה של מקור המלאי ב-DBM. השדה הזה רלוונטי רק למוצרי מדיה פרטיים.