REST Resource: advertisers.lineItems

แหล่งข้อมูล: LineItem

รายการโฆษณาเดียว

การแสดง JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
ช่อง
name

string

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

string (int64 format)

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

string (int64 format)

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของแคมเปญที่มีรายการโฆษณานี้
insertionOrderId

string (int64 format)

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

string (int64 format)

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

string

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

ต้องเป็น UTF-8 ที่เข้ารหัสขนาดไม่เกิน 240 ไบต์
lineItemType

enum (LineItemType)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทของรายการโฆษณา
entityStatus

enum (EntityStatus)

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

  • สำหรับเมธอด lineItems.create ระบบจะอนุญาตเพียง ENTITY_STATUS_DRAFT เท่านั้น หากต้องการเปิดใช้งานรายการโฆษณา ให้ใช้เมธอด lineItems.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)

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

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

object (LineItemFlight)

ต้องระบุ เวลาเริ่มต้นและสิ้นสุดการแสดงโฆษณาของรายการโฆษณา
budget

object (LineItemBudget)

ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของรายการโฆษณา
pacing

object (Pacing)

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

object (FrequencyCap)

ต้องระบุ การตั้งค่าความถี่สูงสุดในการแสดงผลของรายการโฆษณา

ต้องใช้ช่อง maxImpressions ในออบเจ็กต์การตั้งค่านี้หากกำหนดขีดจำกัดสูงสุด
partnerRevenueModel

object (PartnerRevenueModel)

ต้องระบุ การตั้งค่ารูปแบบรายได้ของพาร์ทเนอร์ของรายการโฆษณา
conversionCounting

object (ConversionCountingConfig)

การตั้งค่าเครื่องมือวัด Conversion ของรายการโฆษณา
creativeIds[]

string (int64 format)

รหัสของครีเอทีฟโฆษณาที่เชื่อมโยงกับรายการโฆษณา
bidStrategy

object (BiddingStrategy)

ต้องระบุ กลยุทธ์การเสนอราคาของรายการโฆษณา
integrationDetails

object (IntegrationDetails)

รายละเอียดการผสานรวมของรายการโฆษณา
inventorySourceIds[]

string (int64 format)

รหัสของแหล่งที่มาของพื้นที่โฆษณาส่วนตัวที่กำหนดให้กับรายการโฆษณา
targetingExpansion

object (TargetingExpansionConfig)

การตั้งค่าการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพของรายการโฆษณา

การกำหนดค่านี้ใช้ได้กับรายการโฆษณา Display, วิดีโอ หรือเสียงที่ใช้การเสนอราคาอัตโนมัติและกำหนดเป้าหมายรายการกลุ่มเป้าหมายที่มีสิทธิ์ในเชิงบวก
warningMessages[]

enum (LineItemWarningMessage)

เอาต์พุตเท่านั้น ข้อความเตือนที่สร้างโดยรายการโฆษณา คำเตือนเหล่านี้ไม่ได้บล็อกการบันทึกรายการโฆษณา แต่คำเตือนบางส่วนอาจบล็อกไม่ให้รายการโฆษณาทำงาน
mobileApp

object (MobileApp)

แอปบนอุปกรณ์เคลื่อนที่ที่รายการโฆษณาโปรโมต

วิธีนี้จะใช้ได้เฉพาะเมื่อ lineItemType เป็น LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL หรือ LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL
reservationType

enum (ReservationType)

เอาต์พุตเท่านั้น ประเภทการจองของรายการโฆษณา
excludeNewExchanges

boolean

ระบุว่าจะยกเว้นการแลกเปลี่ยนใหม่ไม่ให้รายการโฆษณากำหนดเป้าหมายโดยอัตโนมัติหรือไม่ โดยค่าเริ่มต้น ฟิลด์นี้จะเป็นเท็จ

LineItemType

ประเภทรายการโฆษณาที่เป็นไปได้

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

Enum
LINE_ITEM_TYPE_UNSPECIFIED

ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้

สร้างหรืออัปเดตรายการโฆษณาประเภทนี้โดยใช้ API ไม่ได้
LINE_ITEM_TYPE_DISPLAY_DEFAULT โฆษณาแบบรูปภาพ, HTML5, โฆษณาเนทีฟ หรือโฆษณาแบบริชมีเดีย
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL โฆษณา Display ที่เพิ่มยอดติดตั้งแอป
LINE_ITEM_TYPE_VIDEO_DEFAULT โฆษณาวิดีโอขายแบบ CPM ในสภาพแวดล้อมที่หลากหลาย
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL โฆษณาวิดีโอที่กระตุ้นการติดตั้งแอป
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

