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)

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

การประทับเวลาเป็น 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 โฆษณา 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 เท่านั้น
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

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

สร้างหรืออัปเดตรายการโฆษณาประเภทนี้โดยใช้ 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

ตัวอย่างเช่น หากต้องการติดตาม 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

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

YoutubeAndPartnersSettings

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

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

object (YoutubeAndPartnersBiddingStrategy)

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

object (FrequencyCap)

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

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

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

ไม่บังคับ การตั้งค่าการวัดผลโดยบุคคลที่สามของรายการโฆษณา
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

YoutubeAndPartnersThirdPartyMeasurementSettings

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

การแสดง 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 
{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
ช่อง
includeYoutubeVideos

boolean

เลือกว่าจะกำหนดเป้าหมายพื้นที่โฆษณาของช่องและวิดีโอบน YouTube และวิดีโอ 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

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