- แหล่งข้อมูล: InsertOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- เมธอด
แหล่งข้อมูล: InsertOrder
ใบสั่งซื้อการใส่โฆษณารายการเดียว
การแสดง JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของใบสั่งซื้อการใส่โฆษณา |
advertiserId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่มีใบสั่งซื้อการใส่โฆษณา |
campaignId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของแคมเปญที่มีใบสั่งซื้อการใส่โฆษณา |
insertionOrderId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของใบสั่งซื้อการใส่โฆษณา กำหนดโดยระบบ |
displayName |
ต้องระบุ ชื่อที่แสดงของใบสั่งซื้อการใส่โฆษณา ต้องเป็น UTF-8 ที่เข้ารหัสขนาดไม่เกิน 240 ไบต์ |
insertionOrderType |
ประเภทของใบสั่งซื้อการใส่โฆษณา หากไม่ได้ระบุช่องนี้ในการสร้าง ค่าเริ่มต้นจะเป็น |
entityStatus |
ต้องระบุ ควบคุมว่าใบสั่งซื้อการใส่โฆษณาจะใช้งบประมาณและราคาเสนอในพื้นที่โฆษณาได้หรือไม่
|
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาเมื่ออัปเดตใบสั่งซื้อการใส่โฆษณาครั้งล่าสุด กำหนดโดยระบบ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
partnerCosts[] |
ค่าใช้จ่ายของพาร์ทเนอร์ที่เชื่อมโยงกับใบสั่งซื้อการใส่โฆษณา หากไม่มีหรือเว้นว่างไว้ในเมธอด |
pacing |
ต้องระบุ การตั้งค่าความเร็วในการใช้จ่ายงบประมาณของใบสั่งซื้อการใส่โฆษณา |
frequencyCap |
ต้องระบุ การตั้งค่าการกำหนดความถี่สูงสุดของใบสั่งซื้อการใส่โฆษณา |
integrationDetails |
รายละเอียดการผสานรวมเพิ่มเติมของใบสั่งซื้อการใส่โฆษณา |
performanceGoal |
ต้องระบุ เป้าหมายประสิทธิภาพของใบสั่งซื้อการใส่โฆษณา |
budget |
ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของใบสั่งซื้อการใส่โฆษณา |
bidStrategy |
กลยุทธ์การเสนอราคาของใบสั่งซื้อการใส่โฆษณา ระบบจะตั้งค่า |
reservationType |
เอาต์พุตเท่านั้น ประเภทการจองของใบสั่งซื้อการใส่โฆษณา |
billableOutcome |
เปลี่ยนแปลงไม่ได้ ผลลัพธ์ที่เรียกเก็บเงินได้ของใบสั่งซื้อการใส่โฆษณา เลิกใช้งานการซื้อที่อิงตามผลลัพธ์แล้ว |
InsertionOrderType
ประเภทใบสั่งซื้อการใส่โฆษณาที่เป็นไปได้
ประเภทของใบสั่งซื้อการใส่โฆษณาจะเป็นตัวกำหนดการตั้งค่าและตัวเลือกที่ใช้ได้ เช่น รูปแบบโฆษณาหรือตัวเลือกการกำหนดเป้าหมาย
Enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
ไม่ได้ระบุหรือไม่รู้จักประเภทใบสั่งซื้อการใส่โฆษณา |
RTB |
การเสนอราคาแบบเรียลไทม์ |
OVER_THE_TOP |
การแพร่ภาพและเสียงผ่านโครงข่ายอินเทอร์เน็ต (Over The Top) |
InsertionOrderBudget
การตั้งค่าที่ควบคุมวิธีการจัดสรรงบประมาณใบสั่งซื้อการใส่โฆษณา
การแสดง JSON |
---|
{ "budgetUnit": enum ( |
ช่อง | |
---|---|
budgetUnit |
ต้องระบุ เปลี่ยนแปลงไม่ได้ หน่วยงบประมาณจะระบุว่างบประมาณอิงตามสกุลเงินหรือตามการแสดงผล |
automationType |
ประเภทของการทำงานอัตโนมัติที่ใช้จัดการราคาเสนอและงบประมาณสำหรับใบสั่งซื้อการใส่โฆษณา หากไม่ได้ระบุช่องนี้ในการสร้าง ค่าเริ่มต้นจะเป็น |
budgetSegments[] |
ต้องระบุ รายการกลุ่มงบประมาณ ใช้กลุ่มงบประมาณเพื่อระบุงบประมาณเฉพาะสำหรับช่วงเวลาที่ใบสั่งซื้อการใส่โฆษณาทำงาน |
InsertionOrderAutomationType
ตัวเลือกที่เป็นไปได้สำหรับการเสนอราคาและงบประมาณของใบสั่งซื้อการใส่โฆษณาโดยอัตโนมัติ
Enum | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
ไม่ได้ระบุตัวเลือกการทำงานอัตโนมัติของใบสั่งซื้อการใส่โฆษณาหรือไม่รู้จักในเวอร์ชันนี้ |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
การจัดสรรงบประมาณอัตโนมัติ ปล่อยให้ระบบย้ายงบประมาณไปใช้กับรายการโฆษณาที่เป็นเจ้าของโดยอัตโนมัติเพื่อเพิ่มประสิทธิภาพตามที่กำหนดโดย performanceGoal ไม่มีการทำงานอัตโนมัติในการตั้งค่าราคาเสนอ |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
ไม่มีการเสนอราคาหรืองบประมาณอัตโนมัติในระดับใบสั่งซื้อการใส่โฆษณา คุณต้องกำหนดค่าราคาเสนอและงบประมาณด้วยตนเองที่ระดับรายการโฆษณา |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
ปล่อยให้ระบบปรับราคาเสนอโดยอัตโนมัติและโยกย้ายงบประมาณไปเป็นรายการโฆษณาที่เป็นเจ้าของเพื่อเพิ่มประสิทธิภาพตามที่กำหนดโดย performanceGoal |
InsertionOrderBudgetSegment
การตั้งค่าที่ควบคุมงบประมาณของกลุ่มงบประมาณกลุ่มเดียว
การแสดง JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
ช่อง | |
---|---|
budgetAmountMicros |
ต้องระบุ จำนวนเงินงบประมาณที่ใบสั่งซื้อการใส่โฆษณาจะใช้สำหรับ |
description |
คำอธิบายกลุ่มงบประมาณ ซึ่งสามารถใช้เพื่อป้อนข้อมูลใบสั่งซื้อสำหรับกลุ่มงบประมาณแต่ละกลุ่ม แล้วพิมพ์ข้อมูลนั้นลงในใบแจ้งหนี้ ต้องเข้ารหัสแบบ UTF-8 |
dateRange |
ต้องระบุ การตั้งค่าวันที่เริ่มต้นและวันที่สิ้นสุดของกลุ่มงบประมาณ ค่าเหล่านี้จะได้รับการแก้ไขโดยสัมพันธ์กับเขตเวลาของผู้ลงโฆษณาหลัก
|
campaignBudgetId |
|
BillableOutcome
ผลลัพธ์ที่เรียกเก็บเงินได้สำหรับใบสั่งซื้อการใส่โฆษณา
Enum | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
ผลลัพธ์ที่เรียกเก็บเงินได้ที่ไม่ระบุ |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
จ่ายต่อการแสดงผล |
BILLABLE_OUTCOME_PAY_PER_CLICK |
จ่ายต่อคลิก |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
จ่ายต่อมุมมองแอ็กทีฟ |
เมธอด |
|
---|---|
|
สร้างใบสั่งซื้อการใส่โฆษณาใหม่ |
|
ลบใบสั่งซื้อการใส่โฆษณา |
|
รับใบสั่งซื้อการใส่โฆษณา |
|
แสดงรายการใบสั่งซื้อการใส่โฆษณาในส่วนผู้ลงโฆษณา |
|
แสดงรายการตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้ของใบสั่งซื้อการใส่โฆษณาประเภทต่างๆ ในการกําหนดเป้าหมาย |
|
อัปเดตใบสั่งซื้อการใส่โฆษณาที่มีอยู่ |