בסקירה הכללית מוסבר על הפורמט.
שדה | חובה | סוג | ניתן לכתיבה | תיאור |
---|---|---|---|---|
קוד זיהוי מוצר | לא | מספר שלם | לא | ערך המזהה המספרי של מוצר המדיה. |
מזהה תוכנית | לא | מספר שלם | לא | ערך המזהה המספרי של הצעת המדיה. |
Campaign Id (מזהה הקמפיין) | לא | מספר שלם | לא | |
שם | כן | מחרוזת | כן | שם הרשומה. |
סוג | לא | מחרוזת | לא | סוג מוצר המדיה.
|
Start Date | לא | מחרוזת | לא | תאריך ההתחלה של מוצר המדיה בפורמט MM/DD/YYYY HH:mm |
End Date | לא | מחרוזת | לא | תאריך הסיום של מוצר המדיה בפורמט MM/DD/YYYY HH:mm |
תקציב | לא | מספר ממשי (float) | לא | סכום תקציב חיובי למוצר המדיה. הערך תמיד יהיה מספר עשרוני של סכום במטבע, כי זה תמיד יהיה תקציב כספי. המטבעות יוצגו במטבע של המפרסם ביחידות רגילות (לא במיליוניות של יחידת מטבע) |
התדירות מופעלת | כן | מחרוזת | כן | |
חשיפות לתדירות | חובה אם הערך של 'הפעלת תדירות' הוא TRUE | מספר שלם | כן | מספר שלם חיובי שמייצג את מספר החשיפות בסכום תדירות נתון, כלומר x בביטוי 'הצגת x חשיפות במהלך תקופה של y'. |
תקופת התדירות | חובה אם הערך של 'הפעלת תדירות' הוא TRUE | מחרוזת | כן |
|
סכום התדירות | חובה אם הערך של 'הפעלת תדירות' הוא TRUE | מספר שלם | כן | |
טירגוט גיאוגרפי – הכללה | לא | מחרוזת, רשימה | כן | רשימה של מיקומים גיאוגרפיים שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה של מספרים. |
טירגוט לפי שפה – הכללה | לא | מחרוזת, רשימה | כן | רשימת השפות שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה של מספרים. |
טירגוט לפי שפה – החרגה | לא | מחרוזת, רשימה | כן | רשימת שפות שיוחרגו מהטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה של מספרים. |
טירגוט לערוצים – הכללה | לא | מחרוזת, רשימה | כן | רשימת הערוצים שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API פורמט הרשימה = (Channel.channelId; Channel.channelId; וכו'). |
טירגוט ערוצים – החרגה | לא | מחרוזת, רשימה | כן | רשימת הערוצים שיוחרגו מהטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API פורמט הרשימה = (Channel.channelId; Channel.channelId; וכו'). |
טירגוט לפי קטגוריה – הכללה | לא | מחרוזת, רשימה | כן | רשימת הקטגוריות שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה של מספרים. |
טירגוט לפי קטגוריה – החרגה | לא | מחרוזת, רשימה | כן | רשימת קטגוריות להחרגה בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API TargetingOption לסוג הטירגוט TARGETING_TYPE_CATEGORY . פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה של מספרים. |
טירגוט לפי קהל – הכללה | לא | מחרוזת, רשימה של רשימות של זוגות | כן | רשימה של רשימות קהלים שייכללו בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API ברשימות של קהלים מאינטראקציה ישירה, כל קהל מופיע כצמד של 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 עם כל המשתמשים). הערכים התקינים של מאפיין העדכניות הם:
|
טירגוט לפי קהל – החרגה | לא | מחרוזת, רשימה של רשימות של זוגות | כן | רשימה של רשימות חברים בקהל שיוחרגו מהטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API כל קהל מופיע כצמד של FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId והגדרת התדירות האחרונה, אם רשימת הקהלים היא רשימת קהלים מאינטראקציה ישירה. זוג הוא (1;1d;), כאשר 1d הוא דגימה של עדכניות שמייצגת עדכניות של יום אחד. עם זאת, לגבי קהלים של צד שלישי, לא ניתן להשתמש במאפיין 'עדכניות', ולכן פורמט הרשימה הוא (3;);(4;);. פורמט הרשימה = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);) הערכים התקינים של מאפיין העדכניות הם:
|
טירגוט לפי קהל עם תחום עניין משותף וקהל עם כוונת רכישה – הכללה | לא | מחרוזת, רשימה | כן | |
טירגוט לפי תחום עניין משותף וטירגוט לפי כוונת רכישה – החרגה | לא | מחרוזת, רשימה | כן | |
טירגוט דמוגרפי לפי מגדר | לא | מחרוזת, רשימה | כן | רשימת המגדרים לטירגוט. בוחרים אחד או יותר מהערכים הקבילים:
|
גיל לטירגוט דמוגרפי | לא | מחרוזת, רשימה | כן | טירגוט לפי טווח גילאים של משתמשים. מציינים טווח גילאים על ידי בחירת גיל התחלה וגיל סיום, ובוחרים אם לכלול גילאים לא ידועים (true/false). אפשר לעיין ברשימת הגילאים המקובלים בשדות 'מגיל' ו'עד גיל'. דוגמה 1: כדי לטרגט משתמשים בגיל 18 עד 55 ולכלול משתמשים שהגיל שלהם לא ידוע, מציינים את הפורמט {מגיל; עד גיל; כולל גיל לא ידוע True/False} = 18;55;true; דוגמה 2: כדי לטרגט רק משתמשים מעל גיל 35 וללא משתמשים שהגיל שלהם לא ידוע, מציינים את הפורמט הבא = 35;+;false;. ערכים קבילים בשדה 'מגיל':
ערכים קבילים עבור 'אל':
|
טירגוט דמוגרפי לפי סטטוס הורה | כן | מחרוזת, רשימה | כן | רשימה של סטטוסי הורה לטירגוט. בוחרים ערך אחד או יותר מהערכים הקבילים.
|
טירגוט לפי מכשיר – הכללה | לא | מחרוזת, רשימה | כן | רשימת המכשירים שרוצים לכלול בטירגוט. בעמודה הזו נעשה שימוש במזהי משאבים של Display & Video 360 API
פורמט הרשימה = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; וכו'). הרשימה הזו נוצרת בסדר עולה של מספרים. |
טירגוט לפי גודל נגן וידאו | לא | מחרוזת, רשימה | כן | רשימה של גדלי נגני מודעות וידאו לטירגוט. בוחרים אחד או יותר מהערכים הקבילים:
|
פרטי – שם בית העסק | לא | מחרוזת | לא | שם המוציא לאור בעסקה. השדה הזה רלוונטי רק למוצרי מדיה פרטיים. |
פרטי – מזהה הזמנה | לא | מחרוזת | לא | מזהה ההזמנה של עסקה מובטחת. השדה הזה רלוונטי רק למוצרי מדיה פרטיים. |
פרטי – מזהה מקור מלאי | לא | מחרוזת | לא | המזהה של מקור המלאי ב-DBM. השדה הזה רלוונטי רק למוצרי מדיה פרטיים. |