- แหล่งข้อมูล: InsertOrder
- InsertionOrderType
- KPI
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- OptimizationObjective
- เมธอด
แหล่งข้อมูล: 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 |
รายละเอียดการผสานรวมเพิ่มเติมของใบสั่งซื้อการใส่โฆษณา |
kpi |
ต้องระบุ ตัวชี้วัดประสิทธิภาพ (KPI) ของใบสั่งซื้อการใส่โฆษณา ซึ่งอาจเรียกว่า "เป้าหมาย" ในหน้าจอและ อินเทอร์เฟซของ Video 360 |
budget |
ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของใบสั่งซื้อการใส่โฆษณา |
bidStrategy |
กลยุทธ์การเสนอราคาของใบสั่งซื้อการใส่โฆษณา ระบบจะตั้งค่า |
reservationType |
เอาต์พุตเท่านั้น ประเภทการจองของใบสั่งซื้อการใส่โฆษณา |
optimizationObjective |
ไม่บังคับ วัตถุประสงค์การเพิ่มประสิทธิภาพของใบสั่งซื้อการใส่โฆษณา ช่องนี้ใช้ได้เฉพาะลูกค้าที่อยู่ในรายการที่อนุญาตเท่านั้น หากลูกค้าไม่ได้อยู่ในรายการที่อนุญาต ช่องนี้จะเป็นค่าว่างและพยายามตั้งค่า ระบบจะแสดงข้อผิดพลาด |
InsertionOrderType
ประเภทใบสั่งซื้อการใส่โฆษณาที่เป็นไปได้
ประเภทของใบสั่งซื้อการใส่โฆษณาจะเป็นตัวกำหนดการตั้งค่าและตัวเลือกที่ใช้ได้ เช่น รูปแบบโฆษณาหรือตัวเลือกการกำหนดเป้าหมาย
Enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
ไม่ได้ระบุหรือไม่รู้จักประเภทใบสั่งซื้อการใส่โฆษณา |
RTB |
การเสนอราคาแบบเรียลไทม์ |
OVER_THE_TOP |
การแพร่ภาพและเสียงผ่านโครงข่ายอินเทอร์เน็ต (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 (ต้นทุนต่อการแสดงผลที่ได้แสดง 1,000 ครั้ง) |
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 หรือกลยุทธ์การเสนอราคาใดก็ได้ |
เมธอด |
|
---|---|
|
สร้างใบสั่งซื้อการใส่โฆษณาใหม่ |
|
ลบใบสั่งซื้อการใส่โฆษณา |
|
รับใบสั่งซื้อการใส่โฆษณา |
|
แสดงรายการใบสั่งซื้อการใส่โฆษณาในส่วนผู้ลงโฆษณา |
|
แสดงรายการตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้ของใบสั่งซื้อการใส่โฆษณาประเภทต่างๆ ในการกําหนดเป้าหมาย |
|
อัปเดตใบสั่งซื้อการใส่โฆษณาที่มีอยู่ |