โฆษณาแบบดิสเพลย์ที่แสดงในพื้นที่โฆษณาในแอปบนอุปกรณ์เคลื่อนที่

สร้างหรืออัปเดตรายการโฆษณาประเภทนี้โดยใช้ API ไม่ได้
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

โฆษณาวิดีโอที่แสดงในพื้นที่โฆษณาในแอปบนอุปกรณ์เคลื่อนที่

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

LineItemFlight

การตั้งค่าที่ควบคุมระยะเวลาที่ใช้งานของรายการโฆษณา

การแสดง JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
ช่อง
flightDateType

enum (LineItemFlightDateType)

ต้องระบุ ประเภทวันที่แสดงโฆษณาของรายการโฆษณา
dateRange

object (DateRange)

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

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

string (int64 format)

รหัสของทริกเกอร์ด้วยตนเองที่เชื่อมโยงกับรายการโฆษณา

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

คำเตือน: รายการโฆษณาที่ใช้ทริกเกอร์ด้วยตนเองจะไม่แสดงในดิสเพลย์และ วิดีโอ 360 ช่องนี้จะสิ้นสุดในวันที่ 1 สิงหาคม 2023 โปรดอ่านข้อมูลเพิ่มเติมในประกาศการเลิกใช้งานฟีเจอร์

LineItemFlightDateType

ประเภทวันที่แสดงโฆษณาของรายการโฆษณาที่เป็นไปได้

Enum
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED วันที่แสดงโฆษณาของรายการโฆษณาจะรับค่าจากใบสั่งซื้อการใส่โฆษณาระดับบนสุด
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM รายการโฆษณาใช้วันที่แสดงโฆษณาที่กำหนดเอง
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

รายการโฆษณาใช้ทริกเกอร์

คำเตือน: รายการโฆษณาที่ใช้ทริกเกอร์ด้วยตนเองจะไม่แสดงในดิสเพลย์และ วิดีโอ 360 ค่านี้จะเลิกใช้งานในวันที่ 1 สิงหาคม 2023 โปรดอ่านข้อมูลเพิ่มเติมในประกาศการเลิกใช้งานฟีเจอร์

LineItemBudget

การตั้งค่าที่ควบคุมวิธีการจัดสรรงบประมาณ

การแสดง JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
ช่อง
budgetAllocationType

enum (LineItemBudgetAllocationType)

ต้องระบุ ประเภทของการจัดสรรงบประมาณ

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC จะใช้ได้เฉพาะเมื่อมีการเปิดใช้การจัดสรรงบประมาณอัตโนมัติสำหรับใบสั่งซื้อการใส่โฆษณาหลักเท่านั้น
budgetUnit

enum (BudgetUnit)

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

string (int64 format)

จำนวนงบประมาณสูงสุดที่รายการโฆษณาจะใช้จ่าย ต้องมากกว่า 0

เมื่อbudgetAllocationTypeเป็น

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC ช่องนี้จะเปลี่ยนแปลงไม่ได้และระบบตั้งค่าไว้
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED หาก budgetUnit เป็น
    • BUDGET_UNIT_CURRENCY ช่องนี้จะแสดงจำนวนงบประมาณสูงสุดที่จะใช้จ่าย เป็นไมโครสกุลเงินของผู้ลงโฆษณา เช่น 1500000 หมายถึง 1.5 หน่วยมาตรฐานของสกุลเงิน
    • BUDGET_UNIT_IMPRESSIONS ฟิลด์นี้แสดงจำนวนการแสดงผลสูงสุดที่จะแสดง
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED ช่องนี้ไม่เกี่ยวข้องและระบบจะไม่สนใจช่องนี้

LineItemBudgetAllocationType

ประเภทการจัดสรรงบประมาณที่เป็นไปได้

Enum
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC มีการเปิดใช้การจัดสรรงบประมาณอัตโนมัติสำหรับรายการโฆษณานี้
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED มีการกำหนดจำนวนงบประมาณสูงสุดคงที่สำหรับรายการโฆษณา
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED ไม่มีการใช้ขีดจำกัดของงบประมาณกับรายการโฆษณา

PartnerRevenueModel

การตั้งค่าที่ควบคุมวิธีคำนวณรายได้ของพาร์ทเนอร์

การแสดง JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
ช่อง
markupType

