- Resource: CuratedPackage
- สถานะ
- AccessControlSettings
- PackageTargeting
- DeviceType
- สภาพแวดล้อม
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- ประเภท
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- เมธอด
ทรัพยากร: CuratedPackage
แสดงแพ็กเกจพื้นที่โฆษณาที่มีการดูแลจัดการซึ่งสร้างและจัดการโดยผู้ดูแลจัดการ
| การแสดง JSON |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| ช่อง | |
|---|---|
name |
ตัวระบุ ชื่อทรัพยากรที่ไม่ซ้ำกันสำหรับแพ็กเกจที่ดูแลจัดการ รูปแบบ: |
displayName |
ต้องระบุ ชื่อที่แสดงซึ่งผู้ดูแลจัดการกำหนดให้กับแพ็กเกจที่ดูแลจัดการ ใช้เพื่อกรองการตอบกลับของเมธอด |
description |
ไม่บังคับ คำอธิบายแพ็กเกจที่มีการดูแลจัดการซึ่งระบุโดยผู้ดูแลจัดการ |
createTime |
เอาต์พุตเท่านั้น การประทับเวลาที่สร้างแพ็กเกจที่มีการดูแลจัดการ ใช้เพื่อกรองการตอบกลับของเมธอด ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
updateTime |
เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตแพ็กเกจที่ดูแลจัดการครั้งล่าสุด ใช้เพื่อกรองการตอบกลับของเมธอด ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
floorPriceCpm |
ไม่บังคับ CPM ขั้นต่ำที่ผู้ซื้อต้องเสนอราคาเพื่อเข้าร่วมการประมูลพื้นที่โฆษณาในแพ็กเกจที่ดูแลจัดการนี้ ใช้เพื่อกรองการตอบกลับของเมธอด |
state |
เอาต์พุตเท่านั้น สถานะของแพ็กเกจที่ดูแลจัดการ ใช้เพื่อกรองการตอบกลับของเมธอด |
accessSettings |
ต้องระบุ การตั้งค่าสำหรับควบคุมการเข้าถึงแพ็กเกจที่ดูแลจัดการ สิทธิ์เข้าถึงแพ็กเกจที่ดูแลจัดการนี้จำกัดไว้สำหรับเจ้าหน้าที่วางแผนโฆษณาและครีเอเตอร์ที่อยู่ในรายการที่อนุญาตเท่านั้น ผู้ซื้อและผู้เสนอราคาไม่สามารถอยู่ในรายการที่อนุญาตหรือมีสิทธิ์เข้าถึงแหล่งข้อมูลนี้โดยตรง |
targeting |
ไม่บังคับ เกณฑ์การกำหนดเป้าหมายสำหรับแพ็กเกจที่ดูแลจัดการ |
curationFeeVisibility |
ไม่บังคับ เปลี่ยนแปลงไม่ได้ การแสดงค่าธรรมเนียมแพ็กเกจการดูแลจัดการและค่าธรรมเนียมกลุ่มเป้าหมายตามข้อมูลรวมกัน (ค่าธรรมเนียมการดูแลจัดการทั้งหมด) |
| ค่าธรรมเนียมที่จ่ายให้กับผู้ดูแลจัดการสำหรับแพ็กเกจนี้ ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
feeCpm |
ไม่บังคับ ค่าธรรมเนียม CPM ที่ผู้ดูแลจัดการเรียกเก็บจากผู้ซื้อที่ใช้แพ็กเกจที่ดูแลจัดการนี้ ใช้เพื่อกรองการตอบกลับของเมธอด |
millipercentOfMediaFee |
ไม่บังคับ ระบบจะเรียกเก็บค่าธรรมเนียมเป็นเปอร์เซ็นต์ของต้นทุนการแสดงผล ซึ่งแสดงเป็นหน่วยมิลลิเปอร์เซ็นต์ เช่น 1% จะแสดงเป็น 1000 |
| สิ้นสุดฟิลด์ที่แยกกัน | |
รัฐ
สถานะของแพ็กเกจที่ดูแลจัดการ
| Enum | |
|---|---|
STATE_UNSPECIFIED |
ค่าเริ่มต้น |
ACTIVE |
แพ็กเกจที่ดูแลจัดการทำงานอยู่ |
INACTIVE |
แพ็กเกจที่ดูแลจัดการไม่มีการใช้งาน |
AccessControlSettings
การตั้งค่าสำหรับควบคุมการเข้าถึงแพ็กเกจที่ดูแลจัดการ
| การแสดง JSON |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| ช่อง | |
|---|---|
allowlistedMediaPlanners[] |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รายชื่อเจ้าหน้าที่วางแผนโฆษณาที่ได้รับสิทธิ์เข้าถึงแพ็กเกจที่คัดสรรอย่างชัดเจน คุณดูเจ้าหน้าที่วางแผนโฆษณาที่มีสิทธิ์ได้ในเมธอด รูปแบบ: |
PackageTargeting
เกณฑ์การกำหนดเป้าหมายสำหรับแพ็กเกจที่ดูแลจัดการและแพ็กเกจการประมูล
| การแสดง JSON |
|---|
{ "includedDeviceTypes": [ enum ( |
| ฟิลด์ | |
|---|---|
includedDeviceTypes[] |
ไม่บังคับ รายการประเภทอุปกรณ์ที่รวมไว้เพื่อกำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายอุปกรณ์ทุกประเภท |
includedEnvironment |
ไม่บังคับ สภาพแวดล้อมที่จะกำหนดเป้าหมาย หากไม่ระบุ ระบบจะกำหนดเป้าหมายไปยังสภาพแวดล้อมทั้งหมด |
includedCreativeFormat |
ไม่บังคับ รูปแบบครีเอทีฟโฆษณาที่จะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายมาร์กอัปครีเอทีฟโฆษณาทุกประเภท |
includedAcceleratedMobilePageType |
ไม่บังคับ ประเภท Accelerated Mobile Pages ที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงสถานะ AMP |
includedAuthorizedSellerStatuses[] |
ไม่บังคับ รายการสถานะผู้ขายที่ได้รับอนุญาตที่กำหนดเป้าหมายซึ่งรวมอยู่ หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงสถานะของผู้ขาย |
includedNativeInventoryTypes[] |
ไม่บังคับ ประเภทพื้นที่โฆษณาเนทีฟที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทพื้นที่โฆษณาเนทีฟ |
includedOpenMeasurementTypes[] |
ไม่บังคับ รายการประเภทการวัดผลแบบเปิดที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงการรองรับ Open Measurement |
includedRestrictedCategories[] |
ไม่บังคับ รายการหมวดหมู่ที่จำกัดที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงหมวดหมู่ที่จำกัด |
includedRewardedType |
ไม่บังคับ ประเภทรางวัลที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทที่มีการให้รางวัล |
videoTargeting |
ไม่บังคับ เกณฑ์การกำหนดเป้าหมายเฉพาะวิดีโอ |
minimumPredictedViewabilityPercentage |
ไม่บังคับ เปอร์เซ็นต์การมองเห็นโฆษณาขั้นต่ำที่คาดการณ์ไว้ซึ่งกำหนดเป้าหมาย ค่านี้ต้องเป็นจำนวนที่หารด้วย 10 ลงตัวซึ่งอยู่ระหว่าง 10 ถึง 90 (รวม) เช่น 10 ใช้ได้ แต่ 0, 15 และ 100 ใช้ไม่ได้ ค่า 10 หมายความว่าการกำหนดค่าจะจับคู่กับช่องโฆษณาที่เราคาดการณ์ว่ามีการมองเห็นโฆษณาอย่างน้อย 10% เท่านั้น ค่าที่ไม่ได้ตั้งค่าไว้บ่งบอกว่าระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงการมองเห็นโฆษณาที่คาดการณ์ไว้ |
languageTargeting |
ไม่บังคับ ภาษาที่จะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงภาษา ดูรายการรหัสภาษาที่รองรับได้ที่ https://developers.google.com/google-ads/api/data/codes-formats#languages |
includedAdSizes[] |
ไม่บังคับ รายการขนาดโฆษณาที่จะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงขนาดโฆษณา แพ็กเกจที่ดูแลจัดการรองรับขนาดโฆษณา |
publisherTargeting |
ไม่บังคับ ผู้เผยแพร่โฆษณาที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงผู้เผยแพร่โฆษณา ระบบจะระบุผู้เผยแพร่โฆษณาด้วยรหัสผู้เผยแพร่โฆษณาจาก ads.txt / app-ads.txt ดูรายละเอียดเพิ่มเติมได้ที่ https://iabtechlab.com/ads-txt/ และ https://iabtechlab.com/app-ads-txt/ |
minimumPredictedClickThroughRatePercentageMillis |
ไม่บังคับ อัตราการคลิกผ่านขั้นต่ำที่คาดการณ์ไว้ซึ่งเป็นเป้าหมาย โดยมีค่าอยู่ในช่วง [10, 10000] (0.01% - 10%) ค่า 50 หมายความว่าการกำหนดค่าจะจับคู่กับช่องโฆษณาที่เราคาดการณ์ว่ามีอัตราการคลิกผ่านอย่างน้อย 0.05% เท่านั้น ค่าที่ไม่ได้ตั้งค่าไว้จะระบุว่าระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงอัตราการคลิกผ่านที่คาดการณ์ไว้ |
verticalTargeting |
ไม่บังคับ ประเภทธุรกิจที่รวมหรือยกเว้นตามที่ระบุไว้ใน https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทธุรกิจ |
geoTargeting |
ไม่บังคับ รหัสเกณฑ์ทางภูมิศาสตร์ที่จะรวมหรือยกเว้นตามที่ระบุไว้ใน https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงภูมิศาสตร์ |
includedDataSegments[] |
ไม่บังคับ กลุ่มเป้าหมายตามข้อมูลที่ใช้งานอยู่ซึ่งจะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงกลุ่มข้อมูล รูปแบบ: |
placementTargeting |
ไม่บังคับ ข้อมูลการกำหนดเป้าหมายจากตำแหน่ง เช่น URL, แอปพลิเคชันบนอุปกรณ์เคลื่อนที่ |
publisherProvidedSignalsTargeting |
ไม่บังคับ สัญญาณที่ได้จากผู้เผยแพร่โฆษณาเพื่อกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงสัญญาณที่ได้จากผู้เผยแพร่โฆษณา |
DeviceType
ประเภททั่วไปของอุปกรณ์ที่จะกำหนดเป้าหมาย
| Enum | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
DEVICE_TYPE_PERSONAL_COMPUTER |
กำหนดเป้าหมายเป็นคอมพิวเตอร์เดสก์ท็อปหรือแล็ปท็อป |
DEVICE_TYPE_CONNECTED_TV |
กำหนดเป้าหมายเป็นทีวีที่เชื่อมต่ออินเทอร์เน็ต ซึ่งก็คืออุปกรณ์ที่สตรีมเนื้อหาทีวี รวมถึงสมาร์ททีวี คอนโซลเกม และกล่องรับสัญญาณสำหรับสตรีม/สติ๊กสำหรับสตรีม |
DEVICE_TYPE_PHONE |
กำหนดเป้าหมายเป็นมือถือระดับไฮเอนด์ |
DEVICE_TYPE_TABLET |
กำหนดเป้าหมายเป็นอุปกรณ์แท็บเล็ต |
สภาพแวดล้อม
สภาพแวดล้อมที่จะกำหนดเป้าหมาย
| Enum | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
ENVIRONMENT_SITE |
กำหนดเป้าหมายพื้นที่โฆษณาที่แสดงผลภายในเว็บไซต์ที่มีโฆษณาสนับสนุน |
ENVIRONMENT_APP |
กำหนดเป้าหมายพื้นที่โฆษณาภายในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ |
CreativeFormat
รูปแบบครีเอทีฟโฆษณาที่กำหนดเป้าหมายได้
| Enum | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
CREATIVE_FORMAT_DISPLAY |
กำหนดเป้าหมายช่องโฆษณาที่มีไว้สำหรับครีเอทีฟโฆษณา Display แบบ HTML |
CREATIVE_FORMAT_VIDEO |
กำหนดเป้าหมายช่องโฆษณาที่ต้องการใช้กับครีเอทีฟโฆษณาวิดีโอ |
CREATIVE_FORMAT_AUDIO |
กำหนดเป้าหมายช่องโฆษณาที่มีไว้สำหรับครีเอทีฟโฆษณาเสียง |
AcceleratedMobilePageType
ประเภทของการติดตั้งใช้งาน Accelerated Mobile Page (AMP) ที่จะกำหนดเป้าหมาย
| Enum | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
กำหนดเป้าหมายพื้นที่โฆษณาในหน้าเว็บมาตรฐานที่ไม่ได้ใช้เฟรมเวิร์ก AMP |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
กำหนดเป้าหมายพื้นที่โฆษณาในหน้าเว็บที่สร้างขึ้นโดยใช้เฟรมเวิร์ก AMP HTML หลัก |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
กำหนดเป้าหมายพื้นที่โฆษณาในหน้าเว็บที่ใช้รูปแบบเรื่องราว AMP (STAMP) ซึ่งได้รับการเพิ่มประสิทธิภาพสำหรับการเล่าเรื่องผ่านภาพ (เช่น ประสบการณ์การใช้งานแบบเต็มหน้าจอที่แตะได้) |
AuthorizedSellerStatus
แสดงความสัมพันธ์ระหว่างผู้เผยแพร่โฆษณากับผู้ขายตามที่ประกาศไว้ในไฟล์ ads.txt หรือ app-ads.txt
| Enum | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
AUTHORIZED_SELLER_STATUS_DIRECT |
กำหนดเป้าหมายพื้นที่โฆษณาที่มีการประกาศผู้ขายเป็น "DIRECT" ซึ่งบ่งชี้ว่าผู้เผยแพร่โฆษณา (เจ้าของเนื้อหา) ควบคุมบัญชีผู้ขายโดยตรงและมีสัญญาทางธุรกิจโดยตรงกับระบบโฆษณาสำหรับบัญชีนี้ |
AUTHORIZED_SELLER_STATUS_RESELLER |
กำหนดเป้าหมายพื้นที่โฆษณาที่มีการประกาศผู้ขายเป็น "RESELLER" ค่านี้บ่งชี้ว่าผู้เผยแพร่โฆษณาได้ให้สิทธิ์เอนทิตีอื่นในการดำเนินการกับบัญชีผู้ขายที่ระบุไว้และขายต่อพื้นที่โฆษณาของตนเอง |
NativeInventoryType
แสดงประเภทการแสดงผลครีเอทีฟโฆษณาที่ช่องโฆษณารองรับ โดยเฉพาะอย่างยิ่งในส่วนที่เกี่ยวข้องกับโฆษณาเนทีฟ
| Enum | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
กำหนดเป้าหมายช่องโฆษณาที่ยอมรับและแสดงผลโฆษณาเนทีฟเท่านั้น |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
กำหนดเป้าหมายช่องโฆษณาที่ยอมรับและแสดงผลโฆษณาเนทีฟหรือโฆษณาแบนเนอร์ |
OpenMeasurementType
ประเภทของ Open Measurement Interface Definition (OMID) ที่จะกำหนดเป้าหมาย
| Enum | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
กำหนดเป้าหมายพื้นที่โฆษณาที่รองรับ Open Measurement Interface Definition (OMID) เวอร์ชัน 1 |
RestrictedCategory
แสดงหมวดหมู่โฆษณาที่เฉพาะเจาะจงซึ่งถูกจำกัดโดยนโยบายการกำหนดเป้าหมาย
| Enum | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
RESTRICTED_CATEGORY_ALCOHOL |
กำหนดเป้าหมายพื้นที่โฆษณาที่ผู้เผยแพร่โฆษณาอนุญาตให้แสดงโฆษณาเครื่องดื่มแอลกอฮอล์ |
RESTRICTED_CATEGORY_GAMBLING |
กำหนดเป้าหมายพื้นที่โฆษณาที่ผู้เผยแพร่โฆษณาอนุญาตให้แสดงโฆษณาเกี่ยวกับการพนัน |
RewardedType
กำหนดเกณฑ์การกำหนดเป้าหมายโดยอิงตามว่าพื้นที่โฆษณาให้รางวัลแก่ผู้ใช้สำหรับการดูโฆษณาหรือไม่
| Enum | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
REWARDED_TYPE_NON_REWARDED |
กำหนดเป้าหมายพื้นที่โฆษณาที่ไม่ได้เสนอรางวัลที่ชัดเจนให้แก่ผู้ใช้สำหรับการดูหรือโต้ตอบกับโฆษณา |
REWARDED_TYPE_REWARDED |
กำหนดเป้าหมายพื้นที่โฆษณาที่ให้รางวัลแก่ผู้ใช้เพื่อแลกกับการดูหรือมีส่วนร่วมกับโฆษณา |
PackageVideoTargeting
เกณฑ์การกำหนดเป้าหมายเฉพาะวิดีโอ
| การแสดง JSON |
|---|
{ "includedMimeTypes": [ enum ( |
| ฟิลด์ | |
|---|---|
includedMimeTypes[] |
ไม่บังคับ รายการประเภท MIME ของวิดีโอที่กำหนดเป้าหมายโดยใช้สตริงประเภท MIME ที่เผยแพร่โดย IANA (https://www.iana.org/assignments/media-types/media-types.xhtml) หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภท MIME ของวิดีโอ |
includedMaximumAdDurationTargeting |
ไม่บังคับ ระยะเวลาสูงสุดที่กำหนดเป้าหมายของโฆษณาวิดีโอ หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงระยะเวลาสูงสุดของโฆษณาวิดีโอ |
includedPositionTypes[] |
ไม่บังคับ ประเภทตำแหน่งโฆษณาวิดีโอที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทตำแหน่งโฆษณาวิดีโอ |
includedContentDeliveryMethod |
ไม่บังคับ วิธีการแสดงวิดีโอที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงวิธีการแสดงวิดีโอ |
plcmtTargeting |
ไม่บังคับ ประเภท Plcmt ของวิดีโอที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทตำแหน่งโฆษณาวิดีโอ |
includedPlaybackMethods[] |
ไม่บังคับ รายการวิธีการเล่นวิดีโอที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงวิธีการเล่นวิดีโอ |
minimumPredictedCompletionRatePercentage |
ไม่บังคับ เปอร์เซ็นต์อัตราการเล่นจนจบขั้นต่ำที่คาดการณ์ไว้ซึ่งกำหนดเป้าหมาย ค่านี้ต้องเป็นจำนวนที่หารด้วย 10 ลงตัวซึ่งอยู่ระหว่าง 10 ถึง 90 (รวม) เช่น 10 ใช้ได้ แต่ 0, 15 และ 100 ใช้ไม่ได้ ค่า 10 หมายความว่าการกำหนดค่าจะจับคู่กับช่องโฆษณาที่เราคาดการณ์ว่ามีอัตราการเล่นจนจบอย่างน้อย 10% เท่านั้น ค่าที่ไม่ได้ตั้งค่าไว้จะบ่งบอกว่าพื้นที่โฆษณาจะได้รับการกำหนดเป้าหมายโดยไม่คำนึงถึงอัตราการเล่นจนจบที่คาดการณ์ไว้ |
includedPlayerSizeTargeting |
ไม่บังคับ ขนาดวิดีโอเพลเยอร์ที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงขนาดวิดีโอเพลเยอร์ |
VideoMimeType
ประเภท MIME ของวิดีโอที่จะกำหนดเป้าหมาย
| Enum | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
VIDEO_MIME_TYPE_THREEGPP |
รูปแบบคอนเทนเนอร์ 3GPP ที่ใช้ในโทรศัพท์ 3G |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
คอนเทนเนอร์ MPEG-4 โดยปกติจะมีตัวแปลงรหัส H.264 |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (ใช้สำหรับโฆษณา VPAID) |
VIDEO_MIME_TYPE_WEBM |
คอนเทนเนอร์ WebM ที่ใช้ตัวแปลงรหัส VP9 |
MaximumVideoAdDuration
ขีดจำกัดสูงสุดของระยะเวลาของครีเอทีฟโฆษณาวิดีโอที่จะกำหนดเป้าหมาย ค่า enum จะกำหนดที่เก็บข้อมูล และการเลือกค่าหมายความว่าระยะเวลาของครีเอทีฟโฆษณาต้องน้อยกว่าหรือเท่ากับเวลาที่ระบุ
| Enum | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
ใช้กับโฆษณาวิดีโอที่มีระยะเวลาไม่เกิน 15 วินาที (0 < ระยะเวลา <= 15 วินาที) |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
ใช้กับโฆษณาวิดีโอที่มีระยะเวลาไม่เกิน 20 วินาที (0 < ระยะเวลา <= 20 วินาที) |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
ใช้กับโฆษณาวิดีโอที่มีระยะเวลาไม่เกิน 30 วินาที (0 < ระยะเวลา <= 30 วินาที) |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
ใช้กับโฆษณาวิดีโอที่มีระยะเวลาไม่เกิน 60 วินาที (0 < ระยะเวลา <= 60 วินาที) |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
ใช้กับโฆษณาวิดีโอที่มีระยะเวลาไม่เกิน 90 วินาที (0 < ระยะเวลา <= 90 วินาที) |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
ใช้กับโฆษณาวิดีโอที่มีระยะเวลาไม่เกิน 120 วินาที (0 < ระยะเวลา <= 120 วินาที) |
PositionType
ตำแหน่งที่กำหนดเป้าหมายได้ของโฆษณาภายในวิดีโอ
| Enum | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
POSITION_TYPE_MIDROLL |
โฆษณาจะเล่นระหว่างเนื้อหาวิดีโอ |
POSITION_TYPE_POSTROLL |
โฆษณาจะเล่นหลังจากเนื้อหาวิดีโอ |
POSITION_TYPE_PREROLL |
โฆษณาจะเล่นก่อนเนื้อหาวิดีโอ |
ContentDeliveryMethod
เกณฑ์การกำหนดเป้าหมายตามวิธีการแสดงเนื้อหาวิดีโอ
| Enum | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
CONTENT_DELIVERY_METHOD_STREAMING |
กำหนดเป้าหมายเนื้อหาวิดีโอที่กำลังถ่ายทอดสด |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
กำหนดเป้าหมายเนื้อหาวิดีโอที่โอนแบบเพิ่มขึ้นทีละน้อยตามที่การเล่นของไคลเอ็นต์ต้องการ |
VideoPlcmtTargeting
กำหนดเกณฑ์การกำหนดเป้าหมายตามประเภทตำแหน่งวิดีโอ ซึ่งมักจะสอดคล้องกับช่อง "plcmt" ของ OpenRTB ของ IAB
| การแสดง JSON |
|---|
{ "selectionType": enum ( |
| ช่อง | |
|---|---|
selectionType |
ต้องระบุ ประเภทการเลือกสำหรับรายการตำแหน่งโฆษณาวิดีโอ |
videoPlcmtTypes[] |
ต้องระบุ รายการประเภทตำแหน่งโฆษณาวิดีโอที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทตำแหน่งโฆษณาวิดีโอ |
SelectionType
Enum สำหรับประเภทการเลือกที่เป็นไปได้ซึ่งใช้โดยมิติข้อมูลการกำหนดเป้าหมาย
| Enum | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
ประเภทการเลือกที่ไม่ระบุ ไม่ควรใช้ |
SELECTION_TYPE_INCLUDE |
ระบบจะรวมค่าในมิติข้อมูลการกำหนดเป้าหมาย |
SELECTION_TYPE_EXCLUDE |
ระบบจะยกเว้นค่าในมิติข้อมูลการกำหนดเป้าหมาย |
VideoPlcmtType
แสดงประเภทตำแหน่งวิดีโอตามมาตรฐาน OpenRTB
| Enum | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
ค่าเริ่มต้น ไม่ควรใช้ในข้อกำหนดการกำหนดเป้าหมาย |
INSTREAM |
โฆษณาตอนต้น โฆษณาตอนกลาง และโฆษณาตอนท้ายที่เล่นก่อน ระหว่าง หรือหลังเนื้อหาวิดีโอสตรีมมิงที่ผู้บริโภคขอ วิดีโอในสตรีมต้องตั้งค่าเป็น "เปิดเสียง" โดยค่าเริ่มต้นเมื่อเริ่มเล่น หรือมีความตั้งใจของผู้ใช้ที่ชัดเจนในการดูเนื้อหาวิดีโอ แม้ว่าอาจมีเนื้อหาอื่นๆ อยู่รอบเพลเยอร์ แต่เนื้อหาวิดีโอต้องเป็นจุดสนใจในการเข้าชมของผู้ใช้ วิดีโอเพลเยอร์ควรยังคงเป็นเนื้อหาหลักในหน้าเว็บและเป็นวิดีโอเพลเยอร์เดียวที่มองเห็นได้ซึ่งสามารถเล่นเสียงได้เมื่อเล่น หากเพลเยอร์เปลี่ยนเป็นแบบลอย/ติดหนึบ การเรียกโฆษณาที่ตามมาควรแสดงขนาดเพลเยอร์ที่อัปเดตอย่างถูกต้อง |
ACCOMPANYING_CONTENT |
โฆษณาตอนต้น โฆษณาตอนกลาง และโฆษณาตอนท้ายที่เล่นก่อน ระหว่าง หรือหลังเนื้อหาวิดีโอสตรีมมิง วิดีโอเพลเยอร์จะโหลดและเล่นก่อน ระหว่าง หรือหลังย่อหน้าของข้อความหรือเนื้อหากราฟิก และจะเริ่มเล่นเมื่อเข้าสู่วิวพอร์ตเท่านั้น เนื้อหาประกอบควรเริ่มเล่นเมื่อเข้าสู่วิวพอร์ตเท่านั้น โดยอาจเปลี่ยนเป็นเพลเยอร์แบบลอย/ยึดติดเมื่อเลื่อนออกจากหน้าเว็บ |
INTERSTITIAL |
โฆษณาวิดีโอที่เล่นโดยไม่มีเนื้อหาวิดีโอ ในระหว่างการเล่น โฆษณาต้องเป็นจุดสนใจหลักของหน้าและกินพื้นที่ส่วนใหญ่ของวิวพอร์ต และผู้ใช้ต้องเลื่อนออกจากมุมมองไม่ได้ ซึ่งอาจอยู่ในตำแหน่งโฆษณา เช่น วิดีโอในแอปหรือภาพสไลด์ |
NO_CONTENT |
โฆษณาวิดีโอที่เล่นโดยไม่มีเนื้อหาวิดีโอสตรีมมิง ซึ่งอาจอยู่ในตำแหน่งโฆษณา เช่น ภาพสไลด์, ฟีดเนทีฟ, ในเนื้อหา หรือโฆษณาแบบติดหนึบ/ลอย |
PlaybackMethod
วิธีการเล่นที่จะกำหนดเป้าหมาย
| Enum | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
วิธีการเล่นวิดีโอที่ไม่ระบุ ไม่ควรใช้ |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
การเล่นจะเริ่มโดยอัตโนมัติเมื่อหน้าเว็บ/เนื้อหาโหลดขึ้นมา |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
การเล่นจะเริ่มโดยอัตโนมัติเมื่อหน้าเว็บ/เนื้อหาโหลดขึ้น แต่จะปิดเสียงไว้ |
PLAYBACK_METHOD_CLICK_TO_PLAY |
การเล่นเริ่มต้นโดยการดำเนินการของผู้ใช้ (เช่น การคลิกปุ่มเล่น) |
VideoPlayerSizeTargeting
แสดงขนาดของวิดีโอเพลเยอร์ที่กำหนดเป้าหมายได้ ต้องตั้งค่าทั้งความกว้างและความสูงเป็นค่าที่ไม่ใช่ 0
| การแสดง JSON |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| ช่อง | |
|---|---|
minimumWidth |
ต้องระบุ ความกว้างขั้นต่ำของวิดีโอเพลเยอร์ในหน่วยพิกเซล |
minimumHeight |
ต้องระบุ ความสูงขั้นต่ำของวิดีโอเพลเยอร์ในหน่วยพิกเซล |
StringTargetingDimension
การกำหนดเป้าหมายทั่วไปที่มีค่าสตริง
| การแสดง JSON |
|---|
{
"selectionType": enum ( |
| ช่อง | |
|---|---|
selectionType |
ต้องระบุ วิธีกำหนดเป้าหมายรายการในลิสต์นี้ |
values[] |
ต้องระบุ ค่าที่ระบุ |
AdSize
แสดงขนาดของช่องโฆษณาเดียวหรือครีเอทีฟโฆษณา
| การแสดง JSON |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| ช่อง | |
|---|---|
width |
ความกว้างของช่องโฆษณาในหน่วยพิกเซล ช่องนี้จะแสดงก็ต่อเมื่อประเภทขนาดเป็น |
height |
ความสูงของช่องโฆษณาเป็นพิกเซล ช่องนี้จะแสดงก็ต่อเมื่อประเภทขนาดเป็น |
type |
ประเภทของขนาดช่องโฆษณา |
ประเภท
แสดงขนาดช่องโฆษณา/ขนาดครีเอทีฟโฆษณาประเภทต่างๆ
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
ตัวยึดตำแหน่งสำหรับประเภทขนาดที่ไม่ได้กำหนด |
PIXEL |
ช่องโฆษณาที่มีขนาดที่ระบุตามความสูงและความกว้างเป็นพิกเซล |
INTERSTITIAL |
ขนาดพิเศษเพื่ออธิบายช่องโฆษณาคั่นระหว่างหน้า |
NATIVE |
โฆษณาเนทีฟ (บนอุปกรณ์เคลื่อนที่) ที่แสดงโดยผู้เผยแพร่โฆษณา |
FLUID |
ขนาดแบบไหล (ขนาดที่ปรับเปลี่ยนตามพื้นที่โฆษณา) สามารถปรับขนาดโดยอัตโนมัติเมื่อสภาพแวดล้อมภายนอกเปลี่ยนแปลง |
CriteriaTargeting
การกำหนดเป้าหมายทั่วไปที่ใช้สำหรับการกำหนดเป้าหมายมิติข้อมูลที่มีรายการรหัสตัวเลขที่รวมและยกเว้น ซึ่งไม่สามารถกรองโดยใช้ไวยากรณ์ตัวกรองรายการ
| การแสดง JSON |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| ช่อง | |
|---|---|
targetedCriteriaIds[] |
รายการรหัสที่เป็นตัวเลขที่จะรวมไว้ |
excludedCriteriaIds[] |
รายการรหัสตัวเลขที่จะยกเว้น |
PackagePlacementTargeting
แสดงถึงการกำหนดเป้าหมายเกี่ยวกับตำแหน่งที่โฆษณาจะปรากฏ เช่น เว็บไซต์หรือแอปพลิเคชันบนอุปกรณ์เคลื่อนที่บางรายการ ประเภทการกำหนดเป้าหมายจากตำแหน่งที่แตกต่างกันจะใช้ตรรกะ OR
| การแสดง JSON |
|---|
{ "uriTargeting": { object ( |
| ฟิลด์ | |
|---|---|
uriTargeting |
ไม่บังคับ รายการ URL ที่กำหนดเป้าหมายหรือยกเว้น โดเมนควรตัด http/https ออก (เช่น google.com) และมีเส้นทางได้สูงสุด 5 เส้นทางต่อ URL |
mobileAppTargeting |
ไม่บังคับ รายการรหัสแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่กำหนดเป้าหมายหรือยกเว้นซึ่งผู้เผยแพร่โฆษณาเป็นเจ้าของ ปัจจุบันรองรับเฉพาะแอป Android และ Apple เท่านั้น รหัสแอป Android เช่น com.google.android.apps.maps จะอยู่ใน URL ของ Google Play Store ส่วนรหัสแอป iOS (ซึ่งเป็นตัวเลข) จะอยู่ที่ส่วนท้ายของ URL ของ iTunes Store แอปพลิเคชันบนอุปกรณ์เคลื่อนที่ของบุคคลที่หนึ่งจะรวมอยู่หรือยกเว้น |
includedMobileAppCategoryTargeting[] |
ไม่บังคับ รายการหมวดหมู่แอปบนอุปกรณ์เคลื่อนที่ที่กำหนดเป้าหมาย |
PackagePublisherProvidedSignalsTargeting
แสดงการกำหนดเป้าหมายเกี่ยวกับสัญญาณที่ได้จากผู้เผยแพร่โฆษณา สัญญาณที่ได้จากผู้เผยแพร่โฆษณาประเภทต่างๆ จะใช้ตรรกะ OR
| การแสดง JSON |
|---|
{ "audienceTargeting": { object ( |
| ฟิลด์ | |
|---|---|
audienceTargeting |
ไม่บังคับ รายการรหัสกลุ่มเป้าหมายที่กำหนดเป้าหมายหรือยกเว้น อิงตามการจัดหมวดหมู่กลุ่มเป้าหมายของ IAB เวอร์ชัน 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) |
contentTargeting |
ไม่บังคับ รายการรหัส Content ID ที่กำหนดเป้าหมายหรือยกเว้น อิงตามการจัดหมวดหมู่เนื้อหาของ IAB เวอร์ชัน 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) |
videoAndAudioSignalsTargeting |
ไม่บังคับ รายการรหัสสัญญาณวิดีโอและเสียงที่กำหนดเป้าหมายและยกเว้น สัญญาณเหล่านี้เป็นสัญญาณเพิ่มเติมที่รองรับโดยสัญญาณที่ได้จากผู้เผยแพร่โฆษณา |
TaxonomyTargeting
กำหนดเกณฑ์การกำหนดเป้าหมายสำหรับการจัดการพื้นที่รหัสการจัดหมวดหมู่กลุ่มเป้าหมายและเนื้อหาของ IAB
| การแสดง JSON |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| ฟิลด์ | |
|---|---|
targetedTaxonomyIds[] |
ไม่บังคับ รายการรหัสการจัดหมวดหมู่เนื้อหาที่กำหนดเป้าหมาย |
excludedTaxonomyIds[] |
ไม่บังคับ รายการรหัสการจัดหมวดหมู่เนื้อหาที่ยกเว้น |
CurationFeeVisibility
การแสดงค่าธรรมเนียมแพ็กเกจการดูแลจัดการและค่าธรรมเนียมกลุ่มเป้าหมายตามข้อมูลรวมกัน (ค่าธรรมเนียมการดูแลจัดการทั้งหมด) ผู้สร้างแพ็กเกจจะเห็นค่าธรรมเนียมเสมอ
| Enum | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
ไม่ได้ระบุระดับการเข้าถึงค่าธรรมเนียมการดูแลจัดการทั้งหมด |
DISCLOSED |
ผู้ซื้อทุกคนจะเห็นค่าธรรมเนียมการดูแลจัดการทั้งหมด ค่านี้เป็นค่าเริ่มต้นหากไม่ได้ตั้งค่าไว้ |
NON_DISCLOSED |
ผู้ซื้อบางรายจะไม่เห็นค่าธรรมเนียมการดูแลจัดการทั้งหมด |
เมธอด |
|
|---|---|
|
เปิดใช้งานแพ็กเกจที่มีการดูแลจัดการที่มีอยู่ |
|
สร้างแพ็กเกจที่มีการดูแลจัดการใหม่ |
|
ปิดใช้งานแพ็กเกจที่มีการดูแลจัดการที่มีอยู่ |
|
รับแพ็กเกจที่ดูแลจัดการตามชื่อทรัพยากร |
|
แสดงรายการแพ็กเกจที่ดูแลจัดการซึ่งเป็นของผู้ดูแลจัดการที่ระบุ |
|
อัปเดตแพ็กเกจที่ดูแลจัดการที่มีอยู่ |