- ทรัพยากร: InventorySource
- BuyerStatus
- SellerStatus
- InventorySourceVolumeForecast
- DailyVolume
- DayOfWeek
- CreativeApprovalConfig
- PublisherConfig
- เมธอด
ทรัพยากร: InventorySource
รูปแบบการเรียกใช้ของแหล่งข้อมูลพื้นที่โฆษณา DV360
การแสดง JSON |
---|
{ "name": string, "buyerStatus": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรแบบสัมพัทธ์สำหรับคำสั่งซื้อ สร้างโดยเซิร์ฟเวอร์ ตัวอย่างเช่น "exchanges/1234/inventorySources/5678" |
buyerStatus |
เอาต์พุตเท่านั้น สถานะผู้ซื้อ |
sellerStatus |
สถานะผู้ขาย |
transactionType |
เอาต์พุตเท่านั้น ประเภทธุรกรรมของผลิตภัณฑ์ |
pricingType |
เอาต์พุตเท่านั้น ประเภทการกำหนดราคาสำหรับผลิตภัณฑ์ |
rateDetails |
เอาต์พุตเท่านั้น รายละเอียดราคา |
startTime |
เอาต์พุตเท่านั้น เวลาเมื่อผลิตภัณฑ์นี้เริ่มทำงาน ต้องมาก่อน endTime เวลาเริ่มต้นต้องไม่เกิน 1 ปีนับจากนี้ ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น |
endTime |
เอาต์พุตเท่านั้น เวลาเมื่อผลิตภัณฑ์นี้ไม่มีการใช้งาน ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น |
exchangeVolumeForecast |
การคาดการณ์ปริมาณรายวันที่ได้จาก Exchange ใช้เพื่อกําหนดอัตราการแสดงโฆษณาและเปิดใช้ทางเลือกของผู้ซื้อ ช่องนี้เลิกใช้งานแล้ว |
audienceMatchRate |
เอาต์พุตเท่านั้น อัตราการจับคู่กลุ่มเป้าหมายที่คาดการณ์ไว้สําหรับดีลการรับประกันแบบเป็นโปรแกรมที่มีการกำหนดเป้าหมายตามกลุ่มเป้าหมาย ซึ่ง Exchange จะใช้เพื่อกําหนดจํานวนคําขอเพิ่มเติมที่ควรส่ง ค่านี้เป็นทศนิยมระหว่าง 0 ถึง 1 ซึ่งควรใช้ค่าผกผันเป็นตัวคูณของการแสดงผล 0 บ่งบอกว่าไม่ได้ตั้งค่าช่อง จึงไม่มีการกําหนดกลุ่มเป้าหมาย เช่น "0.125" ซึ่งหมายความว่าคําขอ 12.5% ตรงกับการกําหนดเป้าหมายกลุ่มเป้าหมาย และจํานวนคําขอที่ส่งควรเป็น 8 เท่าของการแสดงผลที่เจรจาต่อรอง |
makegoodRequested |
เอาต์พุตเท่านั้น ระบุว่ามีการขอการชดเชยจากผู้ซื้อหรือไม่ |
makegoodRequestedReason |
เอาต์พุตเท่านั้น เหตุผลที่ผู้ซื้อส่งคำขอการชดเชย |
percentFrequencyCapExcludedTraffic |
เปอร์เซ็นต์ของการเข้าชมที่ยกเว้นจากความถี่สูงสุดสำหรับดีลที่รับประกันแบบเป็นโปรแกรม ค่านี้เป็นจำนวนเต็มระหว่าง 0 ถึง 100 ค่า 0 (ซึ่งเป็นค่าเริ่มต้นด้วย) หมายถึงไม่มีการยกเว้น ดังนั้นการเข้าชมทั้งหมดจะมีสิทธิ์ใช้ขีดจํากัดความถี่ ส่วน 100 หมายถึงการยกเว้นทั้งหมด ดังนั้นระบบจะไม่ใช้ขีดจํากัดความถี่ ค่าระหว่าง 0 ถึง 100 จะส่งผลให้มีการยกเว้นบางส่วน เช่น ค่า 20 จะส่งผลให้มีการยกเว้นการเข้าชม 20% จากความถี่สูงสุด |
dv360WseatId[] |
เอาต์พุตเท่านั้น wseat ที่มีสิทธิ์เข้าถึงแหล่งที่มาของพื้นที่โฆษณาในปัจจุบัน |
lastModifiedTime |
เอาต์พุตเท่านั้น ครั้งล่าสุดที่อัปเดตแหล่งที่มาของสินค้าคงคลัง โปรดทราบว่าการอัปเดตภายในของ DV3 บางรายการจะเปลี่ยนเวลาแก้ไขล่าสุด ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น |
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 ( |
ช่อง | |
---|---|
dailyVolumes[] |
การคาดการณ์ปริมาณรายวัน |
timeZoneId |
เขตเวลาของฐานข้อมูลเขตเวลา IANA เช่น "อเมริกา/นิวยอร์ก" ซึ่งใช้สำหรับปริมาณรายวัน |
DailyVolume
ขอปริมาณสำหรับแหล่งที่มาของพื้นที่โฆษณาในวันหนึ่งๆ
การแสดง JSON |
---|
{
"day": enum ( |
ช่อง | |
---|---|
day |
วันของสัปดาห์ที่มีปริมาณคำขอ |
volume |
ปริมาณคำขอที่คาดการณ์สำหรับวันในสัปดาห์ที่ระบุ |
วันของสัปดาห์
แสดงวันของสัปดาห์
Enum | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
ไม่ระบุวันของสัปดาห์ |
MONDAY |
วันจันทร์ |
TUESDAY |
อังคาร |
WEDNESDAY |
พุธ |
THURSDAY |
พฤหัสบดี |
FRIDAY |
ศุกร์ |
SATURDAY |
เสาร์ |
SUNDAY |
วันอาทิตย์ |
CreativeApprovalConfig
การกําหนดค่าสําหรับการอนุมัติครีเอทีฟโฆษณา
การแสดง JSON |
---|
{
"requiresExchangeApproval": boolean,
"publisherConfigs": [
{
object ( |
ช่อง | |
---|---|
requiresExchangeApproval |
ต้องระบุ ระบุว่าครีเอทีฟโฆษณาต้องได้รับการอนุมัติก่อนส่งผ่านข้อมูลในระดับการแลกเปลี่ยนหรือไม่ |
publisherConfigs[] |
ไม่บังคับ การกําหนดค่าสําหรับผู้เผยแพร่โฆษณา |
PublisherConfig
การกําหนดค่าสําหรับผู้เผยแพร่โฆษณา (publisher_config) หากตั้งค่า publisher_config ไว้ ครีเอทีฟโฆษณาจะต้องได้รับการอนุมัติก่อนนำเข้าที่ระดับผู้เผยแพร่โฆษณา
การแสดง JSON |
---|
{ "publisherId": string, "publisherDisplayName": string } |
ช่อง | |
---|---|
publisherId |
ต้องระบุ รหัสผู้เผยแพร่โฆษณา |
publisherDisplayName |
ต้องระบุ ชื่อผู้เผยแพร่โฆษณา |
เมธอด |
|
---|---|
|
รับแหล่งที่มาของพื้นที่โฆษณา |
|
แสดงรายการแหล่งที่มาของพื้นที่โฆษณา |
|
อัปเดตแหล่งที่มาของพื้นที่โฆษณา |