- ทรัพยากร: รายการโฆษณา
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- LineItemWarningMessage
- MobileApp
- แพลตฟอร์ม
- YoutubeAndPartnersSettings
- YoutubeAndPartnersThirdPartyMeasurementSettings
- ThirdPartyVendorConfig
- ThirdPartyVendor
- YoutubeAndPartnersInventorySourceConfig
- YoutubeAndPartnersContentCategory
- TargetFrequency
- VideoAdSequenceSettings
- VideoAdSequenceMinimumDuration
- VideoAdSequenceStep
- InteractionType
- เมธอด
ทรัพยากร: รายการโฆษณา
รายการโฆษณาเดียว
การแสดง JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
ช่อง | |
---|---|
name |
เอาต์พุตเท่านั้น ชื่อทรัพยากรของรายการโฆษณา |
advertiserId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของผู้ลงโฆษณาที่เป็นเจ้าของรายการโฆษณา |
campaignId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของแคมเปญที่เป็นเจ้าของรายการโฆษณา |
insertionOrderId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสที่ไม่ซ้ำกันของใบสั่งซื้อการใส่โฆษณาที่มีรายการโฆษณานี้อยู่ |
lineItemId |
เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของรายการโฆษณา กำหนดโดยระบบ |
displayName |
ต้องระบุ ชื่อที่แสดงของรายการโฆษณา ต้องเป็นแบบ UTF-8 ที่เข้ารหัสด้วยขนาดสูงสุด 240 ไบต์ |
lineItemType |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ประเภทของรายการโฆษณา |
entityStatus |
ต้องระบุ ควบคุมว่ารายการโฆษณาสามารถใช้งบประมาณและเสนอราคาสำหรับพื้นที่โฆษณาได้หรือไม่
|
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาที่รายการโฆษณาได้รับการอัปเดตครั้งล่าสุด กำหนดโดยระบบ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
partnerCosts[] |
ค่าใช้จ่ายของพาร์ทเนอร์ที่เชื่อมโยงกับรายการโฆษณา หากไม่มีหรือว่างเปล่าในเมธอด |
flight |
ต้องระบุ เวลาเริ่มต้นและสิ้นสุดของเที่ยวบินของรายการโฆษณา |
budget |
ต้องระบุ การตั้งค่าการจัดสรรงบประมาณของรายการโฆษณา |
pacing |
ต้องระบุ การตั้งค่าความเร็วในการใช้จ่ายงบประมาณของรายการโฆษณา |
frequencyCap |
ต้องระบุ การตั้งค่าความถี่สูงสุดในการแสดงผลของรายการโฆษณา ต้องใช้ช่อง |
partnerRevenueModel |
ต้องระบุ การตั้งค่ารูปแบบรายได้ของพาร์ทเนอร์ของรายการโฆษณา |
conversionCounting |
การตั้งค่าเครื่องมือวัด Conversion ของรายการโฆษณา |
creativeIds[] |
รหัสของครีเอทีฟโฆษณาที่เชื่อมโยงกับรายการโฆษณา |
bidStrategy |
ต้องระบุ กลยุทธ์การเสนอราคาของรายการโฆษณา |
integrationDetails |
รายละเอียดการผสานรวมของรายการโฆษณา |
targetingExpansion |
การตั้งค่าการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพของรายการโฆษณา การกำหนดค่านี้ใช้ได้กับรายการโฆษณา Display วิดีโอ หรือเสียงที่ใช้การเสนอราคาอัตโนมัติและกำหนดเป้าหมายรายการกลุ่มเป้าหมายที่มีสิทธิ์ในเชิงบวกเท่านั้น |
warningMessages[] |
เอาต์พุตเท่านั้น ข้อความเตือนที่รายการโฆษณาสร้างขึ้น คำเตือนเหล่านี้ไม่ได้บล็อกการบันทึกรายการโฆษณา แต่บางรายการอาจบล็อกไม่ให้แสดงรายการโฆษณา |
mobileApp |
แอปบนอุปกรณ์เคลื่อนที่ที่โปรโมตโดยรายการโฆษณา ฟีเจอร์นี้ใช้ได้เฉพาะเมื่อ |
reservationType |
เอาต์พุตเท่านั้น ประเภทการจองของรายการโฆษณา |
excludeNewExchanges |
เลือกว่าจะยกเว้นการแลกเปลี่ยนใหม่ไม่ให้รายการโฆษณากำหนดเป้าหมายโดยอัตโนมัติไหม โดยค่าเริ่มต้น ช่องนี้จะเป็นเท็จ |
youtubeAndPartnersSettings |
เอาต์พุตเท่านั้น การตั้งค่าเฉพาะสำหรับรายการโฆษณาของ YouTube และพาร์ทเนอร์ |
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 ( |
ช่อง | |
---|---|
flightDateType |
ต้องระบุ ประเภทวันที่แสดงโฆษณาของรายการโฆษณา |
dateRange |
วันที่เริ่มต้นและวันที่สิ้นสุดของช่วงเวลาแสดงโฆษณาของรายการโฆษณา ซึ่งจะได้รับการแก้ไขตามเขตเวลาของผู้ลงโฆษณาหลัก
|
LineItemFlightDateType
ประเภทวันที่แสดงโฆษณาของรายการโฆษณาที่เป็นไปได้
Enum | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
ไม่ได้ระบุค่าประเภทหรือไม่รู้จักในเวอร์ชันนี้ |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
วันที่แสดงโฆษณาของรายการโฆษณาจะรับช่วงมาจากใบสั่งซื้อการใส่โฆษณาระดับบนสุด |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
รายการโฆษณาใช้วันที่แสดงโฆษณาที่กำหนดเอง |
LineItemBudget
การตั้งค่าที่ควบคุมวิธีการจัดสรรงบประมาณ
การแสดง JSON |
---|
{ "budgetAllocationType": enum ( |
ช่อง | |
---|---|
budgetAllocationType |
ต้องระบุ ประเภทของการจัดสรรงบประมาณ
|
budgetUnit |
เอาต์พุตเท่านั้น หน่วยงบประมาณจะระบุว่างบประมาณตามสกุลเงินหรือตามการแสดงผล ค่านี้จะได้รับมาจากใบสั่งซื้อการใส่โฆษณาระดับบนสุด |
maxAmount |
จำนวนงบประมาณสูงสุดที่รายการโฆษณาจะใช้ ต้องมากกว่า 0 เมื่อ
|
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 ( |
ช่อง | |
---|---|
markupType |
ต้องระบุ ประเภทมาร์กอัปของรูปแบบรายได้ของพาร์ทเนอร์ |
markupAmount |
ต้องระบุ จำนวนมาร์กอัปของรูปแบบรายได้ของพาร์ทเนอร์ ต้องมากกว่าหรือเท่ากับ 0
|
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 ( |
ช่อง | |
---|---|
postViewCountPercentageMillis |
เปอร์เซ็นต์ที่จะนับ Conversion หลังการดู หน่วยเป็นมิลลิวินาที (1/1000 ของเปอร์เซ็นต์) ต้องอยู่ระหว่าง 0 ถึง 100,000 ตัวอย่างเช่น ในการติดตาม 50% ของ Conversion หลังการคลิก ให้กำหนดค่า 50,000 |
floodlightActivityConfigs[] |
การกำหนดค่ากิจกรรม Floodlight ที่ใช้เพื่อติดตาม Conversion จำนวน Conversion ที่นับคือผลรวมของ Conversion ทั้งหมดที่นับตามรหัสกิจกรรม Floodlight ทั้งหมดที่ระบุในช่องนี้ |
TrackingFloodlightActivityConfig
การตั้งค่าที่ควบคุมลักษณะการทำงานของการกำหนดค่ากิจกรรม Floodlight รายการเดียว
การแสดง JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
ช่อง | |
---|---|
floodlightActivityId |
ต้องระบุ รหัสกิจกรรม Floodlight |
postClickLookbackWindowDays |
ต้องระบุ จำนวนวันหลังจากผู้ใช้คลิกโฆษณาที่สามารถนับ Conversion ได้ ต้องอยู่ระหว่าง 0 ถึง 90 |
postViewLookbackWindowDays |
ต้องระบุ จำนวนวันหลังจากที่มีการดูโฆษณาซึ่งอาจมีการนับ Conversion ต้องอยู่ระหว่าง 0 ถึง 90 |
LineItemWarningMessage
ข้อความเตือนที่สร้างโดยรายการโฆษณา คำเตือนประเภทนี้จะไม่บล็อกการบันทึกรายการโฆษณา แต่อาจบล็อกรายการโฆษณาไม่ให้ทำงาน
Enum | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
ไม่ได้ระบุหรือไม่รู้จัก |
INVALID_FLIGHT_DATES |
รายการโฆษณานี้มีวันที่ของช่วงเวลาแสดงโฆษณาที่ไม่ถูกต้อง รายการโฆษณาจะไม่ทำงาน |
EXPIRED |
วันที่สิ้นสุดของรายการโฆษณานี้เป็นวันที่ในอดีต |
PENDING_FLIGHT |
รายการโฆษณานี้จะเริ่มทำงานในอนาคต |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
การแลกเปลี่ยนที่เปิดใช้โดยพาร์ทเนอร์ทั้งหมดได้รับการกำหนดเป้าหมายเชิงลบ รายการโฆษณาจะไม่ทำงาน |
INVALID_INVENTORY_SOURCE |
ไม่ได้กำหนดเป้าหมายเป็นแหล่งที่มาของพื้นที่โฆษณาซึ่งใช้อยู่ รายการโฆษณาจะไม่ทำงาน |
APP_INVENTORY_INVALID_SITE_TARGETING |
การกำหนดเป้าหมายแอปและ URL ของรายการโฆษณานี้ไม่รวมแอปบนอุปกรณ์เคลื่อนที่ใดเลย รายการโฆษณาประเภทนี้กำหนดให้คุณรวมแอปบนอุปกรณ์เคลื่อนที่ไว้ในการกำหนดเป้าหมายแชแนล รายการเว็บไซต์ หรือแอป รายการโฆษณาจะไม่ทำงาน |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
รายการโฆษณานี้ไม่ได้กำหนดเป้าหมายผู้ใช้อุปกรณ์เคลื่อนที่รายใดเลย รายการโฆษณาประเภทนี้กำหนดให้คุณกำหนดเป้าหมายรายการผู้ใช้ด้วยผู้ใช้อุปกรณ์เคลื่อนที่ รายการโฆษณาจะไม่ทำงาน |
NO_VALID_CREATIVE |
รายการโฆษณานี้ไม่มีครีเอทีฟโฆษณาที่ถูกต้อง รายการโฆษณาจะไม่ทำงาน |
PARENT_INSERTION_ORDER_PAUSED |
ใบสั่งซื้อการใส่โฆษณาของรายการโฆษณานี้หยุดชั่วคราวอยู่ รายการโฆษณาจะไม่ทำงาน |
PARENT_INSERTION_ORDER_EXPIRED |
ใบสั่งซื้อการใส่โฆษณาของรายการโฆษณานี้มีวันที่สิ้นสุดเป็นวันที่ที่ผ่านมาแล้ว รายการโฆษณาจะไม่ทำงาน |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
รายการโฆษณานี้ใช้การตั้งค่า อัปเดตการผสานรวม API ให้ยกเว้นกลุ่มเป้าหมายบุคคลที่หนึ่งโดยตรงโดยใช้การกำหนดกลุ่มเป้าหมายก่อนวันที่ 25 มีนาคม 2023 เพื่อชดเชยการหยุดให้บริการช่อง |
MobileApp
แอปบนอุปกรณ์เคลื่อนที่ที่โปรโมตโดยรายการโฆษณาเพื่อการติดตั้งแอปบนอุปกรณ์เคลื่อนที่
การแสดง JSON |
---|
{
"appId": string,
"platform": enum ( |
ช่อง | |
---|---|
appId |
ต้องระบุ รหัสของแอปที่แพลตฟอร์มของร้านค้าระบุ แอป Android ระบุได้จากรหัสชุดที่ Play Store ของ Android ใช้ เช่น แอป iOS ระบุด้วยรหัสแอป 9 หลักที่ App Store ของ Apple ใช้ เช่น |
platform |
เอาต์พุตเท่านั้น แพลตฟอร์มของแอป |
displayName |
เอาต์พุตเท่านั้น ชื่อแอป |
publisher |
เอาต์พุตเท่านั้น ผู้เผยแพร่แอป |
แพลตฟอร์ม
แพลตฟอร์มที่เป็นไปได้สำหรับแอปบนอุปกรณ์เคลื่อนที่
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
ไม่ได้ระบุแพลตฟอร์ม |
IOS |
แพลตฟอร์ม iOS |
ANDROID |
แพลตฟอร์ม Android |
YoutubeAndPartnersSettings
การตั้งค่าสำหรับรายการโฆษณาของ YouTube และพาร์ทเนอร์
การแสดง JSON |
---|
{ "biddingStrategy": { object ( |
ช่อง | |
---|---|
biddingStrategy |
ต้องระบุ กลยุทธ์การเสนอราคาของรายการโฆษณา YouTube และพาร์ทเนอร์ |
viewFrequencyCap |
การตั้งค่าความถี่สูงสุดในการดูของรายการโฆษณา ต้องใช้ช่อง |
thirdPartyMeasurementSettings |
ไม่บังคับ การตั้งค่าการวัดผลโดยบุคคลที่สามของรายการโฆษณา |
inventorySourceSettings |
การตั้งค่าที่ควบคุมพื้นที่โฆษณาของ YouTube และพาร์ทเนอร์ที่รายการโฆษณาจะกำหนดเป้าหมาย |
contentCategory |
ประเภทเนื้อหาที่จะแสดงโฆษณาของ YouTube และพาร์ทเนอร์ |
effectiveContentCategory |
เอาต์พุตเท่านั้น หมวดหมู่เนื้อหาซึ่งจะมีผลเมื่อแสดงรายการโฆษณา เมื่อมีการกำหนดหมวดหมู่เนื้อหาในทั้งรายการโฆษณาและผู้ลงโฆษณา หมวดหมู่ที่เข้มงวดกว่าจะมีผลเมื่อแสดงรายการโฆษณา |
targetFrequency |
จำนวนครั้งโดยเฉลี่ยที่คุณต้องการให้โฆษณาจากรายการโฆษณานี้แสดงต่อผู้ใช้รายเดียวกันในช่วงระยะเวลาหนึ่ง |
linkedMerchantId |
รหัสของผู้ขายที่ลิงก์กับรายการโฆษณาสำหรับฟีดผลิตภัณฑ์ |
relatedVideoIds[] |
รหัสของวิดีโอจะปรากฏใต้โฆษณาวิดีโอหลักเมื่อโฆษณาเล่นในแอป YouTube บนอุปกรณ์เคลื่อนที่ |
leadFormId |
รหัสของแบบฟอร์มสำหรับสร้างโอกาสในการขาย |
videoAdSequenceSettings |
การตั้งค่าที่เกี่ยวข้องกับ VideoAdSequence |
YoutubeAndPartnersThirdPartyMeasurementSettings
การตั้งค่าที่ควบคุมสิ่งที่ผู้ให้บริการบุคคลที่สามจะวัดเมตริกรายการโฆษณาที่เฉพาะเจาะจง
การแสดง JSON |
---|
{ "viewabilityVendorConfigs": [ { object ( |
ช่อง | |
---|---|
viewabilityVendorConfigs[] |
ผู้ให้บริการบุคคลที่สามที่กำลังวัดการมองเห็นโฆษณา ผู้ให้บริการบุคคลที่สามมีดังต่อไปนี้
|
brandSafetyVendorConfigs[] |
ผู้ให้บริการบุคคลที่สามที่วัดความปลอดภัยของแบรนด์ ผู้ให้บริการบุคคลที่สามมีดังต่อไปนี้
|
reachVendorConfigs[] |
ผู้ให้บริการบุคคลที่สามที่วัดการเข้าถึง ผู้ให้บริการบุคคลที่สามมีดังต่อไปนี้
|
brandLiftVendorConfigs[] |
ผู้ให้บริการบุคคลที่สามที่วัดผล Brand Lift ผู้ให้บริการบุคคลที่สามมีดังต่อไปนี้
|
ThirdPartyVendorConfig
การตั้งค่าที่ควบคุมวิธีกําหนดค่าผู้ให้บริการวัดผลบุคคลที่สาม
การแสดง JSON |
---|
{
"vendor": enum ( |
ช่อง | |
---|---|
vendor |
ผู้ให้บริการวัดผลที่เป็นบุคคลที่สาม |
placementId |
รหัสที่แพลตฟอร์มของผู้ให้บริการบุคคลที่สามใช้เพื่อระบุรายการโฆษณา |
ThirdPartyVendor
ผู้ให้บริการที่วัดผลโดยบุคคลที่สาม
Enum | |
---|---|
THIRD_PARTY_VENDOR_UNSPECIFIED |
ผู้ให้บริการบุคคลที่สามที่ไม่รู้จัก |
THIRD_PARTY_VENDOR_MOAT |
Moat |
THIRD_PARTY_VENDOR_DOUBLE_VERIFY |
DoubleVerify |
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE |
Integral Ad Science |
THIRD_PARTY_VENDOR_COMSCORE |
Comscore |
THIRD_PARTY_VENDOR_TELEMETRY |
การตรวจวัดระยะไกล |
THIRD_PARTY_VENDOR_MEETRICS |
Meetrics |
THIRD_PARTY_VENDOR_ZEFR |
ZEFR |
THIRD_PARTY_VENDOR_NIELSEN |
Nielsen |
THIRD_PARTY_VENDOR_KANTAR |
Kantar |
THIRD_PARTY_VENDOR_DYNATA |
Dynata |
YoutubeAndPartnersInventorySourceConfig
การตั้งค่าที่ควบคุมพื้นที่โฆษณาที่เกี่ยวข้องกับ YouTube ที่รายการโฆษณา YouTube และพาร์ทเนอร์จะกำหนดเป้าหมาย
การแสดง JSON |
---|
{ "includeYoutubeSearch": boolean, "includeYoutubeVideos": boolean, "includeGoogleTv": boolean, "includeYoutubeVideoPartners": boolean } |
ช่อง | |
---|---|
includeYoutubeSearch |
จะกำหนดเป้าหมายพื้นที่โฆษณาในหน้าผลการค้นหาของ YouTube หรือไม่ |
includeYoutubeVideos |
จะกำหนดเป้าหมายพื้นที่โฆษณาของช่องและวิดีโอบน YouTube และวิดีโอ YouTube ที่ฝังในเว็บไซต์อื่นหรือไม่ |
includeGoogleTv |
ไม่บังคับ เลือกว่าจะกำหนดเป้าหมายพื้นที่โฆษณาในแอปวิดีโอที่พร้อมใช้งานกับ Google TV หรือไม่ |
includeYoutubeVideoPartners |
เลือกว่าจะกำหนดเป้าหมายพื้นที่โฆษณาในกลุ่มเว็บไซต์และแอปของพาร์ทเนอร์ที่เป็นไปตามมาตรฐานความปลอดภัยของแบรนด์เดียวกันกับ 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 ( |
ช่อง | |
---|---|
targetCount |
จำนวนครั้งโดยเฉลี่ยที่โฆษณาจะแสดงต่อผู้ใช้คนเดียวกันในช่วงเวลาที่ |
timeUnit |
หน่วยของเวลาที่จะนำความถี่เป้าหมายไปใช้ ใช้หน่วยเวลาต่อไปนี้ได้
|
timeUnitCount |
จำนวน จะมีข้อจำกัดต่อไปนี้ตามค่าของ
|
VideoAdSequenceSettings
การตั้งค่าที่เกี่ยวข้องกับ VideoAdSequence
การแสดง JSON |
---|
{ "minimumDuration": enum ( |
ช่อง | |
---|---|
minimumDuration |
ช่วงเวลาขั้นต่ำก่อนที่ผู้ใช้รายเดิมจะเห็นลำดับนี้อีกครั้ง |
steps[] |
ขั้นตอนของลำดับ |
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 ( |
ช่อง | |
---|---|
stepId |
รหัสของขั้นตอน |
adGroupId |
รหัสของกลุ่มโฆษณาที่เกี่ยวข้องของขั้นตอน |
previousStepId |
รหัสของขั้นตอนก่อนหน้า ขั้นตอนแรกจะไม่มีขั้นตอนก่อนหน้า |
interactionType |
การโต้ตอบในขั้นตอนก่อนหน้าที่จะนำผู้ชมมายังขั้นตอนนี้ ขั้นตอนแรกไม่มีInteractionType |
InteractionType
ประเภทของการโต้ตอบในขั้นตอนหนึ่งๆ
Enum | |
---|---|
INTERACTION_TYPE_UNSPECIFIED |
ไม่ระบุหรือไม่ทราบ |
INTERACTION_TYPE_PAID_VIEW |
การดูแบบชำระเงิน |
INTERACTION_TYPE_SKIP |
ผู้ชมข้าม |
INTERACTION_TYPE_IMPRESSION |
การแสดงโฆษณา (ดูแล้ว) |
INTERACTION_TYPE_ENGAGED_IMPRESSION |
การแสดงโฆษณาที่ผู้ชมไม่ได้ข้ามในทันที แต่ไปไม่ถึงเหตุการณ์ที่เรียกเก็บเงินได้ |
วิธีการ |
|
---|---|
|
แก้ไขตัวเลือกการกำหนดเป้าหมายแบบเป็นกลุ่มภายใต้รายการโฆษณาหลายรายการ |
|
รายการตัวเลือกการกำหนดเป้าหมายที่กำหนดสำหรับรายการโฆษณาหลายรายการในประเภทการกำหนดเป้าหมายต่างๆ |
|
อัปเดตรายการโฆษณาหลายรายการ |
|
สร้างรายการโฆษณาใหม่ |
|
ลบรายการโฆษณา |
|
ทำซ้ำรายการโฆษณา |
|
สร้างรายการโฆษณาใหม่ที่มีการตั้งค่า (รวมถึงการกำหนดเป้าหมาย) ที่รับช่วงมาจากใบสั่งซื้อการใส่โฆษณาและ ENTITY_STATUS_DRAFT entity_status |
|
รับรายการโฆษณา |
|
แสดงรายการโฆษณาในส่วนผู้ลงโฆษณา |
|
อัปเดตรายการโฆษณาที่มีอยู่ |