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)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
ช่อง
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)

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
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)

รายละเอียดการผสานรวมของรายการโฆษณา
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

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

object (YoutubeAndPartnersSettings)

เอาต์พุตเท่านั้น การตั้งค่าเฉพาะสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์

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

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

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ 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 เท่านั้น
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

โฆษณาวิดีโอ YouTube ที่เพิ่ม Conversion

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

โฆษณาวิดีโอ YouTube (สูงสุด 15 วินาที) ที่ข้ามไม่ได้

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

โฆษณาวิดีโอ YouTube ที่แสดงเรื่องราวตามลำดับที่เจาะจงโดยใช้รูปแบบต่างๆ ผสมผสานกัน

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

โฆษณาเสียงของ YouTube

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

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

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

โฆษณาวิดีโอ YouTube เริ่มต้น

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

โฆษณาวิดีโอ YouTube บนทีวีที่เชื่อมต่ออินเทอร์เน็ต (สูงสุด 15 วินาที) ที่ข้ามไม่ได้

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

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

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

โฆษณาวิดีโอ YouTube เริ่มต้นของทีวีที่เชื่อมต่ออินเทอร์เน็ต รวมเฉพาะรูปแบบโฆษณาในสตรีม

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

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

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

โฆษณาวิดีโอ YouTube ที่มุ่งเพิ่มยอดดูด้วยรูปแบบโฆษณาที่หลากหลาย

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

โฆษณา Display ที่แสดงในพื้นที่โฆษณานอกบ้านแบบดิจิทัล

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกําหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

โฆษณาวิดีโอที่แสดงในพื้นที่โฆษณาดิจิทัลนอกบ้าน

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

LineItemFlight

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

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

enum (LineItemFlightDateType)

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

object (DateRange)

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

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

LineItemFlightDateType

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

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

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/1, 000 ของเปอร์เซ็นต์) ต้องอยู่ระหว่าง 0 ถึง 100000 เท่านั้น

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

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 ใบสั่งซื้อการใส่โฆษณาของรายการโฆษณานี้มีวันที่สิ้นสุดเป็นวันที่ที่ผ่านมาแล้ว รายการโฆษณาจะไม่ทํางาน

MobileApp

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

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

string

ต้องระบุ รหัสของแอปที่ Store ของแพลตฟอร์มระบุ

แอป 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

YoutubeAndPartnersSettings

การตั้งค่าสำหรับรายการโฆษณา YouTube และพาร์ทเนอร์

การแสดง JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
ช่อง
viewFrequencyCap

object (FrequencyCap)

การตั้งค่าความถี่สูงสุดของการดูรายการโฆษณา

ต้องใช้ฟิลด์ maxViews ในออบเจ็กต์การตั้งค่านี้หากกําหนดขีดจํากัดที่จำกัด
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

ไม่บังคับ การกําหนดค่าการวัดผลโดยบุคคลที่สามของรายการโฆษณา
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

การตั้งค่าที่ควบคุมพื้นที่โฆษณาของ YouTube และพาร์ทเนอร์ที่รายการโฆษณาจะกําหนดเป้าหมาย
contentCategory

enum (YoutubeAndPartnersContentCategory)

ประเภทเนื้อหาที่โฆษณาของ YouTube และพาร์ทเนอร์จะแสดง
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

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

object (TargetFrequency)

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

string (int64 format)

ไม่บังคับ รหัสของผู้ขายที่ลิงก์กับรายการโฆษณาสำหรับฟีดผลิตภัณฑ์
relatedVideoIds[]

string

ไม่บังคับ รหัสของวิดีโอจะปรากฏใต้โฆษณาวิดีโอหลักเมื่อโฆษณาเล่นในแอป YouTube บนอุปกรณ์เคลื่อนที่
leadFormId

string (int64 format)

ไม่บังคับ รหัสของแบบฟอร์มเพื่อสร้างผู้มีโอกาสเป็นลูกค้า
videoAdSequenceSettings

object (VideoAdSequenceSettings)

ไม่บังคับ การตั้งค่าที่เกี่ยวข้องกับ VideoAdSequence

