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)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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

פלט בלבד. שיעור ההתאמה החזוי של קהלים לעסקאות מובטחות בתכנות עם טירגוט לפי קהל, שמשמש את הבורסה כדי לקבוע כמה בקשות נוספות צריך לשלוח. זהו מספר עשרוני בין 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)

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

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

object (CreativeApprovalConfig)

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

BuyerStatus

סטטוס הקונה.

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

SellerStatus

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

טיפוסים בני מנייה (enum)
SELLER_STATUS_UNSPECIFIED לא צוין סטטוס אתר המכירה. לא צפוי, מציין שהסטטוס של המשא ומתן לא ידוע. ערך קלט לא תקין.
SELLER_STATUS_ACTIVE סטטוס אתר המכירה פעיל. מקור מלאי שטחי הפרסום פעיל בצד של בורסת הפרסום.
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

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