REST Resource: exchanges.inventorySources

משאב: InventorySource

מודל הביצוע של מקור מלאי שטחי פרסום ב-DV360.

ייצוג ב-JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
שדות
name

string

פלט בלבד. שם המשאב היחסי להזמנה. נוצר על ידי השרת. דוגמה: exchanges/1234/inventorySources/5678.
buyerStatus

enum (BuyerStatus)

פלט בלבד. סטטוס הקונה.
sellerStatus

enum (SellerStatus)

סטטוס אתר המכירה.
transactionType

enum (TransactionType)

פלט בלבד. סוג העסקה של המוצר.
pricingType

enum (PricingType)

פלט בלבד. סוג התמחור של המוצר.
rateDetails

object (RateDetails)

פלט בלבד. פרטי הדירוג.
startTime

string (Timestamp format)

פלט בלבד. המועד שבו המוצר הופך לפעיל. חייב להיות מוקדם משעת הסיום. שעת ההתחלה לא יכולה להיות בעוד יותר משנה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

פלט בלבד. המועד שבו המוצר הזה הופך ללא פעיל.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

נתוני התחזית היומית של נפח המסחר שסופקו על ידי בורסת תל אביב. משמש לקביעת קצב ההצגה ולאפשרות ללקוח לבחור. השדה הזה הוצא משימוש.
audienceMatchRate

number

פלט בלבד. שיעור ההתאמה הצפוי של הקהל לעסקאות מובטחות פרוגרמטיות עם טירגוט לפי קהל, שמשמש את פלטפורמת ה-Exchange כדי לקבוע כמה בקשות נוספות צריך לשלוח. זהו מספר עשרוני בין 0 ל-1, וההופכי שלו ישמש כמכפיל של החשיפות. הערך 0 מציין שהשדה לא הוגדר, ולכן אין לו טירגוט לקהל. דוגמה: '0.125'. הנתון הזה מציין ש-12.5% מהבקשות תואמות לטירגוט לפי קהל, ומספר הבקשות שנשלחות צריך להיות פי 8 ממספר החשיפות המוסכמות.
makegoodRequested

boolean

פלט בלבד. השדה מציין אם נשלחה בקשה מהקונה להצגה חוזרת לפיצוי.
makegoodRequestedReason

string

פלט בלבד. הסיבה לבקשת ההצגה החוזרת לפיצוי שסיפק הקונה.
percentFrequencyCapExcludedTraffic

string (int64 format)

אחוז התנועה שלא נכללת במכסת התדירות של עסקה פרוגרמטית מובטחת. זהו מספר שלם בין 0 ל-100. הערך 0 (שגם הוא ערך ברירת המחדל) מציין שאין החרגה, ולכן כל התנועה עומדת בדרישות של מכסת התדירות. הערך 100 מציין החרגה מלאה, ולכן לא תחול מכסת תדירות. ערכים בין 0 ל-100 יגרמו להחרגה חלקית. לדוגמה, אם הערך הוא 20, 20% מהתנועה לא ייכללו במגבלת התדירות.
dv360WseatId[]

string (int64 format)

פלט בלבד. ה-wseats שיש להם כרגע הרשאה למקור מלאי שטחי הפרסום.
lastModifiedTime

string (Timestamp format)

פלט בלבד. הפעם האחרונה שבה מקור המלאי עודכן. שימו לב שחלק מהעדכונים הפנימיים של DV3 ישנו את מועד השינוי האחרון.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

אופציונלי. ההגדרה של אישור הקריאייטיב. ייתכן שתידרש אישור ברמת פלטפורמת ה-Exchange או ברמת בעל התוכן הדיגיטלי.

BuyerStatus

סטטוס הקונה.

טיפוסים בני מנייה (enum)
BUYER_STATUS_UNSPECIFIED לא צוין סטטוס הקונה. ערך קלט לא תקין.
BUYER_STATUS_ACTIVE סטטוס הקונה פעיל. הפריט הוקצה, הוקצה קריאייטיב תקין.
BUYER_STATUS_PENDING סטטוס הקונה: בהמתנה. המשמעות של הסטטוס הזה היא שהעסקה לא פעילה ושהקונה צריך לבצע פעולות מסוימות.
BUYER_STATUS_PAUSED סטטוס הקונה: 'הקונה השהה את החשבון'.

SellerStatus

סטטוס אתר המכירה.

טיפוסים בני מנייה (enum)
SELLER_STATUS_UNSPECIFIED הסטטוס של אתר המכירה לא צוין. לא צפוי, מציין שהסטטוס של המשא ומתן לא ידוע. ערך קלט לא תקין.
SELLER_STATUS_ACTIVE סטטוס האתר של המוכר פעיל. מקור מלאי שטחי הפרסום פעיל בצד פלטפורמת ה-Exchange.
SELLER_STATUS_PAUSED סטטוס אתר המכירה הושהה.

InventorySourceVolumeForecast

תחזית של נפח הבקשות היומי למקור מלאי שטחי הפרסום. כללי האימות הבאים חלים: - צריך לספק רשומה לכל יום בשבוע - הנפח חייב להיות מספר שלם לא שלילי - השדה timeZoneId הוא חובה והוא חייב להיות תקין

ייצוג ב-JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
שדות
dailyVolumes[]

object (DailyVolume)

תחזית של נפחים יומיים.
timeZoneId

string

אזור הזמן של מסד הנתונים של אזור הזמן IANA, למשל 'America/New_York', שמשמש לנפחים היומיים.

DailyVolume

בקשה לקבלת נפח של מקור מלאי שטחי פרסום ביום נתון.

ייצוג ב-JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
שדות
day

enum (DayOfWeek)

היום בשבוע שאליו מתייחס נפח הבקשות.
volume

string (int64 format)

נפח הבקשות הצפוי לאותו יום בשבוע.

DayOfWeek

מייצג יום בשבוע.

טיפוסים בני מנייה (enum)
DAY_OF_WEEK_UNSPECIFIED היום בשבוע לא צוין.
MONDAY שני
TUESDAY שלישי
WEDNESDAY רביעי
THURSDAY חמישי
FRIDAY שישי
SATURDAY שבת
SUNDAY ראשון

CreativeApprovalConfig

ההגדרה של אישור הקריאייטיב.

ייצוג ב-JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
שדות
requiresExchangeApproval

boolean

חובה. הערך מציין אם הקריאייטיב מחייב אישור לפני הטמעה ברמת פלטפורמת המודעות.
publisherConfigs[]

object (PublisherConfig)

אופציונלי. ההגדרות של בעל התוכן הדיגיטלי.

PublisherConfig

ההגדרה של בעל התוכן הדיגיטלי (publisher_config). אם ההגדרה publisher_config מוגדרת, הקריאייטיב מחייב אישור לפני הטמעה ברמת בעל התוכן הדיגיטלי.

ייצוג ב-JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
שדות
publisherId

string

חובה. מזהה בעל התוכן הדיגיטלי.
publisherDisplayName

string

חובה. שם בעל התוכן הדיגיטלי.

Methods

get

 אחזור של מקור מלאי.

list

 רשימת המקורות של מלאי שטחי הפרסום.

patch

 עדכון של מקור מלאי שטחי פרסום.