enum (PartnerRevenueModelMarkupType)

ต้องระบุ ประเภทมาร์กอัปของรูปแบบรายได้ของพาร์ทเนอร์
markupAmount

string (int64 format)

ต้องระบุ จำนวนมาร์กอัปของรูปแบบรายได้ของพาร์ทเนอร์ ต้องมากกว่าหรือเท่ากับ 0

  • เมื่อกำหนด markupType เป็น PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM ฟิลด์นี้จะแสดงมาร์กอัป CPM ในระดับไมโครสกุลเงินของผู้ลงโฆษณา เช่น 1500000 หมายถึง 1.5 หน่วยมาตรฐานของสกุลเงิน
  • เมื่อกำหนด markupType เป็น PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP ช่องนี้จะแสดงมาร์กอัปเปอร์เซ็นต์ค่าใช้จ่ายสื่อในหน่วยมิลลิวินาที เช่น 100 หมายถึง 0.1% (ทศนิยม 0.001)
  • เมื่อกำหนด markupType เป็น PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP ช่องนี้จะแสดงมาร์กอัปเปอร์เซ็นต์ค่าใช้จ่ายสื่อทั้งหมดเป็นมิลลิวินาที เช่น 100 หมายถึง 0.1% (ทศนิยม 0.001)

PartnerRevenueModelMarkupType

ประเภทมาร์กอัปที่เป็นไปได้ของรูปแบบรายได้ของพาร์ทเนอร์

Enum
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM คำนวณรายได้ของพาร์ทเนอร์ตาม CPM คงที่
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

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

ConversionCountingConfig

การตั้งค่าที่ควบคุมวิธีนับ Conversion

ระบบจะนับ Conversion หลังการคลิกทั้งหมด คุณกำหนดค่าเปอร์เซ็นต์สำหรับการนับ Conversion หลังการดูได้

การแสดง JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
ช่อง
postViewCountPercentageMillis

string (int64 format)

เปอร์เซ็นต์ของ Conversion หลังการดูที่จะนับเป็นมิลลิวินาที (1/1000 ของเปอร์เซ็นต์) ต้องอยู่ระหว่าง 0 ถึง 100,000

ตัวอย่างเช่น หากต้องการติดตาม Conversion หลังการคลิก 50% ให้กำหนดมูลค่าเป็น 50,000
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

การกำหนดค่ากิจกรรม Floodlight ที่ใช้เพื่อติดตาม Conversion

จํานวน Conversion ที่นับคือผลรวมของ Conversion ทั้งหมดที่นับตามรหัสกิจกรรม Floodlight ทั้งหมดที่ระบุไว้ในช่องนี้

TrackingFloodlightActivityConfig

การตั้งค่าที่ควบคุมลักษณะการทำงานของการกำหนดค่ากิจกรรม Floodlight รายการเดียว

การแสดง JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
ช่อง
floodlightActivityId

string (int64 format)

ต้องระบุ รหัสกิจกรรม Floodlight
postClickLookbackWindowDays

integer

ต้องระบุ จำนวนวันหลังจากที่มีการคลิกโฆษณาซึ่งระบบจะนับ Conversion ต้องอยู่ระหว่าง 0 ถึง 90
postViewLookbackWindowDays

integer

ต้องระบุ จำนวนวันหลังจากที่มีการดูโฆษณาซึ่งระบบจะนับ Conversion ต้องอยู่ระหว่าง 0 ถึง 90

TargetingExpansionConfig

การตั้งค่าที่ควบคุมการตั้งค่าการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพของรายการโฆษณา

การแสดง JSON 
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
ช่อง
targetingExpansionLevel

enum (TargetingExpansionLevel)

ต้องระบุ เปิดใช้การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพหรือไม่

ช่องนี้รองรับค่าต่อไปนี้

  • NO_EXPANSION: การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพปิดอยู่
  • LEAST_EXPANSION: การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพเปิดอยู่

หากตั้งค่าช่องนี้เป็นค่าอื่น ระบบจะตั้งค่าเป็น LEAST_EXPANSION โดยอัตโนมัติ

NO_EXPANSION จะเป็นค่าเริ่มต้นของช่อง และระบบจะกําหนดให้โดยอัตโนมัติหากคุณไม่ตั้งค่าช่อง
excludeFirstPartyAudience
(deprecated)

boolean

ต้องการยกเว้นกลุ่มเป้าหมายบุคคลที่หนึ่งไม่ให้ใช้ในการขยายการกำหนดเป้าหมายหรือไม่

