REST Resource: advertisers.insertionOrders

แหล่งข้อมูล: ใบสั่งซื้อการใส่โฆษณา

ใบสั่งซื้อการใส่โฆษณารายการเดียว

การแสดง JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "displayName": string,
  "insertionOrderType": enum (InsertionOrderType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "performanceGoal": {
    object (PerformanceGoal)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "billableOutcome": enum (BillableOutcome)
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของใบสั่งซื้อการใส่โฆษณา
advertiserId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่มีใบสั่งซื้อการใส่โฆษณา
campaignId

string (int64 format)

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของแคมเปญที่มีใบสั่งซื้อการใส่โฆษณา
insertionOrderId

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของใบสั่งซื้อการใส่โฆษณา กำหนดโดยระบบ
displayName

string

ต้องระบุ ชื่อที่แสดงของใบสั่งซื้อการใส่โฆษณา

ต้องเป็นแบบ UTF-8 ที่เข้ารหัสด้วยขนาดสูงสุด 240 ไบต์
insertionOrderType

enum (InsertionOrderType)

ประเภทของใบสั่งซื้อการใส่โฆษณา

หากไม่ได้ระบุช่องนี้ในการสร้าง ค่าเริ่มต้นจะเป็น RTB
entityStatus

enum (EntityStatus)

ต้องระบุ ควบคุมว่าใบสั่งซื้อการใส่โฆษณาจะใช้งบประมาณและเสนอราคาในพื้นที่โฆษณาได้หรือไม่

  • สำหรับเมธอด insertionOrders.create จะอนุญาตเฉพาะ ENTITY_STATUS_DRAFT เท่านั้น หากต้องการเปิดใช้งานใบสั่งซื้อการใส่โฆษณา ให้ใช้เมธอด insertionOrders.patch แล้วอัปเดตสถานะเป็น ENTITY_STATUS_ACTIVE หลังจากสร้าง
  • ใบสั่งซื้อการใส่โฆษณาไม่สามารถเปลี่ยนกลับเป็นสถานะ ENTITY_STATUS_DRAFT จากสถานะอื่นๆ ได้
  • ไม่สามารถตั้งค่าใบสั่งซื้อการใส่โฆษณาเป็น ENTITY_STATUS_ACTIVE ได้ หากแคมเปญหลักไม่ทำงาน
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตใบสั่งซื้อการใส่โฆษณาครั้งล่าสุด กำหนดโดยระบบ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
partnerCosts[]

object (PartnerCost)

ค่าใช้จ่ายของพาร์ทเนอร์ที่เชื่อมโยงกับใบสั่งซื้อการใส่โฆษณา

หากไม่มีหรือว่างเปล่าในเมธอด insertionOrders.create ใบสั่งซื้อการใส่โฆษณาที่สร้างขึ้นใหม่จะรับค่าค่าใช้จ่ายของพาร์ทเนอร์จากการตั้งค่าของพาร์ทเนอร์
pacing

object (Pacing)

ต้องระบุ การตั้งค่าความเร็วในการใช้จ่ายงบประมาณของใบสั่งซื้อการใส่โฆษณา
frequencyCap

object (FrequencyCap)

ต้องระบุ การตั้งค่าการกำหนดความถี่สูงสุดของใบสั่งซื้อการใส่โฆษณา
integrationDetails

object (IntegrationDetails)

รายละเอียดการผสานรวมเพิ่มเติมของใบสั่งซื้อการใส่โฆษณา
performanceGoal

object (PerformanceGoal)

ต้องระบุ เป้าหมายประสิทธิภาพของใบสั่งซื้อการใส่โฆษณา
budget

object (InsertionOrderBudget)

ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของใบสั่งซื้อการใส่โฆษณา
bidStrategy

object (BiddingStrategy)

กลยุทธ์การเสนอราคาของใบสั่งซื้อการใส่โฆษณา ระบบจะตั้งค่า fixedBid ไว้โดยค่าเริ่มต้น
reservationType

enum (ReservationType)

เอาต์พุตเท่านั้น ประเภทการจองของใบสั่งซื้อการใส่โฆษณา
billableOutcome

enum (BillableOutcome)

เปลี่ยนแปลงไม่ได้ ผลลัพธ์ที่เรียกเก็บเงินได้ของใบสั่งซื้อการใส่โฆษณา

เลิกใช้งานการซื้อที่อิงตามผลลัพธ์แล้ว BILLABLE_OUTCOME_PAY_PER_IMPRESSION เป็นค่าเดียวที่ถูกต้อง

InsertionOrderType

ประเภทของใบสั่งซื้อการใส่โฆษณาที่เป็นไปได้

ประเภทของใบสั่งซื้อการใส่โฆษณาจะเป็นตัวกำหนดการตั้งค่าและตัวเลือกที่เกี่ยวข้อง เช่น รูปแบบโฆษณาหรือตัวเลือกการกำหนดเป้าหมาย

Enum
INSERTION_ORDER_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทใบสั่งซื้อการใส่โฆษณาหรือไม่ทราบประเภท
RTB การเสนอราคาแบบเรียลไทม์
OVER_THE_TOP การแพร่ภาพและเสียงผ่านโครงข่ายอินเทอร์เน็ต (Over The Top)

InsertionOrderBudget

การตั้งค่าที่ควบคุมวิธีจัดสรรงบประมาณใบสั่งซื้อการใส่โฆษณา

การแสดง JSON 
{
  "budgetUnit": enum (BudgetUnit),
  "automationType": enum (InsertionOrderAutomationType),
  "budgetSegments": [
    {
      object (InsertionOrderBudgetSegment)
    }
  ]
}
ช่อง
budgetUnit

enum (BudgetUnit)

ต้องระบุ เปลี่ยนแปลงไม่ได้ หน่วยงบประมาณจะระบุว่างบประมาณตามสกุลเงินหรือตามการแสดงผล
automationType

enum (InsertionOrderAutomationType)

ประเภทของการทำงานอัตโนมัติที่ใช้จัดการราคาเสนอและงบประมาณสำหรับใบสั่งซื้อการใส่โฆษณา

หากไม่ได้ระบุช่องนี้ในการสร้าง ค่าเริ่มต้นจะเป็น INSERTION_ORDER_AUTOMATION_TYPE_NONE
budgetSegments[]

object (InsertionOrderBudgetSegment)

ต้องระบุ รายการกลุ่มงบประมาณ ใช้กลุ่มงบประมาณเพื่อระบุงบประมาณที่เจาะจงสำหรับช่วงเวลาหนึ่งๆ ที่ใบสั่งซื้อการใส่โฆษณาทำงาน

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 (DateRange)
  },
  "campaignBudgetId": string
}
ช่อง
budgetAmountMicros

