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