ช่องนี้เลิกใช้งานแล้วเมื่อเปิดตัวการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ

ระบบจะตั้งค่าช่องนี้เป็น false หากตั้งค่าช่องนี้เป็น true เมื่อเลิกใช้งาน ระบบจะแทนที่การกำหนดกลุ่มเป้าหมายบุคคลที่หนึ่งเชิงบวกทั้งหมดที่กำหนดให้กับรายการโฆษณานี้ด้วยการกำหนดเป้าหมายเชิงลบของกลุ่มเป้าหมายบุคคลที่หนึ่งเดียวกันเพื่อให้การยกเว้นกลุ่มเป้าหมายเหล่านั้นต่อไป

TargetingExpansionLevel

การตั้งค่าการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ

Enum
TARGETING_EXPANSION_LEVEL_UNSPECIFIED ไม่ได้ระบุหรือไม่รู้จักการตั้งค่าการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพในเวอร์ชันนี้
NO_EXPANSION การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพปิดอยู่
LEAST_EXPANSION การกําหนดเป้าหมายแบบเพิ่มประสิทธิภาพเปิดอยู่
SOME_EXPANSION

หากใช้ ระบบจะตั้งค่าเป็น LEAST_EXPANSION โดยอัตโนมัติ
BALANCED_EXPANSION

หากใช้ ระบบจะตั้งค่าเป็น LEAST_EXPANSION โดยอัตโนมัติ
MORE_EXPANSION

หากใช้ ระบบจะตั้งค่าเป็น LEAST_EXPANSION โดยอัตโนมัติ
MOST_EXPANSION

หากใช้ ระบบจะตั้งค่าเป็น LEAST_EXPANSION โดยอัตโนมัติ

LineItemWarningMessage

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

Enum
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED ไม่ได้ระบุหรือไม่รู้จัก
INVALID_FLIGHT_DATES รายการโฆษณานี้มีวันที่ของช่วงเวลาแสดงโฆษณาที่ไม่ถูกต้อง รายการโฆษณาจะไม่ทำงาน
EXPIRED วันที่สิ้นสุดของรายการโฆษณานี้เป็นวันที่ผ่านมาแล้ว
PENDING_FLIGHT รายการโฆษณานี้จะเริ่มทำงานในอนาคต
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED การแลกเปลี่ยนที่เปิดใช้โดยพาร์ทเนอร์ทั้งหมดได้รับการกำหนดเป้าหมายเชิงลบ รายการโฆษณาจะไม่ทำงาน
INVALID_INVENTORY_SOURCE ไม่ได้กำหนดเป้าหมายเป็นแหล่งที่มาของพื้นที่โฆษณาซึ่งใช้อยู่ รายการโฆษณาจะไม่ทำงาน
APP_INVENTORY_INVALID_SITE_TARGETING การกำหนดเป้าหมายแอปและ URL ของรายการโฆษณานี้ไม่รวมแอปบนอุปกรณ์เคลื่อนที่ใดเลย ประเภทของรายการโฆษณานี้กำหนดให้คุณรวมแอปบนอุปกรณ์เคลื่อนที่ไว้ในการกำหนดเป้าหมายแชแนล รายการเว็บไซต์ หรือแอป รายการโฆษณาจะไม่ทำงาน
APP_INVENTORY_INVALID_AUDIENCE_LISTS รายการโฆษณานี้ไม่ได้กำหนดเป้าหมายผู้ใช้อุปกรณ์เคลื่อนที่รายใดเลย ประเภทของรายการโฆษณานี้กำหนดให้คุณกำหนดเป้าหมายรายการผู้ใช้ด้วยผู้ใช้อุปกรณ์เคลื่อนที่ รายการโฆษณาจะไม่ทำงาน
NO_VALID_CREATIVE รายการโฆษณานี้ไม่มีครีเอทีฟโฆษณาที่ถูกต้อง รายการโฆษณาจะไม่ทำงาน
PARENT_INSERTION_ORDER_PAUSED ใบสั่งซื้อการใส่โฆษณาของรายการโฆษณานี้หยุดชั่วคราวอยู่ รายการโฆษณาจะไม่ทำงาน
PARENT_INSERTION_ORDER_EXPIRED ใบสั่งซื้อการใส่โฆษณาของรายการโฆษณานี้มีวันที่สิ้นสุดเป็นวันที่ที่ผ่านมาแล้ว รายการโฆษณาจะไม่ทำงาน
NO_POSITIVE_AUDIENCE_LIST_TARGETED รายการโฆษณานี้ไม่ได้กำหนดเป้าหมายรายการกลุ่มเป้าหมายใดเลย ซึ่งอาจส่งผลให้ใช้จ่ายงบประมาณของคุณเร็วเกินไป
APP_INSTALL_NO_CONVERSION_PIXEL รายการโฆษณาเพื่อการติดตั้งแอปนี้ไม่ได้ตั้งค่าพิกเซล Conversion ไว้
TARGETING_REVOKED_OR_CLOSED_USER_LIST รายการโฆษณานี้กำหนดเป้าหมายรายการผู้ใช้อย่างน้อย 1 รายการที่ใช้ไม่ได้อีกต่อไปแล้ว ซึ่งจะทำให้รายการโฆษณาไม่แสดงในอนาคต ดังนั้นให้พิจารณานำรายการเหล่านี้ออกจากการกำหนดเป้าหมาย
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY รายการโฆษณาเพื่อการติดตั้งแอปนี้ไม่มีกลยุทธ์การเสนอราคาที่เหมาะสมที่สุด
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS ดีลที่รายการโฆษณานี้กำหนดเป้าหมายยอมรับขนาดโฆษณาซึ่งไม่ได้ใช้อยู่ ซึ่งอาจจำกัดการแสดงผลหรือประสิทธิภาพของรายการโฆษณา
NO_CREATIVE_FOR_TARGETED_DEALS รายการโฆษณานี้ไม่มีครีเอทีฟโฆษณาสำหรับดีลเป้าหมาย
TARGETING_DEPRECATED_GEO_TARGET รายการโฆษณานี้กำหนดเป้าหมายเป็นเป้าหมายทางภูมิศาสตร์ที่เลิกใช้งานแล้ว
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

