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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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)

เอาต์พุตเท่านั้น wseat ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณาในปัจจุบัน

lastModifiedTime

string (Timestamp format)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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 เช่น "อเมริกา/นิวยอร์ก" ซึ่งใช้สำหรับปริมาณรายวัน

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

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