- ทรัพยากร: InsertionOrder
- InsertionOrderType
- Kpi
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- OptimizationObjective
- เมธอด
ทรัพยากร: InsertionOrder
ใบสั่งซื้อการใส่โฆษณารายการเดียว
การแสดง JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของใบสั่งซื้อการใส่โฆษณา |
advertiserId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของคําสั่งซื้อการแทรก |
campaignId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของแคมเปญที่คำสั่งซื้อการแทรกอยู่ |
insertionOrderId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของใบสั่งซื้อการใส่โฆษณา กำหนดโดยระบบ |
displayName |
ต้องระบุ ชื่อที่แสดงของใบสั่งซื้อการใส่โฆษณา ต้องเข้ารหัส UTF-8 และมีขนาดสูงสุด 240 ไบต์ |
insertionOrderType |
ไม่บังคับ ประเภทใบสั่งซื้อการใส่โฆษณา หากไม่ได้ระบุช่องนี้ในการสร้าง ค่าเริ่มต้นจะเป็น |
entityStatus |
ต้องระบุ ควบคุมว่าใบสั่งซื้อการใส่โฆษณาจะใช้งบประมาณและเสนอราคาในพื้นที่โฆษณาได้หรือไม่
|
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตคําสั่งซื้อการแทรกครั้งล่าสุด กำหนดโดยระบบ ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น |
partnerCosts[] |
ไม่บังคับ ค่าใช้จ่ายของพาร์ทเนอร์ที่เชื่อมโยงกับใบสั่งซื้อการใส่โฆษณา หากไม่มีหรือว่างเปล่าในวิธีการ |
pacing |
ต้องระบุ การตั้งค่าความเร็วในการใช้จ่ายงบประมาณของใบสั่งซื้อการใส่โฆษณา
|
frequencyCap |
ต้องระบุ การตั้งค่าการกำหนดความถี่สูงสุดของใบสั่งซื้อการใส่โฆษณา |
integrationDetails |
ไม่บังคับ รายละเอียดการผสานรวมเพิ่มเติมของใบสั่งซื้อการใส่โฆษณา |
kpi |
ต้องระบุ ตัวชี้วัดประสิทธิภาพ (KPI) ของใบสั่งซื้อการใส่โฆษณา ซึ่งจะแสดงเป็น "เป้าหมาย" ในอินเทอร์เฟซ Display & Video 360 |
budget |
ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของใบสั่งซื้อการใส่โฆษณา |
bidStrategy |
ไม่บังคับ กลยุทธ์การเสนอราคาของคําสั่งซื้อการแทรก โดยค่าเริ่มต้น ระบบจะตั้งค่าเป็น |
reservationType |
เอาต์พุตเท่านั้น ประเภทการจองของใบสั่งซื้อการใส่โฆษณา |
optimizationObjective |
ไม่บังคับ วัตถุประสงค์การเพิ่มประสิทธิภาพของใบสั่งซื้อการใส่โฆษณา |
InsertionOrderType
ประเภทของใบสั่งซื้อการใส่โฆษณาที่เป็นไปได้
ประเภทของคําสั่งซื้อการแทรกจะเป็นตัวกําหนดการตั้งค่าและตัวเลือกที่ใช้ได้ เช่น รูปแบบของโฆษณาหรือตัวเลือกการกําหนดเป้าหมาย
Enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
ไม่ได้ระบุหรือไม่ทราบประเภทใบสั่งซื้อการใส่โฆษณา |
RTB |
การเสนอราคาแบบเรียลไทม์ |
OVER_THE_TOP |
สุดยอด |
KPI
การตั้งค่าที่ควบคุมตัวชี้วัดประสิทธิภาพหลักหรือ KPI ของใบสั่งซื้อการใส่โฆษณา
การแสดง JSON |
---|
{ "kpiType": enum ( |
ช่อง | |
---|---|
kpiType |
ต้องระบุ ประเภท KPI |
kpiAlgorithmId |
ไม่บังคับ รหัสอัลกอริทึมการเสนอราคาที่กำหนดเองที่เชื่อมโยงกับ KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST ระบบจะละเว้นช่องนี้หากไม่ได้เลือก KPI ที่เหมาะสม |
ฟิลด์สหภาพ kpi_value ต้องระบุ ค่าของ KPI ช่องที่เกี่ยวข้องสอดคล้องกับ kpi_type kpi_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
kpiAmountMicros |
จํานวนเป้าหมายในสกุลเงินของผู้ลงโฆษณา มีผลบังคับใช้เมื่อ
เช่น 1500000 หมายถึง 1.5 หน่วยมาตรฐานของสกุลเงิน |
kpiPercentageMicros |
การนําเสนอทศนิยมของเปอร์เซ็นต์เป้าหมายเป็นไมโคร มีผลบังคับใช้เมื่อ
เช่น 70000 แสดงถึง 7% (ทศนิยม 0.07) |
kpiString |
สตริง KPI ซึ่งอาจว่างเปล่าได้ ต้องเข้ารหัส UTF-8 และมีความยาวไม่เกิน 100 อักขระ มีผลบังคับใช้เมื่อ |
KpiType
ประเภทตัวชี้วัดประสิทธิภาพ (KPI) ที่เป็นไปได้
Enum | |
---|---|
KPI_TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภท KPI หรือไม่ทราบในเวอร์ชันนี้ |
KPI_TYPE_CPM |
KPI คือ CPM (ต้นทุนต่อการแสดงผล 1,000 ครั้ง) |
KPI_TYPE_CPC |
KPI คือ CPC (ต้นทุนต่อคลิก) |
KPI_TYPE_CPA |
KPI คือ CPA (ต้นทุนต่อหนึ่งการกระทำ) |
KPI_TYPE_CTR |
KPI คือเปอร์เซ็นต์ CTR (อัตราการคลิกผ่าน) |
KPI_TYPE_VIEWABILITY |
KPI คือเปอร์เซ็นต์การมองเห็นโฆษณา |
KPI_TYPE_CPIAVC |
KPI คือ CPIAVC (ต้นทุนต่อการแสดงผลทั้งภาพและเสียงจนจบ) |
KPI_TYPE_CPE |
KPI คือ CPE (ต้นทุนต่อการมีส่วนร่วม) |
KPI_TYPE_CPV |
KPI ตั้งค่าเป็น CPV (ต้นทุนต่อการดู) |
KPI_TYPE_CLICK_CVR |
KPI คือเปอร์เซ็นต์อัตรา Conversion การคลิก (Conversion ต่อคลิก) |
KPI_TYPE_IMPRESSION_CVR |
KPI คือเปอร์เซ็นต์อัตรา Conversion ของการแสดงผล (Conversion ต่อการแสดงผล) |
KPI_TYPE_VCPM |
KPI คือ VCPM (ต้นทุนต่อการแสดงผลที่มองเห็นได้พันครั้ง) |
KPI_TYPE_VTR |
KPI คือเปอร์เซ็นต์อัตรายอดดู YouTube (ยอดดู YouTube ต่อการแสดงผล) |
KPI_TYPE_AUDIO_COMPLETION_RATE |
KPI คือเปอร์เซ็นต์อัตราการเล่นเสียงจนจบ (การฟังเสียงจนจบต่อการแสดงผล) |
KPI_TYPE_VIDEO_COMPLETION_RATE |
KPI คือเปอร์เซ็นต์อัตราการเล่นวิดีโอจนจบ (การดูวิดีโอจนจบต่อการแสดงผล) |
KPI_TYPE_CPCL |
KPI ได้รับการตั้งค่าใน CPCL (ต้นทุนต่อการฟังเสียงจนจบ) |
KPI_TYPE_CPCV |
KPI ตั้งค่าเป็น CPCV (ต้นทุนต่อการดูวิดีโอจนจบ) |
KPI_TYPE_TOS10 |
KPI นี้กําหนดเป็นอัตราเวลาที่แสดงบนหน้าจอนานกว่า 10 วินาที (เปอร์เซ็นต์ของการแสดงผลที่วัดได้ซึ่งข้ามไม่ได้และแสดงบนหน้าจออย่างน้อย 10 วินาที) |
KPI_TYPE_MAXIMIZE_PACING |
KPI ได้รับการกําหนดให้เพิ่มผลลัพธ์ของแบรนด์ให้ได้สูงสุด พร้อมกับให้ความสําคัญกับการใช้จ่ายงบประมาณทั้งหมด |
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST |
KPI ได้รับการกําหนดค่าเป็นมูลค่าของการแสดงผลที่กําหนดเองหารด้วยต้นทุน |
KPI_TYPE_OTHER |
KPI คือค่าอื่น |
InsertionOrderBudget
การตั้งค่าที่ควบคุมวิธีจัดสรรงบประมาณของคําสั่งซื้อการแทรก
การแสดง JSON |
---|
{ "budgetUnit": enum ( |
ช่อง | |
---|---|
budgetUnit |
ต้องระบุ เปลี่ยนแปลงไม่ได้ หน่วยงบประมาณจะระบุว่างบประมาณอิงตามสกุลเงินหรืออิงตามการแสดงผล |
automationType |
ไม่บังคับ ประเภทการทำงานอัตโนมัติที่ใช้จัดการราคาเสนอและงบประมาณสําหรับคําสั่งซื้อการแทรก หากไม่ได้ระบุช่องนี้ในการสร้าง ค่าเริ่มต้นจะเป็น |
budgetSegments[] |
ต้องระบุ รายการกลุ่มงบประมาณ ใช้กลุ่มงบประมาณเพื่อระบุงบประมาณที่เจาะจงสําหรับระยะเวลาที่ใบสั่งซื้อการใส่โฆษณาทํางาน |
InsertionOrderAutomationType
ตัวเลือกที่เป็นไปได้สำหรับการเสนอราคาและงบประมาณของคําสั่งซื้อการแทรกอัตโนมัติ
Enum | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
ไม่ได้ระบุตัวเลือกการทำงานอัตโนมัติของคําสั่งซื้อที่แทรกหรือไม่ทราบในเวอร์ชันนี้ |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
การจัดสรรงบประมาณอัตโนมัติ อนุญาตให้ระบบย้ายงบประมาณไปยังบรรทัดรายการที่เป็นเจ้าของโดยอัตโนมัติเพื่อเพิ่มประสิทธิภาพที่ kpi กำหนด ไม่มีการตั้งค่าราคาเสนออัตโนมัติ |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
ไม่มีการทำงานอัตโนมัติของราคาเสนอหรืองบประมาณในระดับใบสั่งซื้อการใส่โฆษณา คุณต้องกําหนดค่าราคาเสนอและงบประมาณด้วยตนเองที่ระดับรายการโฆษณา |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
อนุญาตให้ระบบปรับราคาเสนอและย้ายงบประมาณไปยังบรรทัดรายการที่เป็นเจ้าของโดยอัตโนมัติเพื่อเพิ่มประสิทธิภาพที่ kpi กำหนด |
InsertionOrderBudgetSegment
การตั้งค่าที่ควบคุมงบประมาณของกลุ่มงบประมาณเดียว
การแสดง JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
ช่อง | |
---|---|
budgetAmountMicros |
ต้องระบุ จํานวนงบประมาณที่ใบสั่งซื้อการใส่โฆษณาจะใช้จ่ายสําหรับ |
description |
ไม่บังคับ คําอธิบายกลุ่มงบประมาณ สามารถใช้เพื่อป้อนข้อมูลใบสั่งซื้อสำหรับแต่ละกลุ่มงบประมาณและพิมพ์ข้อมูลดังกล่าวในใบแจ้งหนี้ ต้องเข้ารหัส UTF-8 |
dateRange |
ต้องระบุ การตั้งค่าวันที่เริ่มต้นและวันที่สิ้นสุดของกลุ่มงบประมาณ โดยระบบจะแก้ไขเวลาเหล่านี้ตามเขตเวลาของผู้ลงโฆษณาหลัก
|
campaignBudgetId |
ไม่บังคับ |
OptimizationObjective
ประเภทวัตถุประสงค์การเพิ่มประสิทธิภาพที่เป็นไปได้
Enum | |
---|---|
OPTIMIZATION_OBJECTIVE_UNSPECIFIED |
ไม่ได้ระบุค่าประเภทหรือค่าประเภทไม่รู้จักในเวอร์ชันนี้ |
CONVERSION |
ให้ความสําคัญกับการแสดงผลที่เพิ่มยอดขายและ Conversion |
CLICK |
จัดลําดับความสําคัญของการแสดงผลที่เพิ่มการเข้าชมเว็บไซต์ แอป App Store |
BRAND_AWARENESS |
ให้ความสําคัญกับการแสดงผลที่มีคุณภาพหนึ่งๆ |
CUSTOM |
วัตถุประสงค์จะกําหนดโดยอัลกอริทึมการเสนอราคาที่กําหนดเอง |
NO_OBJECTIVE |
ไม่ได้กําหนดวัตถุประสงค์ คุณใช้ KPI หรือกลยุทธ์การเสนอราคาใดก็ได้ |
เมธอด |
|
---|---|
|
สร้างใบสั่งซื้อการใส่โฆษณาใหม่ |
|
ลบใบสั่งซื้อการใส่โฆษณา |
|
รับใบสั่งซื้อการใส่โฆษณา |
|
แสดงคําสั่งซื้อการแทรกในผู้ลงโฆษณา |
|
แสดงตัวเลือกการกำหนดเป้าหมายที่กำหนดของใบสั่งซื้อการใส่โฆษณาในประเภทการกำหนดเป้าหมายต่างๆ |
|
อัปเดตคําสั่งซื้อการแทรกที่มีอยู่ |