ThirdPartyMeasurementConfigs

การตั้งค่าที่ควบคุมว่าผู้ให้บริการบุคคลที่สามรายใดจะวัดเมตริกรายการโฆษณาที่เฉพาะเจาะจง

การแสดง JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
ช่อง
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

ไม่บังคับ ผู้ให้บริการบุคคลที่สามที่วัดการมองเห็นโฆษณา

ผู้ให้บริการบุคคลที่สามต่อไปนี้เกี่ยวข้อง

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

ไม่บังคับ ผู้ให้บริการบุคคลที่สามที่วัดความปลอดภัยของแบรนด์

ผู้ให้บริการบุคคลที่สามต่อไปนี้เกี่ยวข้อง

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

ไม่บังคับ ผู้ให้บริการบุคคลที่สามที่วัดการเข้าถึง

ผู้ให้บริการบุคคลที่สามต่อไปนี้เกี่ยวข้อง

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

ไม่บังคับ ผู้ให้บริการบุคคลที่สามที่วัด Brand Lift

ผู้ให้บริการบุคคลที่สามต่อไปนี้เกี่ยวข้อง

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

การตั้งค่าที่ควบคุมวิธีกําหนดค่าผู้ให้บริการวัดผลบุคคลที่สาม

การแสดง JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
ช่อง
vendor

enum (ThirdPartyVendor)

ผู้ให้บริการวัดผลบุคคลที่สาม
placementId

string

รหัสที่แพลตฟอร์มของผู้ให้บริการบุคคลที่สามใช้เพื่อระบุรายการโฆษณา

ThirdPartyVendor

ผู้ให้บริการที่ทําการวัดผลโดยบุคคลที่สาม

Enum
THIRD_PARTY_VENDOR_UNSPECIFIED ผู้ให้บริการบุคคลที่สามที่ไม่รู้จัก
THIRD_PARTY_VENDOR_MOAT Moat
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science
THIRD_PARTY_VENDOR_COMSCORE Comscore
THIRD_PARTY_VENDOR_TELEMETRY ข้อมูลที่ได้รับจากทางไกล
THIRD_PARTY_VENDOR_MEETRICS Meetrics
THIRD_PARTY_VENDOR_ZEFR ZEFR
THIRD_PARTY_VENDOR_NIELSEN Nielsen
THIRD_PARTY_VENDOR_KANTAR Kantar
THIRD_PARTY_VENDOR_DYNATA Dynata

YoutubeAndPartnersInventorySourceConfig

การตั้งค่าที่ควบคุมพื้นที่โฆษณาที่เกี่ยวข้องกับ YouTube ที่รายการโฆษณา YouTube และพาร์ทเนอร์จะกําหนดเป้าหมาย

การแสดง JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
ช่อง
includeYoutube

boolean

ไม่บังคับ กำหนดเป้าหมายพื้นที่โฆษณาบน YouTube หรือไม่ ซึ่งรวมถึงการค้นหา ช่อง และวิดีโอ
includeGoogleTv

boolean

ไม่บังคับ กำหนดเป้าหมายพื้นที่โฆษณาในแอปวิดีโอที่พร้อมใช้งานกับ Google TV หรือไม่
includeYoutubeVideoPartners

boolean

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

YoutubeAndPartnersContentCategory

หมวดหมู่ความปลอดภัยของแบรนด์สำหรับเนื้อหาของ YouTube และพาร์ทเนอร์

Enum
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED ไม่ได้ระบุหมวดหมู่เนื้อหาหรือไม่ทราบหมวดหมู่เนื้อหาในเวอร์ชันนี้
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD หมวดหมู่ที่ประกอบด้วยเนื้อหาที่หลากหลายซึ่งเหมาะกับแบรนด์ส่วนใหญ่ เนื้อหานี้อิงตามหลักเกณฑ์สำหรับเนื้อหาที่เป็นมิตรกับผู้ลงโฆษณาของ YouTube
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED หมวดหมู่ที่มีเนื้อหาทั้งหมดใน YouTube และพาร์ทเนอร์วิดีโอที่เป็นไปตามมาตรฐานการสร้างรายได้
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED หมวดหมู่ที่มีเนื้อหาจํานวนลดลงซึ่งเป็นไปตามข้อกําหนดที่เพิ่มขึ้น โดยเฉพาะในเรื่องภาษาที่ไม่เหมาะสมและการชี้นําทางเพศ