string (int64 format)

ต้องระบุ จํานวนงบประมาณที่ใบสั่งซื้อการใส่โฆษณาจะใช้สำหรับ dateRange ที่ระบุ จำนวนในหน่วยไมโคร ต้องมากกว่า 0 เช่น 500000000 หมายถึง 500 หน่วยมาตรฐานของสกุลเงิน
description

string

คำอธิบายกลุ่มงบประมาณ ซึ่งสามารถใช้เพื่อป้อนข้อมูลใบสั่งซื้อสําหรับกลุ่มงบประมาณแต่ละกลุ่ม และพิมพ์ข้อมูลดังกล่าวในใบแจ้งหนี้ได้

ต้องเข้ารหัส UTF-8
dateRange

object (DateRange)

ต้องระบุ การตั้งค่าวันที่เริ่มต้นและวันที่สิ้นสุดของกลุ่มงบประมาณ ซึ่งจะได้รับการแก้ไขตามเขตเวลาของผู้ลงโฆษณาหลัก

  • เมื่อสร้างกลุ่มงบประมาณใหม่ ทั้ง startDate และ endDate ต้องเป็นวันที่ในอนาคต
  • กลุ่มงบประมาณที่มีอยู่ซึ่งมี startDate ในอดีตมี endDate ที่เปลี่ยนแปลงได้ แต่มี startDate ที่เปลี่ยนแปลงไม่ได้
  • endDate ต้องเป็น startDate ขึ้นไป ทั้งคู่ก่อนปี 2037
campaignBudgetId

string (int64 format)

budgetId ของงบประมาณแคมเปญที่มีกลุ่มงบประมาณใบสั่งซื้อการใส่โฆษณานี้

BillableOutcome

ผลลัพธ์ที่เรียกเก็บเงินได้ที่เป็นไปได้สำหรับใบสั่งซื้อการใส่โฆษณา

Enum
BILLABLE_OUTCOME_UNSPECIFIED ผลลัพธ์ที่เรียกเก็บเงินไม่ได้ที่มีการระบุ
BILLABLE_OUTCOME_PAY_PER_IMPRESSION จ่ายต่อการแสดงผล
BILLABLE_OUTCOME_PAY_PER_CLICK

จ่ายต่อคลิก
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION

จ่ายต่อมุมมองแอ็กทีฟ

วิธีการ

create

 สร้างใบสั่งซื้อการใส่โฆษณาใหม่

delete

 ลบใบสั่งซื้อการใส่โฆษณา

get

 รับใบสั่งซื้อการใส่โฆษณา

list

 แสดงรายการใบสั่งซื้อการใส่โฆษณาในผู้ลงโฆษณา

listAssignedTargetingOptions

 รายการตัวเลือกการกำหนดเป้าหมายที่กำหนดไว้ของใบสั่งซื้อการใส่โฆษณาในประเภทการกำหนดเป้าหมายต่างๆ

patch

 อัปเดตใบสั่งซื้อการใส่โฆษณาที่มีอยู่