- แหล่งข้อมูล: 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 |
จ่ายต่อมุมมองแอ็กทีฟ |
วิธีการ |
|
---|---|
|
รายการตัวเลือกการกำหนดเป้าหมายที่กำหนดสำหรับใบสั่งซื้อการใส่โฆษณาในการกำหนดเป้าหมายประเภทต่างๆ |
|
สร้างใบสั่งซื้อการใส่โฆษณาใหม่ |
|
ลบใบสั่งซื้อการใส่โฆษณา |
|
รับใบสั่งซื้อการใส่โฆษณา |
|
แสดงรายการใบสั่งซื้อการใส่โฆษณาในผู้ลงโฆษณา |
|
อัปเดตใบสั่งซื้อการใส่โฆษณาที่มีอยู่ |