REST Resource: advertisers.lineItems

ทรัพยากร: รายการโฆษณา

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

การแสดง 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 โฆษณาแบบดิสเพลย์ที่ช่วยกระตุ้นการติดตั้งแอป
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 ไม่เช่นนั้นจะต้องตั้งค่าไม่ได้
  • เมื่อตั้งค่าแล้ว วันที่แสดงโฆษณาของรายการโฆษณาจะรับค่าจากใบสั่งซื้อการใส่โฆษณาระดับบนสุด
  • รายการโฆษณาที่ใช้งานอยู่จะใช้จ่ายเมื่อมีการเปิดใช้งานทริกเกอร์ที่เลือกภายในวันที่แสดงโฆษณาของใบสั่งซื้อการใส่โฆษณาระดับบนสุด

คำเตือน: รายการโฆษณาที่ใช้ทริกเกอร์ที่กำหนดเองจะไม่แสดงใน Display & Video 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

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

คำเตือน: รายการโฆษณาที่ใช้ทริกเกอร์ที่กำหนดเองจะไม่แสดงใน Display & Video 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

ตัวอย่างเช่น ในการติดตาม 50% ของ Conversion หลังการคลิก ให้กำหนดมูลค่าเป็น 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

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