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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
ช่อง
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 เสมอ และใช้ตัวเลขเศษส่วน 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 และพาร์ทเนอร์
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

ไม่ว่ารายการโฆษณานี้จะแสดงโฆษณาทางการเมืองในสหภาพยุโรปหรือไม่

หากตั้งค่า containsEuPoliticalAds เป็น DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING ในผู้ลงโฆษณาหลัก ระบบจะกำหนดค่า DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING ให้ช่องนี้หากไม่ได้ระบุไว้เป็นอย่างอื่น จากนั้นจะอัปเดตฟิลด์นี้ได้โดยใช้ UI, API หรือไฟล์ Structured Data

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 ขึ้นไป โดยทั้ง 2 รายการต้องอยู่ก่อนปี 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 ถึง 100000 เท่านั้น

เช่น หากต้องการติดตาม Conversion หลังคลิก 50% ให้ตั้งค่าเป็น 50000
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

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

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

อัปเดตฟิลด์นี้ไม่ได้หากมีการกําหนดอัลกอริทึมการเสนอราคาที่กําหนดเองให้กับรายการโฆษณา หากคุณตั้งค่าฟิลด์นี้และกําหนดอัลกอริทึมการเสนอราคาที่กําหนดเองในคําขอเดียวกัน กิจกรรม 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)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
ช่อง
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
videoAdInventoryControl

object (VideoAdInventoryControl)

ไม่บังคับ การตั้งค่าเพื่อควบคุมพื้นที่โฆษณาที่อนุญาตสำหรับรายการโฆษณานี้

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_ZEFR
  • 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
  • THIRD_PARTY_VENDOR_NIELSEN

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
THIRD_PARTY_VENDOR_TRANSUNION Transunion

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 การแสดงโฆษณาที่ผู้ชมไม่ได้ข้ามทันที แต่ก็ไม่ได้ทำให้เกิดเหตุการณ์ที่เรียกเก็บเงินได้เช่นกัน

VideoAdInventoryControl

การควบคุมพื้นที่โฆษณาวิดีโอที่ใช้ในรายการโฆษณา YouTube บางประเภท

การแสดง JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
ช่อง
allowInStream

boolean

ไม่บังคับ โฆษณาสามารถแสดงเป็นรูปแบบในสตรีมได้หรือไม่
allowInFeed

boolean

ไม่บังคับ โฆษณาสามารถแสดงเป็นรูปแบบในฟีดได้หรือไม่
allowShorts

boolean

ไม่บังคับ โฆษณาสามารถแสดงเป็นรูปแบบ Shorts ได้หรือไม่

เมธอด

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

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

duplicate

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

generateDefault

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

get

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

list

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

patch

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