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

ต้องกำหนดฟิลด์นี้เมื่อสร้างรายการโฆษณาใหม่ ไม่เช่นนั้น คำขอ advertisers.lineItems.create จะไม่สำเร็จ

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

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