รายการโฆษณานี้ใช้การตั้งค่า excludeFirstPartyAudience ซึ่งเลิกใช้งานแล้วและมีกำหนดเลิกใช้งานหลังจากวันที่ 25 มีนาคม 2023

อัปเดตการผสานรวม API ให้ยกเว้นกลุ่มเป้าหมายบุคคลที่หนึ่งโดยตรงโดยใช้การกำหนดกลุ่มเป้าหมายก่อนวันที่ 25 มีนาคม 2023 เนื่องจากช่อง excludeFirstPartyAudience จะหยุดให้บริการ

MobileApp

แอปบนอุปกรณ์เคลื่อนที่ที่โปรโมตโดยรายการโฆษณาเพื่อการติดตั้งแอปบนอุปกรณ์เคลื่อนที่

การแสดง JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
ช่อง
appId

string

ต้องระบุ รหัสของแอปที่ร้านค้าของแพลตฟอร์มให้ไว้

แอป Android จะระบุด้วยรหัสชุดที่ Play Store ของ Android ใช้ เช่น com.google.android.gm

แอป iOS จะระบุด้วยรหัสแอป 9 หลักที่ App Store ของ Apple ใช้ เช่น 422689480
platform

enum (Platform)

เอาต์พุตเท่านั้น แพลตฟอร์มของแอป
displayName

string

เอาต์พุตเท่านั้น ชื่อแอป
publisher

string

เอาต์พุตเท่านั้น ผู้เผยแพร่แอป

แพลตฟอร์ม

แพลตฟอร์มแอปบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้

Enum
PLATFORM_UNSPECIFIED ไม่ได้ระบุแพลตฟอร์ม
IOS แพลตฟอร์ม iOS
ANDROID แพลตฟอร์ม Android

เมธอด

bulkEditLineItemAssignedTargetingOptions

 ตัวเลือกการกำหนดเป้าหมายการแก้ไขแบบเป็นกลุ่มภายใต้รายการโฆษณาเดียว

bulkListLineItemAssignedTargetingOptions

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

create

 สร้างรายการโฆษณาใหม่

delete

 ลบรายการโฆษณา

generateDefault

 สร้างรายการโฆษณาใหม่ที่มีการตั้งค่า (รวมถึงการกำหนดเป้าหมาย) ที่รับช่วงมาจากใบสั่งซื้อการใส่โฆษณาและ ENTITY_STATUS_DRAFT entity_status

get

 รับรายการโฆษณา

list

 แสดงรายการโฆษณาในส่วนผู้ลงโฆษณา

patch

 อัปเดตรายการโฆษณาที่มีอยู่