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)
  },
  "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)

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

การประทับเวลาจะอยู่ในรูปแบบ 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)

รายละเอียดการผสานรวมของรายการโฆษณา
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 โฆษณาแบบดิสเพลย์ที่เพิ่มจำนวนการติดตั้งแอป
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/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

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

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

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

enum สำหรับช่วงเวลาต่ำสุดที่เป็นไปได้ ก่อนที่ผู้ใช้รายเดิมจะเห็น 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

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