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)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
ช่อง
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)

ไม่บังคับ ต้องระบุหากประเภทรายการโฆษณาไม่ใช่ LINE_ITEM_TYPE_DEMAND_GEN การตั้งค่าความถี่สูงสุดของการแสดงผลของรายการโฆษณา

ต้องใช้ฟิลด์ 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 และพาร์ทเนอร์
demandGenSettings

object (DemandGenSettings)

ไม่บังคับ การตั้งค่าเฉพาะสำหรับรายการโฆษณา Demand Gen

ใช้ได้กับรายการโฆษณา Demand Gen เท่านั้น
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

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

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

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

boolean

ไม่บังคับ เลือกว่าจะเปิดใช้การเพิ่มประสิทธิภาพราคาเสนอของ DV360 สำหรับรายการโฆษณาที่มีราคาเสนอคงที่หรือไม่

โดยค่าเริ่มต้น DV360 จะเพิ่มประสิทธิภาพราคาเสนอคงที่ด้วยการลดราคาเสนอโดยอัตโนมัติสำหรับการแสดงผลที่มีแนวโน้มที่จะทำงานได้ไม่ดี การเพิ่มประสิทธิภาพนี้จะเปิดใช้อยู่โดยค่าเริ่มต้น (ค่าเป็นจริง)

เมื่อตั้งค่าฟิลด์นี้เป็น false ระบบจะปิดใช้การเพิ่มประสิทธิภาพนี้ และจะไม่ลดราคาเสนอไม่ว่าด้วยเหตุผลใดก็ตาม

การตั้งค่านี้จะมีผลกับรายการโฆษณาที่มี biddingStrategy ประเภท FIXED_BID เท่านั้น

LineItemType

ประเภทที่เป็นไปได้ของรายการโฆษณา

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

Enum
LINE_ITEM_TYPE_UNSPECIFIED

ไม่ได้ระบุค่าประเภทหรือค่าประเภทไม่รู้จักในเวอร์ชันนี้

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกำหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_DISPLAY_DEFAULT โฆษณาแบบรูปภาพ, HTML5, เนทีฟ หรือริชมีเดีย
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL แสดงโฆษณา Display ที่เพิ่มการติดตั้งแอป
LINE_ITEM_TYPE_VIDEO_DEFAULT โฆษณาวิดีโอที่ขายตามเกณฑ์ CPM สำหรับสภาพแวดล้อมต่างๆ
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL โฆษณาวิดีโอที่กระตุ้นการติดตั้งแอป
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

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

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

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

คุณไม่สามารถสร้างหรืออัปเดตรายการโฆษณาประเภทนี้และการกำหนดเป้าหมายโดยใช้ API
LINE_ITEM_TYPE_AUDIO_DEFAULT โฆษณาเสียง RTB ที่ขายสำหรับสภาพแวดล้อมต่างๆ
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP โฆษณา Over-the-Top ที่อยู่ในใบสั่งซื้อการแทรกโฆษณา OTT ประเภทนี้ใช้ได้กับรายการโฆษณาที่มีใบสั่งซื้อการใส่โฆษณาเป็น insertionOrderType OVER_THE_TOP เท่านั้น
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

โฆษณาวิดีโอบน YouTube ที่กระตุ้น Conversion

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

โฆษณาวิดีโอบน YouTube (ยาวไม่เกิน 15 วินาที) ที่ข้ามไม่ได้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

โฆษณา Demand Gen

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

ต้องตั้งค่าช่องนี้เป็น LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED สำหรับรายการโฆษณา Demand Gen
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)

ต้องระบุ ประเภทมาร์กอัปของรูปแบบรายได้ของพาร์ทเนอร์

ต้องตั้งค่าช่องนี้เป็น PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP สำหรับรายการโฆษณา Demand Gen
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)
    }
  ],
  "primaryAttributionModelId": string
}
ช่อง
postViewCountPercentageMillis

string (int64 format)

เปอร์เซ็นต์ของ Conversion ที่เกิดหลังดูโฆษณาที่จะนับเป็นมิลลิวินาที (1/1000 ของเปอร์เซ็นต์) ต้องอยู่ระหว่าง 0 ถึง 100000 เท่านั้น

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

object (TrackingFloodlightActivityConfig)

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

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

อัปเดตฟิลด์นี้ไม่ได้หากมีการกําหนดอัลกอริทึมการเสนอราคาที่กําหนดเองให้กับรายการโฆษณา หากคุณตั้งค่าฟิลด์นี้และกําหนดอัลกอริทึมการเสนอราคาที่กําหนดเองในคําขอเดียวกัน กิจกรรม Floodlight ต้องตรงกับกิจกรรมที่อัลกอริทึมการเสนอราคาที่กําหนดเองใช้
primaryAttributionModelId

string (int64 format)

ไม่บังคับ รูปแบบการระบุแหล่งที่มาที่จะใช้สําหรับการวัด Conversion รูปแบบการระบุแหล่งที่มานี้จะกำหนดวิธีการนับ Conversion คุณตั้งค่าโมเดลหลักสำหรับการกำหนดค่าหรือกลุ่ม Floodlight ได้ ดูรายละเอียดเพิ่มเติมได้ที่นี่

ใช้ได้กับรายการโฆษณา Demand Gen เท่านั้น

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)

ไม่บังคับ รหัสของบัญชี Merchant Center ที่ใช้เพื่อระบุฟีดสินค้า

บัญชี Merchant Center นี้ต้องลิงก์กับผู้ลงโฆษณาอยู่แล้ว
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
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

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

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

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_MACROMILL

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
THIRD_PARTY_VENDOR_ORIGIN ต้นทางของคุณเป็นเจ้าของเอกสารนั้น
THIRD_PARTY_VENDOR_GEMIUS Gemius
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp
THIRD_PARTY_VENDOR_ISPOT_TV iSpot TV
THIRD_PARTY_VENDOR_INTAGE Intage
THIRD_PARTY_VENDOR_MACROMILL Macromill
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research

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 ได้หรือไม่

DemandGenSettings

การตั้งค่าสำหรับรายการโฆษณา Demand Gen

การแสดง JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
ฟิลด์
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

ไม่บังคับ การตั้งค่าการวัดผลโดยบุคคลที่สามสำหรับรายการโฆษณา Demand Gen
linkedMerchantId

string (int64 format)

ไม่บังคับ รหัสของบัญชี Merchant Center ที่ใช้เพื่อระบุฟีดสินค้า

บัญชี Merchant Center นี้ต้องลิงก์กับผู้ลงโฆษณาอยู่แล้ว
geoLanguageTargetingEnabled

boolean

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

เมธอด

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

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

delete

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

duplicate

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

get

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

list

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

patch

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