נתונים מובְנים – גרסה 3.1 – סדר הכנסה

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

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

שדה	חובה	סוג	ניתן לכתיבה	תיאור
מזהה Io	חובה רק כשעורכים הזמנות קיימות להצגת מודעות	מספר שלם	לא	ערך המזהה המספרי של הזמנת הקמפיין. אם השדה הזה יישאר ריק, המערכת תיצור מזהה חדש של הזמנת פרסום ותקצה לו מזהה ייחודי. אפשר גם להשתמש במזהה מותאם אישית כשיוצרים הזמנת פרסום חדשה, כדי להקצות פריטים להזמנת הפרסום החדשה. הפורמט של מזהה בהתאמה אישית הוא ext[מזהה בהתאמה אישית], לדוגמה, ext123. כשהקובץ מועלה ומעובד, כל המזהים המותאמים אישית מוחלפים במזהים שהוקצו על ידי DBM, והאובייקטים משויכים (לדוגמה, פריט הזמנה להזמנת פרסום) על סמך המזהים המותאמים אישית.
Campaign Id (מזהה הקמפיין)	לא	מספר שלם	לא	ערך המזהה המספרי של הקמפיין. אתם יכולים לציין מזהה מותאם אישית (לדוגמה, ext[custom campaign identifier]) לקמפיין שאתם יוצרים באותו זמן שבו אתם יוצרים את הזמנת הפרסום הזו.
שם	כן	מחרוזת	כן	שם הרשומה.
חותמת זמן	חובה כשעורכים רשומות קיימות	מספר שלם	לא	חותמת הזמן של הרשומה. המערכת משתמשת בה כדי לוודא שהרשומה לא השתנתה בין ההורדה להעלאה.
סטטוס	כן	מחרוזת	כן	הגדרת הסטטוס של הרשומה. פעיל בהשהיה טיוטה הועבר לארכיון נמחק
סוג ה-Io	כן	מחרוזת	כן	סוג הזמנת הקמפיין. אפשר להגדיר את הערך רק בזמן היצירה. רגיל
עמלות	לא	מחרוזת, רשימה של רשימות	כן	כל העמלות שקשורות לרשומה הזו. תבנית הרשימה = (קטגוריית העמלה; סכום העמלה; סוג העמלה; נכלל בחשבונית;). קטגוריית עמלות עלות לאלף חשיפות (CPM) מדיה סכום העמלה Float Pct as float סוג העמלה ‫(string, ראו טבלה בדמי שימוש) חשבון לחיוב בחשבונית True לא נכון blank דוגמה: ‎ '(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True);' בטבלה הבאה מפורטים ערכים קבילים: הערה: המערכת שומרת את העלות לאלף חשיפות של עמלות פרימיום, ואי אפשר לשנות אותה. הקרדינליות של עמלת Premium נשמרת בכל המוטציות על ידי הוספת עמלות ברירת מחדל של CPM אם צריך. קטגוריית עמלה סוג העמלה אפשרות חיוב עלות לאלף חשיפות/מדיה ברירת מחדל אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה שרת מודעות של צד שלישי אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה DoubleVerify יש אישור (TRUE/FALSE) עלות לאלף חשיפות/מדיה Adsafe אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה Adxpose אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה Vizu אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה Aggregate Knowledge אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה Teracent אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה Evidon אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה עמלה של חדר עסקאות או של סוכנות פרסום אסור (צריך להשאיר ריק) עלות לאלף חשיפות/מדיה Adloox יש אישור (TRUE/FALSE) עלות לאלף חשיפות (CPM) ShopLocal חובה (True) עלות לאלף חשיפות (CPM) TrustMetrics אסור (צריך להשאיר ריק) עלות לאלף חשיפות (CPM) סרטון ב-Integral Ad Science יש אישור (TRUE/FALSE) עלות לאלף חשיפות (CPM) סרטון ב-Moat אסור (צריך להשאיר ריק) מדיה עמלה על ניהול הצעות מחיר חובה (True) מדיה נתוני עלות מדיה אסור (צריך להשאיר ריק) עלות לאלף חשיפות (CPM) עמלות פרימיום אסור (צריך להשאיר ריק)
קוד שילוב	לא	מחרוזת	כן	קוד אופציונלי לצורכי מעקב.
פרטים	לא	מחרוזת	כן	פרטי הכניסה בפורמט מחרוזת.
קצב	כן	מחרוזת	כן	התקופה שבה התקציב ינוצל. יומי חודשית טיסה
קצב ניצול	כן	מחרוזת	כן	קצב ההצגה של הרשומה הזו. בהקדם האפשרי באופן שווה מראש
סכום ההוצאה המצטברת	כן	מספר ממשי (float)	כן	הסכום להוצאה בכל תקופת זמן שמוגדרת לפי סוג קצב הצגת המודעות.
הפעלת מכסת תדירות	כן	מחרוזת	כן	הגדרה שמאפשרת להפעיל או להשבית מכסת תדירות מבוססת-חשיפות בהזמנת הפרסום. TRUE FALSE
תדירות החשיפות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מספר שלם	כן	מספר שלם חיובי שמייצג את מספר החשיפות בסכום התדירות הנתון, כלומר x בביטוי 'הצגת x חשיפות במהלך תקופה של y'.
תקופת התדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מחרוזת	כן	מציינת את יחידת הזמן של מכסת התדירות. דקות שעות ימים שבועות חודשים מאז ההעלאה
סכום התדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מספר שלם	כן	מספר שלם חיובי שמייצג את משך הזמן של סוג התדירות, כלומר y בביטוי 'הצגת x חשיפות במהלך תקופה של y'.
סוג יעד הביצועים	כן	מחרוזת	כן	יחידת היעד של הזמנת הקמפיין עלות לאלף חשיפות (CPM) עלות להמרה (CPA) מחיר לקליק על"ו CPIAVC שיעור קליקים % ניראות ללא אחר
ערך יעד הביצועים	כן	מחרוזת	כן	ערך היעד במטבע (עלות לאלף חשיפות, עלות להמרה, עלות לקליק, עלות לצפייה, עלות להתקנה של אפליקציה עם ערך המרה), באחוזים (אחוז הצפייה, שיעור הקליקים) או כמחרוזת (אחר).
מדידת DAR	כן	מחרוזת	כן	הפעלה או השבתה של מדידת קהלים באמצעות Nielsen Digital Ad Ratings TRUE FALSE
מדידת ערוץ DAR	חובה אם הערך של 'Measure DAR' הוא TRUE	מספר שלם	כן	הערוץ למדידה באמצעות Nielsen Digital Ad Ratings. פורמט = UniversalChannel.id
סוג התקציב	כן	מחרוזת	כן	במאפיין הזה מציינים את סוג התקציב במונחים של סכום 'הכנסה' להוצאה (סכום) או מספר חשיפות (חשיפות) לרכישה. סכום חשיפות
פלחים בתקציב	כן	מחרוזת, רשימה של רשימות	כן	מציין את פלחי התקציב הספציפיים. פורמט הרשימה = (תקציב, תאריך התחלה, תאריך סיום). התקציב הוא בפורמט מטבע צף. התאריכים הם בפורמט MM/DD/YYYY. דוגמה: "(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);"
הקצאת תקציב אוטומטית	כן	מחרוזת	כן	הפעלה או השבתה של הקצאת תקציב אוטומטית TRUE FALSE
טירגוט גיאוגרפי – הכללה	לא	מחרוזת, רשימה	כן	רשימה של מיקומים גיאוגרפיים שרוצים לכלול בטירגוט. פורמט הרשימה = (GeoLocation.id; GeoLocation.id;etc.).
טירגוט גיאוגרפי – החרגה	לא	מחרוזת, רשימה	כן	רשימה של מיקומים גיאוגרפיים להחרגה מהטירגוט. פורמט הרשימה = (GeoLocation.id;GeoLocation.id; וכו').
טירגוט לפי שפה – הכללה	לא	מחרוזת, רשימה	כן	רשימה של שפות שרוצים לכלול בטירגוט. פורמט הרשימה = (Language.id;Language.id;etc.).
טירגוט לפי שפה – החרגה	לא	מחרוזת, רשימה	כן	רשימה של שפות שיוחרגו מהטירגוט. פורמט הרשימה = (Language.id;Language.id;etc.).
טירגוט לפי מכשיר – הכללה	לא	מחרוזת, רשימה	כן	רשימת המכשירים שייכללו בטירגוט. פורמט הרשימה = (DeviceCriteria.id;DeviceCriteria.id;etc.).
טירגוט לפי מכשיר – החרגה	לא	מחרוזת, רשימה	כן	רשימה של מכשירים שיוחרגו מהטירגוט. פורמט הרשימה = (DeviceCriteria.id;DeviceCriteria.id;etc.).
טירגוט לפי דפדפן – הכללה	לא	מחרוזת, רשימה	כן	רשימה של דפדפנים שרוצים לכלול בטירגוט. פורמט הרשימה = (Browser.id;Browser.id;etc.).
טירגוט לפי דפדפן – החרגה	לא	מחרוזת, רשימה	כן	רשימה של דפדפנים שצריך להחריג מהטירגוט. פורמט הרשימה = (Browser.id;Browser.id;etc.).
תוויות הגנה על המותג	לא	מחרוזת, רשימה	כן	רשימה של תוויות התאמת תוכן דיגיטלי לקהל לטירגוט. פורמט הרשימה = (G;PG; וכו'). G PG T MA ?
הגדרת הרגישות של בטיחות המותג	לא	מחרוזת	כן	בוחרים את הגדרת הרגישות כדי לחסום מלאי שטחי פרסום על סמך הנושא של התוכן שמסביב. לא לחסום שימוש באימות של DoubleClick שימוש בהגדרה מותאמת אישית
הגדרות מותאמות אישית של בטיחות המותג	נדרש אם הערך של 'הגדרה מותאמת אישית של בטיחות המותג' הוא 'שימוש בהגדרה מותאמת אישית'	מחרוזת, רשימה	כן	אם הגדרת הרגישות של בטיחות המותג היא 'שימוש בהתאמה אישית', צריך לציין את רשימת המסווגים של תוכן רגיל. לדוגמה, (מבוגרים; אלכוהול; טבק; וכו'). אדם מבוגר פוגע הורדות ושיתוף כלי נשק הימורים אלימות בעל רמיזות מיניות שפה גסה אלכוהול סמים טבק פוליטיקה דת טרגדיה תאונות דרכים סוגיות חברתיות רגישות תוכן הגורם זעזוע
שירותי אימות של צד שלישי	לא	מחרוזת	כן	ספק שירותי אימות חיצוני. ללא Integral Ad Science DoubleVerify Adloox
תוויות אימות של צד שלישי	לא	מחרוזת, רשימה	כן	אם הערך של Third Party Verification Services (שירותי אימות של צד שלישי) הוא לא None (ללא), צריך לציין רשימה של תוויות שהספק הנבחר תומך בהן.
טירגוט ערוצים – הכללה	לא	מחרוזת, רשימה	כן	רשימה של ערוצים שצריך לכלול בטירגוט. פורמט הרשימה = (UniversalChannel.id;UniversalChannel.id;‎ וכו').
טירגוט לערוץ – החרגה	לא	מחרוזת, רשימה	כן	רשימה של ערוצים שצריך לכלול בטירגוט. פורמט הרשימה = (UniversalChannel.id;UniversalChannel.id;‎ וכו').
טירגוט לפי אתר – הכללה	לא	מחרוזת, רשימה	כן	רשימה של אתרים שצריך לכלול בטירגוט. אם המזהה לא נמצא בטבלה Universal Site, הרשימה יכולה לכלול קבוצה של מזהי אתרים או מחרוזות של כתובות URL. פורמט הרשימה = (UniversalSite.Id;'http://someurl.com';etc.).
טירגוט אתרים – החרגה	לא	מחרוזת, רשימה	כן	רשימה של אתרים שצריך להחריג מהטירגוט. אם המזהה לא נמצא בטבלה Universal Site, הרשימה יכולה לכלול קבוצה של מזהי אתרים או מחרוזות של כתובות URL. פורמט הרשימה = (UniversalSite.Id;'http://someurl.com';etc.).
טירגוט אפליקציות – הכללה	לא	מחרוזת, רשימה	כן	רשימת האפליקציות שרוצים לכלול בטירגוט. הרשימה יכולה לכלול קבוצה של מזהי אתרים אוניברסליים או מחרוזות של חבילות אפליקציות, אם הן לא נמצאות בטבלת האתרים האוניברסליים. פורמט הרשימה = (UniversalSite.Id; 'some.app.package';etc.).
טירגוט אפליקציות – החרגה	לא	מחרוזת, רשימה	כן	רשימת האפליקציות שיוחרגו מהטירגוט. הרשימה יכולה לכלול קבוצה של מזהי אתרים אוניברסליים או מחרוזות של חבילות אפליקציות, אם הן לא נמצאות בטבלת האתרים האוניברסליים. פורמט הרשימה = (UniversalSite.Id; 'some.app.package';etc.).
טירגוט לפי קטגוריה – הכללה	לא	מחרוזת, רשימה	כן	רשימת הקטגוריות שצריך לכלול בטירגוט, מתוך מזהי הקטגוריות ב-AdX. פורמט הרשימה = (Verticals.Id;Verticals.Id;‎etc.).
טירגוט לפי סיווג – החרגה	לא	מחרוזת, רשימה	כן	רשימת קטגוריות להחרגה בטירגוט, מתוך מזהי קטגוריות ב-AdX. פורמט הרשימה = (Verticals.Id;Verticals.Id;‎etc.).
טירגוט לפי מילות מפתח – הכללה	לא	מחרוזת, רשימה	כן	רשימה של מחרוזות מילות מפתח שצריך לכלול בטירגוט.
טירגוט לפי מילות מפתח – החרגה	לא	מחרוזת, רשימה	כן	רשימה של מחרוזות של מילות מפתח להחרגה בטירגוט.
טירגוט לפי קהל – קהלים דומים	חובה אם הערך של 'סוג' הוא 'קמפיין לרשת המדיה', 'קמפיין וידאו' או 'קמפיין אודיו'	מחרוזת	כן	הפעלת קהלים דומים לרשימות של נתונים מאינטראקציה ישירה שמוגדרות לטירגוט חיובי. TRUE FALSE
טירגוט לפי קהל – הכללה	לא	מחרוזת, רשימה של רשימות של זוגות	כן	רשימה של רשימות קהלים שרוצים לכלול בטירגוט. ברשימות קהלים של צד ראשון, כל קהל מופיע כצמד של מזהה UserList והגדרת עדכניות. זוג הוא (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
טירגוט לפי תחום עניין משותף וכוונת רכישה – הכללה	לא	מחרוזת, רשימה	כן	רשימה של רשימות של קהלים עם תחום עניין משותף או קהלים עם כוונת רכישה שרוצים לכלול. פורמט הרשימה= מזהה רשימת משתמשים; מזהה רשימת משתמשים;
טירגוט לפי תחום עניין משותף וטירגוט לפי כוונת רכישה – החרגה	לא	מחרוזת, רשימה	כן	רשימה של רשימות של קהלים עם תחום עניין משותף או קהלים עם כוונת רכישה שרוצים להחריג. פורמט הרשימה= מזהה רשימת משתמשים; מזהה רשימת משתמשים;
טירגוט לפי תחום עניין משותף שהוגדר	לא	מחרוזת, רשימה	כן	רשימה של רשימות בהתאמה אישית לטירגוט. פורמט הרשימה= מזהה רשימת משתמשים; מזהה רשימת משתמשים;
טירגוט לפי מקור מלאי – הכללה	לא	מחרוזת, רשימה	כן	רשימת מלאי שטחי הפרסום שצריך לכלול בטירגוט. רשימת פורמטים = (InventorySource.id; InventorySource.id;).
טירגוט לפי מקור מלאי – החרגה	לא	מחרוזת, רשימה	כן	רשימה של מלאי שטחים פרסומיים שיוחרגו מהטירגוט. רשימת פורמטים = (InventorySource.id; InventorySource.id;).
טירגוט לפי שעות היום	לא	מחרוזת, רשימה	כן	רשימת מזהים, כאשר כל מזהה של חלק מהיום בנוי בפורמט הבא: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end base_dayparting_id = 300000 days_since_monday: 0=Monday, 1=Tuesday, ..., 6=Sunday start: 0..95 (00:00--23:45) an integer from 0-95, representing 15min slots end: 1..96 (00:15--24:00); an integer from 0-95, representing 15min slots start < end For new entities, times will be set in the timezone of your users (i.e., 'מקומי'). אזור הזמן של ישויות קיימות לא ישתנה.
טירגוט לפי סביבה	חובה אם הערך של 'סוג' הוא 'קמפיין לרשת המדיה', 'קמפיין וידאו' או 'קמפיין אודיו'	מחרוזת, רשימה	כן	רשימת הסביבות לטירגוט. פורמט הרשימה = (אינטרנט במחשב; אפליקציה לנייד; וכו'). בסביבת הרשת המדיה: אינטרנט למחשב אינטרנט לנייד אפליקציה לנייד מודעת מעברון באפליקציה לנייד אתרי אינטרנט שמותאמים למחשבים בנייד לסרטונים: סרטונים באינטרנט למחשב משחק באינטרנט למחשב מודעות בתוך מאמרים באתרים שמותאמים למחשבים מודעות בגוף הפיד באתרים שמותאמים למחשב סרטונים באתרים לנייד סרטון על אפליקציה לנייד מודעת מעברון בסרטון באפליקציה לנייד לגבי אודיו: אודיו באינטרנט במחשב אודיו באינטרנט לנייד אודיו באפליקציה לנייד
טירגוט לפי ניראות ב-Active View	לא	מחרוזת	כן	אחוזים של ניראות חזויה בקהל היעד. אחוזים מיוצגים כמספרים עשרוניים. אחת מהאפשרויות {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
מיקום המודעה בטירגוט לפי ניראות – כולל	לא	מחרוזת	כן	טירגוט מיקומי מודעות. בוחרים אחד מהערכים הקבילים או לא בוחרים אף אחד מהם: הכול ATF BTF לא ידוע
מיקום המודעה בטירגוט לפי שיעור צפייה – החרגה	לא	מחרוזת	כן	החרגה של מיקומי מודעות בטירגוט. בוחרים אחד מהערכים הקבילים או לא בוחרים אף אחד מהם: ATF BTF לא ידוע
טירגוט לפי מיקום מודעת וידאו	לא	מחרוזת, רשימה	כן	רשימת המיקומים של מודעות הווידאו לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: לא ידוע מודעה לפני סרטון מודעה באמצע סרטון לאחר הגלילה
טירגוט לפי גודל נגן וידאו	לא	מחרוזת, רשימה	כן	רשימה של גודל נגן מודעות הווידאו לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: לא ידוע קטן large HD
טירגוט דמוגרפי לפי מגדר	לא	מחרוזת, רשימה	כן	רשימת המגדרים לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: נקבה גבר לא ידוע
גיל לטירגוט דמוגרפי	לא	מחרוזת, רשימה	כן	טירגוט לפי טווח גילאים של משתמשים. מציינים טווח גילאים על ידי בחירת גיל התחלה וגיל סיום, ובוחרים אם לכלול גילאים לא ידועים (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 +
טירגוט לפי מהירות החיבור	לא	מחרוזת	כן	הגדרת יעד למהירות חיבור ספציפית. בוחרים אחד מהערכים הקבילים: הכול 2G 3G חיבור DSL 4G
טירגוט לפי ספק – הכללה	לא	מחרוזת, רשימה	כן	רשימה של ספקי אינטרנט או ספקים לטרגוט. פורמט הרשימה = {ISP.id; ISP.id;}
טירגוט לפי ספק – החרגה	לא	מחרוזת, רשימה	כן	רשימה של ספקי אינטרנט או ספקי סלולר להחרגה. פורמט הרשימה = {ISP.id; ISP.id;}