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 เวลาเริ่มต้นต้องไม่เกิน 1 ปีนับจากนี้

ใช้ 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)

การคาดการณ์ปริมาณรายวันที่ Exchange ระบุ ใช้เพื่อกำหนดการควบคุมความเร็วและเปิดใช้ตัวเลือกของผู้ซื้อ ช่องนี้เลิกใช้งานแล้ว
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)

เอาต์พุตเท่านั้น ที่นั่งที่ได้รับอนุญาตให้เข้าถึงแหล่งที่มาของพื้นที่โฆษณาในปัจจุบัน
lastModifiedTime

string (Timestamp format)

เอาต์พุตเท่านั้น ครั้งล่าสุดที่มีการอัปเดตแหล่งที่มาของสินค้าคงคลัง โปรดทราบว่าการอัปเดตภายใน DV3 บางอย่างจะเปลี่ยนเวลาที่แก้ไขล่าสุด

ใช้ 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 สถานะผู้ขายใช้งานอยู่ แหล่งที่มาของพื้นที่โฆษณาใช้งานได้ในฝั่ง 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)

ปริมาณคำขอที่คาดการณ์สำหรับวันของสัปดาห์ที่ระบุ

วันของสัปดาห์

แสดงวันของสัปดาห์

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

ต้องระบุ ชื่อผู้เผยแพร่

เมธอด

get

 รับแหล่งที่มาของพื้นที่โฆษณา

list

 แสดงรายการแหล่งที่มาของพื้นที่โฆษณา

patch

 อัปเดตแหล่งที่มาของพื้นที่โฆษณา