TargetFrequency

การตั้งค่าที่ควบคุมจํานวนครั้งโดยเฉลี่ยที่โฆษณาจะแสดงต่อผู้ใช้คนเดียวกันในระยะเวลาที่กําหนด

การแสดง JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
ช่อง
targetCount

string (int64 format)

จํานวนครั้งที่โฆษณาจะแสดงต่อผู้ใช้คนเดียวกันโดยเฉลี่ยในระยะเวลาที่ระบุโดย timeUnit และ timeUnitCount
timeUnit

enum (TimeUnit)

หน่วยเวลาที่จะใช้ความถี่เป้าหมาย

หน่วยเวลาที่ใช้ได้มีดังนี้

  • TIME_UNIT_WEEKS
timeUnitCount

integer

จํานวน timeUnit ของความถี่เป้าหมายที่ต้องการ

ข้อจํากัดต่อไปนี้มีผลกับค่าของ timeUnit

  • TIME_UNIT_WEEKS - ต้องเท่ากับ 1

VideoAdSequenceSettings

การตั้งค่าที่เกี่ยวข้องกับ VideoAdSequence

การแสดง JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
ช่อง
minimumDuration

enum (VideoAdSequenceMinimumDuration)

ช่วงเวลาขั้นต่ำก่อนที่ผู้ใช้รายเดียวกันจะเห็นลําดับนี้อีกครั้ง
steps[]

object (VideoAdSequenceStep)

ขั้นตอนของลําดับ

VideoAdSequenceMinimumDuration

อาร์เรย์แบบจำกัดสำหรับช่วงเวลาขั้นต่ำที่เป็นไปได้ก่อนที่ผู้ใช้รายเดิมจะเห็น VideoAdSequence อีกครั้ง

Enum
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED ไม่ระบุหรือไม่รู้จัก
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 วัน
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 วัน

VideoAdSequenceStep

รายละเอียดของขั้นตอนเดียวใน VideoAdSequence

การแสดง JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
ช่อง
stepId

string (int64 format)

รหัสของขั้นตอน
adGroupId

string (int64 format)

รหัสของกลุ่มโฆษณาที่เกี่ยวข้องของขั้นตอน
previousStepId

string (int64 format)

รหัสของขั้นตอนก่อนหน้า ขั้นตอนแรกไม่มีขั้นตอนก่อนหน้า
interactionType

enum (InteractionType)

การโต้ตอบในขั้นตอนก่อนหน้าที่จะนําผู้ชมไปยังขั้นตอนนี้ ขั้นตอนแรกไม่มี interactionType

InteractionType

ประเภทของการโต้ตอบในขั้นตอน

Enum
INTERACTION_TYPE_UNSPECIFIED ไม่ได้ระบุหรือไม่รู้จัก
INTERACTION_TYPE_PAID_VIEW การดูวิดีโอจากสปอนเซอร์
INTERACTION_TYPE_SKIP ผู้ชมข้าม
INTERACTION_TYPE_IMPRESSION การแสดงโฆษณา (ที่ดู)
INTERACTION_TYPE_ENGAGED_IMPRESSION การแสดงโฆษณาที่ผู้ชมไม่ได้ข้ามทันที แต่ก็ไม่ได้ไปถึงเหตุการณ์ที่เรียกเก็บเงินได้

เมธอด

bulkEditAssignedTargetingOptions

 แก้ไขตัวเลือกการกําหนดเป้าหมายหลายรายการพร้อมกันในรายการโฆษณาหลายรายการ

bulkListAssignedTargetingOptions

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

bulkUpdate

 อัปเดตรายการโฆษณาหลายรายการ

create

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

delete

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

duplicate

 ทำรายการโฆษณาซ้ำ

generateDefault

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

get

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

list

 แสดงรายการโฆษณาของผู้ลงโฆษณา

patch

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