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

เลือกว่าจะยกเว้น Exchange ใหม่จากการกำหนดเป้าหมายโดยอัตโนมัติโดยรายการโฆษณาหรือไม่ ช่องนี้เป็นเท็จโดยค่าเริ่มต้น
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 หรือไฟล์ข้อมูลที่มีโครงสร้าง

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

boolean

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

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

เมื่อตั้งค่าช่องนี้เป็น 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

เช่น หากต้องการติดตาม 50% ของ Conversion จากการคลิก ให้ตั้งค่าเป็น 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

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

แอป 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,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "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 นี้ต้องลิงก์กับผู้ลงโฆษณาแล้ว
relatedVideos[]

object (RelatedVideo)

ไม่บังคับ วิดีโอที่เกี่ยวข้องสำหรับรายการโฆษณา วิดีโอเหล่านี้จะปรากฏใต้โฆษณาวิดีโอหลักเมื่อเล่นในแอป 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_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 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 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
THIRD_PARTY_VENDOR_AQUILA Aquila

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
  • TIME_UNIT_MONTHS
timeUnitCount

integer

จำนวน timeUnit ที่ความถี่เป้าหมายที่ต้องการจะคงอยู่

ข้อจำกัดต่อไปนี้จะมีผลตามค่าของ timeUnit

  • TIME_UNIT_WEEKS - ต้องเป็น 1
  • TIME_UNIT_MONTHS - ต้องเป็น 1

RelatedVideo

แสดงรายการวิดีโอที่เกี่ยวข้อง

การแสดง JSON 
{
  "videoId": string,
  "videoAssetId": string
}
ช่อง
videoId

string

เอาต์พุตเท่านั้น รหัสวิดีโอ YouTube ของวิดีโอที่เกี่ยวข้อง
videoAssetId

string (int64 format)

ต้องระบุ adAssetId ของแหล่งข้อมูล AdAsset สำหรับวิดีโอ YouTube

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

VideoAdInventoryControl

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

การแสดง JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
ฟิลด์
allowInStream

boolean

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

boolean

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

boolean

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

boolean

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

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

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