נתונים מובנים - v7 - קמפיין

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

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

שדה	חובה	סוג	ניתן לכתיבה	תיאור
Campaign Id (מזהה הקמפיין)	חובה רק כשעורכים קמפיינים קיימים	מספר שלם	לא	ערך המזהה המספרי של הקמפיין. אם השדה הזה יישאר ריק, המערכת תיצור מזהה קמפיין חדש ותקצה לו מזהה ייחודי. אופציונלית, כשיוצרים קמפיין חדש, אפשר להשתמש במזהה מותאם אישית כדי להקצות הזמנות להצגת מודעות לקמפיין החדש. הפורמט של מזהה בהתאמה אישית הוא ext[מזהה בהתאמה אישית], לדוגמה, ext123. כשהקובץ מועלה ומעובד, כל המזהים המותאמים אישית מוחלפים במזהים שהוקצו על ידי DBM, והאובייקטים משויכים (לדוגמה, הזמנת פרסום לקמפיין) על סמך המזהים המותאמים אישית.
מזהה מפרסם	כן	מספר שלם	לא	ערך מספרי של מזהה המפרסם. המזהה חייב להיות מזהה קיים ותקין של מפרסם
שם	כן	מחרוזת	כן	שם הרשומה.
חותמת זמן	נדרש כשעורכים רשומות קיימות	מספר שלם	לא	חותמת הזמן של הרשומה. המערכת משתמשת בה כדי לוודא שהרשומה לא השתנתה בין ההורדה להעלאה.
סטטוס	כן	מחרוזת	כן	הגדרת הסטטוס של הרשומה. פעיל בהשהיה הועבר לארכיון
יעד הקמפיין	כן	מחרוזת	כן	בוחרים אחד מיעדי הקמפיין הרלוונטיים: העלאת המודעות למותג או למוצר שלי הגדלת מספר הפעולות אונליין או את מספר הכניסות הגדלת המכירות אופליין או המכירות בחנות הגדלת מספר התקנות האפליקציה או האינטראקציות
יעד הקמפיין – מדד KPI	כן	מחרוזת	כן	בוחרים אחד מה-KPI הרלוונטיים ליעד הקמפיין: עלות לאלף חשיפות (CPM) % ניתנות לצפייה CPIAVC עלות להמרה (CPA) מחיר לקליק שיעור קליקים אחר
ערך KPI של יעד הקמפיין	כן	מספר ממשי (float)	כן	מספר חיובי של KPI של יעד הקמפיין. לגבי מדדי ה-KPI של יעד הקמפיין 'אחוז החשיפה' ו 'שיעור הקליקים', מזינים את הערך בשדה הזה באחוזים. למשל, אם רוצים להזין 80%, מזינים '80'. ב-KPI 'אחר', השדה הזה הוא תיאור קצר של היעד.
סוגי קריאייטיב	כן	מחרוזת, רשימה	כן	רשימה של סוגי קריאייטיב שאתם מתכוונים להשתמש בהם. רשת המדיה וידאו אודיו
תקציב קמפיין	לא	מספר ממשי (float)	כן	סכום תקציב חיובי לקמפיין. הערך תמיד יהיה מספר עשרוני של סכום במטבע, כי זה תמיד יהיה תקציב כספי. המטבעות יוצגו במטבע של המפרסם ביחידות רגילות (לא במיליוניות של יחידת מטבע)
תאריך ההתחלה של הקמפיין	כן	מחרוזת	כן	תאריך ההתחלה של הקמפיין בפורמט MM/DD/YYYY HH:mm
תאריך הסיום של הקמפיין	לא	מחרוזת	כן	תאריך הסיום של הקמפיין בפורמט MM/DD/YYYY HH:mm
התדירות מופעלת	כן	מחרוזת	כן	הגדרה שמאפשרת להפעיל או להשבית מכסת תדירות שמבוססת על חשיפות ברמת הקמפיין. TRUE FALSE
חשיפות לתדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מספר שלם	כן	מספר שלם חיובי שמייצג את מספר החשיפות בסכום התדירות הנתון, כלומר, x בביטוי 'הצגת x חשיפות במהלך תקופה של y'.
תקופת התדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מחרוזת	כן	מציינת את יחידת הזמן של מכסת התדירות. דקות שעות ימים שבועות חודשים
סכום התדירות	חובה אם הערך של 'הפעלת תדירות' הוא TRUE	מספר שלם	כן	מספר שלם חיובי שמייצג את משך הזמן של סוג מכסת התדירות, כלומר y בביטוי 'הצגת x חשיפות במהלך תקופה של y'. תקופות הזמן של מכסת התדירות צריכות להיות 30 ימים או פחות.
פלחים של תקציב הקמפיין	לא	מחרוזת, רשימה של רשימות	כן	קבוצת פלחים של תקציב לקמפיין. פורמט הרשימה = (ID; Name; Type; Amount; Start Date; End Date; External Budget Source; External Budget ID; Invoice Grouping ID; Prisma Client Code; Prisma Product Code; Prisma Estimate Code; Prisma Type; Supplier;). דוגמה: ‎ '(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)'‎ לא צוינו מזהה ותאריך סיום. הערכים הקבילים מפורטים בטבלה הבאה: שם העמודה חובה תיאור מזהה לא המזהה הייחודי של פלח תקציב הקמפיין. חובה לציין את הערך הזה כשעורכים פלח מהתקציב. אם השדה הזה יישאר ריק, פלח התקציב ייכתב כחדש. שם כן שם התצוגה של פלח התקציב בקמפיין. סוג כן סוג סכום התקציב. ערכים קבילים: סכום חשיפות סכום כן סכום תקציב חיובי לסוג התקציב. יכול להיות ערך של מספר שלם פשוט של חשיפות, או מספר עשרוני של סכום כסף. המטבעות יוצגו במטבע של המפרסם ביחידות רגילות (לא במיליוניות של יחידת מטבע). Start Date לא חותמת זמן של תאריך ההתחלה של קטע התקציב בפורמט MM/DD/YYYY HH:mm. אם לא מוגדר תאריך התחלה, הערך של השדה יהיה ריק. End Date לא חותמת זמן של תאריך הסיום של תקופת התקציב בפורמט MM/DD/YYYY HH:mm. אם לא מוגדר תאריך סיום, הערך של השדה יהיה ריק. מקור תקציב חיצוני כן המקור של הפלח בתקציב. ערכים קבילים: ללא Mediaocean מזהה תקציב חיצוני רק לפלחים בתקציב של Mediaocean אם ההגדרה הזו מוגדרת, כל החשיפות שמוצגות במסגרת פלח התקציב הזה יכללו את המזהה הזה בחשבונית, אם הלקוח הצטרף לחיוב ברמת פלח התקציב. מזהה של קיבוץ חשבוניות לא אם מוגדרים מזהה תקציב חיצוני ומזהה קיבוץ חשבוניות, כל פלחי התקציב עם אותם מזהים יצורפו לחשבונית אחת, אם הלקוח בחר בחיוב ברמת פלח התקציב. קוד לקוח ב-Prisma רק לפלחים בתקציב של Mediaocean אפשר להגדיר את ההגדרה הזו רק לפלחים של תקציבים ב-Mediaocean. מרכז התשלומים של Google תומך בחיפוש ובסינון של השדה הזה. קוד מוצר ב-Prisma רק לפלחים בתקציב של Mediaocean אפשר להגדיר את ההגדרה הזו רק לפלחים של תקציבים ב-Mediaocean. מרכז התשלומים של Google תומך בחיפוש ובסינון של השדה הזה. קוד הצעת מחיר ב-Prisma רק לפלחים בתקציב של Mediaocean אפשר להגדיר את ההגדרה הזו רק לפלחים של תקציבים ב-Mediaocean. מרכז התשלומים של Google תומך בחיפוש ובסינון של השדה הזה. סוג Prisma רק לפלחים בתקציב של Mediaocean אפשר להגדיר את ההגדרה הזו רק לפלחים של תקציבים ב-Mediaocean. סוג Prisma של הפלח. ערכים קבילים: רשת המדיה חיפוש וידאו אודיו רשתות חברתיות עמלה ספק Prisma רק לפלחים בתקציב של Mediaocean אפשר להגדיר את ההגדרה הזו רק לפלחים של תקציבים ב-Mediaocean. הישות שהוקצתה לתקציב הזה (DSP, אתר וכו')
טירגוט דמוגרפי לפי מגדר	לא	מחרוזת, רשימה	כן	רשימת המגדרים לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: נקבה גבר לא ידוע
גיל לטירגוט דמוגרפי	לא	מחרוזת, רשימה	כן	טירגוט לפי טווח גילאים של משתמשים. מציינים טווח גילאים על ידי בחירת גיל התחלה וגיל סיום, ובוחרים אם לכלול גילאים לא ידועים (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 +
טירגוט דמוגרפי לפי הכנסה למשק בית	לא	מחרוזת, רשימה	כן	טירגוט לפי טווח הכנסה למשק בית. מציינים טווח הכנסה על ידי בחירת טווח הכנסה יחיד של Top_of_Range וטווח הכנסה יחיד של Bottom_of_Range, ובוחרים אם לכלול משקי בית עם הכנסה לא ידועה (true/false). אפשר לעיין ברשימת טווחי ההכנסה הקבילים. דוגמה 1: כדי לטרגט את 10% עד 50% ממשקי הבית העליונים ולכלול משקי בית עם הכנסה לא ידועה, מציינים את הפורמט {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;‎ דוגמה 2: כדי לטרגט רק את 50% ממשקי הבית התחתונים ולכלול משקי בית עם הכנסה לא ידועה, מציינים את הפורמט {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;‎ ערכים קבילים ל-Top_of_Range/Bottom_of_Range: 10% העליונים 11%-‏20% 21%-‏30% 31%-‏40% 41%-‏50% 50% התחתונים
טירגוט דמוגרפי לפי סטטוס הורה	כן	מחרוזת, רשימה	כן	רשימה של סטטוסי הורה לטירגוט. בוחרים ערך אחד או יותר מהערכים הקבילים. הורה לא הורה לא ידוע
טירגוט גיאוגרפי – הכללה	לא	מחרוזת, רשימה	כן	רשימה של מיקומים גיאוגרפיים שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API TargetingOption לסוג הטירגוט TARGETING_TYPE_GEO_REGION. פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
טירגוט גיאוגרפי – החרגה	לא	מחרוזת, רשימה	כן	רשימת מיקומים גיאוגרפיים להחרגה מהטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של 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; וכו'). הרשימה הזו נוצרת בסדר עולה לפי מספרים.
תוויות דיגיטליות של התאמת תוכן לקהל – החרגה	לא	מחרוזת, רשימה	כן	רשימה של תוויות התאמת תוכן דיגיטלי לקהל שיוחרגו. פורמט הרשימה = (G;PG; וכו'). G PG T MA ?
הגדרת הרגישות של בטיחות המותג	לא	מחרוזת	כן	בוחרים את הגדרת הרגישות כדי לחסום מלאי שטחי פרסום על סמך הנושא של התוכן שמסביב. לא לחסום שימוש באימות של Campaign Manager 360 שימוש בהגדרה מותאמת אישית
הגדרות מותאמות אישית של בטיחות המותג	נדרש אם הערך של 'הגדרה מותאמת אישית של בטיחות המותג' הוא 'שימוש בהגדרה מותאמת אישית'	מחרוזת, רשימה	כן	אם הגדרת הרגישות של בטיחות המותג היא 'שימוש בהגדרה מותאמת אישית', צריך לציין את רשימת המסווגים של תוכן רגיל. לדוגמה, (Sexual;Alcohol;Tobacco;etc.). תוכן מיני פוגע הורדות ושיתוף כלי נשק הימורים אלימות בעל רמיזות מיניות שפה גסה אלכוהול סמים טבק פוליטיקה דת טרגדיה תאונות דרכים סוגיות חברתיות רגישות תוכן הגורם זעזוע
שירותי אימות של צד שלישי	לא	מחרוזת	כן	ספק שירותי אימות מצד שלישי. ללא Integral Ad Science DoubleVerify Adloox הערה: השם הקודם של הספק שנקרא עכשיו Scope3 היה Adloox.
תוויות אימות של צד שלישי	לא	מחרוזת, רשימה	כן	אם הערך של Third Party Verification Services (שירותי אימות של צד שלישי) הוא לא None (ללא), צריך לציין רשימה של תוויות שהספק הנבחר תומך בהן.
טירגוט לפי ניראות ב-Active View	לא	מחרוזת	כן	אחוזים של ניראות חזויה בטירגוט. אחוזים מיוצגים כמספרים עשרוניים. אחד מהערכים {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
טירגוט לפי מיקום – הצגה במסך	לא	מחרוזת, רשימה	כן	טירגוט מיקומי מודעות במסך. בוחרים אחד או יותר מהערכים הקבילים: בחלק העליון והקבוע בחלק הנגלל לא ידוע
טירגוט לפי מיקום – סרטון במסך	לא	מחרוזת, רשימה	כן	טירגוט של מיקומי מודעות וידאו במסך. בוחרים אחד או יותר מהערכים הקבילים: בחלק העליון והקבוע בחלק הנגלל לא ידוע
טירגוט לפי מיקום – מיקום ברשת המדיה בתוכן	לא	מחרוזת, רשימה	כן	מיקומי תוכן של מודעות לרשת המדיה לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: בגוף המאמר בגוף הפיד בתוך באנר מעברון לא ידוע
טירגוט לפי מיקום – מיקום סרטון בתוכן	לא	מחרוזת, רשימה	כן	מיקומי תוכן של מודעות וידאו לטירגוט. בוחרים אחד או יותר מהערכים הקבילים: בגוף המאמר בגוף הפיד בתוך באנר מעברון מודעת וידאו Outstream לא ידועה לפני הקרנה מודעה באמצע סרטון מודעה בסוף סרטון מודעת וידאו In-stream לא ידועה
טירגוט לפי מקור מלאי – אפשרויות של מפיץ מורשה	חובה אם הערך של 'סוג' הוא 'קמפיין לרשת המדיה', 'קמפיין וידאו' או 'קמפיין אודיו'	מחרוזת	כן	הגדרה לטירגוט מפיצים מורשים למכירה ישירה, מפיצים מורשים למכירה ישירה ומפיצים מורשים, או מפיצים מורשים + לא ידוע. 'מכירה ישירה מורשית' פירושה שהמודעות יוצגו רק למוכרים מורשים. 'מפיצים ומוכרים ישירים מורשים' פירושו טירגוט המפיצים והמוכרים הישירים המורשים. 'בעל תוכן דיגיטלי מורשה שלא משתתף' – המערכת תטרגט מוכרים מורשים, מפיצים ומוכרים לא ידועים. מפיצים ישירים מורשים מפיצים מורשים למכירה ישירה ומפיצים מורשים מוציא לאור מורשה ומוציא לאור שלא משתתף
טירגוט של מקורות מלאי – הכללה	לא	מחרוזת, רשימה	כן	רשימה של מקורות מלאי שטחי פרסום, בורסות ובורסות משנה שייכללו בטירגוט. בעמודה הזו מוצגים מזהי משאבים של Display & Video 360 API InventorySource, מזהי Exchange שפורסמו ומזהי משאבים של Display & Video 360 API TargetingOption מסוג טירגוט TARGETING_TYPE_SUB_EXCHANGE. פורמט הרשימה = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)
טירגוט לפי מקור מלאי – החרגה	לא	מחרוזת, רשימה	כן	רשימה של מקורות של מלאי שטחי פרסום, בורסות ובורסות משנה להחרגה בטירגוט. בעמודה הזו מוצגים מזהי משאבים של Display & Video 360 API InventorySource, מזהי Exchange שפורסמו ומזהי משאבים של Display & Video 360 API TargetingOption מסוג טירגוט TARGETING_TYPE_SUB_EXCHANGE. פורמט הרשימה = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)
טירגוט מקורות מלאי – טירגוט לבורסות פרסום חדשות	לא	מחרוזת	כן	ההגדרה היא טירגוט לבורסות פרסום חדשות. True לא נכון
טירגוט לפי סביבה	לא	מחרוזת, רשימה	כן	רשימת הסביבות לטירגוט. בוחרים ערך אחד או יותר מהערכים הקבילים. לתשומת ליבך: אי אפשר לבחור באפשרות 'אתר שלא עבר אופטימיזציה' בלי לבחור באפשרות 'אתר'. פיתוח אתרים האתר לא עבר אופטימיזציה אפליקציה