- แหล่งข้อมูล: ใบสั่งซื้อการใส่โฆษณา
- InsertionOrderType
- Kpi
- KpiType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- เมธอด
แหล่งข้อมูล: ใบสั่งซื้อการใส่โฆษณา
ใบสั่งซื้อการใส่โฆษณารายการเดียว
การแสดง 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) ของใบสั่งซื้อการใส่โฆษณา ซึ่งอาจเรียกว่า "เป้าหมาย" ในอินเทอร์เฟซ Display & Video 360 |
budget |
ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของใบสั่งซื้อการใส่โฆษณา |
bidStrategy |
กลยุทธ์การเสนอราคาของใบสั่งซื้อการใส่โฆษณา ระบบจะตั้งค่า |
reservationType |
เอาต์พุตเท่านั้น ประเภทการจองของใบสั่งซื้อการใส่โฆษณา |
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 ในเวอร์ชันนี้ |
KPI_TYPE_CPM |
KPI คือ CPM (ต้นทุนต่อการแสดงผลพันครั้ง) |
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 |
|
วิธีการ |
|
---|---|
|
สร้างใบสั่งซื้อการใส่โฆษณาใหม่ |
|
ลบใบสั่งซื้อการใส่โฆษณา |
|
รับใบสั่งซื้อการใส่โฆษณา |
|
แสดงรายการใบสั่งซื้อการใส่โฆษณาในผู้ลงโฆษณา |
|
รายการตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้ของใบสั่งซื้อการใส่โฆษณาในประเภทการกำหนดเป้าหมายต่างๆ |
|
อัปเดตใบสั่งซื้อการใส่โฆษณาที่มีอยู่ |