REST Resource: curators.curatedPackages

ทรัพยากร: CuratedPackage

แสดงแพ็กเกจพื้นที่โฆษณาที่มีการดูแลจัดการซึ่งสร้างและจัดการโดยผู้ดูแลจัดการ

การแสดง JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
ช่อง
name

string

ตัวระบุ ชื่อทรัพยากรที่ไม่ซ้ำกันสำหรับแพ็กเกจที่ดูแลจัดการ รูปแบบ: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

ต้องระบุ ชื่อที่แสดงซึ่งผู้ดูแลจัดการกำหนดให้กับแพ็กเกจที่ดูแลจัดการ ใช้เพื่อกรองการตอบกลับของเมธอด curatedPackages.list ได้

description

string

ไม่บังคับ คำอธิบายแพ็กเกจที่มีการดูแลจัดการซึ่งระบุโดยผู้ดูแลจัดการ

createTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่สร้างแพ็กเกจที่มีการดูแลจัดการ ใช้เพื่อกรองการตอบกลับของเมธอด curatedPackages.list ได้

ใช้ 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"

updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตแพ็กเกจที่ดูแลจัดการครั้งล่าสุด ใช้เพื่อกรองการตอบกลับของเมธอด curatedPackages.list ได้

ใช้ 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"

floorPriceCpm

object (Money)

ไม่บังคับ CPM ขั้นต่ำที่ผู้ซื้อต้องเสนอราคาเพื่อเข้าร่วมการประมูลพื้นที่โฆษณาในแพ็กเกจที่ดูแลจัดการนี้ ใช้เพื่อกรองการตอบกลับของเมธอด curatedPackages.list ได้

state

enum (State)

เอาต์พุตเท่านั้น สถานะของแพ็กเกจที่ดูแลจัดการ ใช้เพื่อกรองการตอบกลับของเมธอด curatedPackages.list ได้

accessSettings

object (AccessControlSettings)

ต้องระบุ การตั้งค่าสำหรับควบคุมการเข้าถึงแพ็กเกจที่ดูแลจัดการ

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

targeting

object (PackageTargeting)

ไม่บังคับ เกณฑ์การกำหนดเป้าหมายสำหรับแพ็กเกจที่ดูแลจัดการ

curationFeeVisibility

enum (CurationFeeVisibility)

ไม่บังคับ เปลี่ยนแปลงไม่ได้ การแสดงค่าธรรมเนียมแพ็กเกจการดูแลจัดการและค่าธรรมเนียมกลุ่มเป้าหมายตามข้อมูลรวมกัน (ค่าธรรมเนียมการดูแลจัดการทั้งหมด)

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

object (Money)

ไม่บังคับ ค่าธรรมเนียม CPM ที่ผู้ดูแลจัดการเรียกเก็บจากผู้ซื้อที่ใช้แพ็กเกจที่ดูแลจัดการนี้ ใช้เพื่อกรองการตอบกลับของเมธอด curatedPackages.list ได้

millipercentOfMediaFee

string (int64 format)

ไม่บังคับ ระบบจะเรียกเก็บค่าธรรมเนียมเป็นเปอร์เซ็นต์ของต้นทุนการแสดงผล ซึ่งแสดงเป็นหน่วยมิลลิเปอร์เซ็นต์ เช่น 1% จะแสดงเป็น 1000

สิ้นสุดฟิลด์ที่แยกกัน

รัฐ

สถานะของแพ็กเกจที่ดูแลจัดการ

Enum
STATE_UNSPECIFIED ค่าเริ่มต้น
ACTIVE แพ็กเกจที่ดูแลจัดการทำงานอยู่
INACTIVE แพ็กเกจที่ดูแลจัดการไม่มีการใช้งาน

AccessControlSettings

การตั้งค่าสำหรับควบคุมการเข้าถึงแพ็กเกจที่ดูแลจัดการ

การแสดง JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
ช่อง
allowlistedMediaPlanners[]

string

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

รูปแบบ: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

เกณฑ์การกำหนดเป้าหมายสำหรับแพ็กเกจที่ดูแลจัดการและแพ็กเกจการประมูล

การแสดง JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
ฟิลด์
includedDeviceTypes[]

enum (DeviceType)

ไม่บังคับ รายการประเภทอุปกรณ์ที่รวมไว้เพื่อกำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายอุปกรณ์ทุกประเภท

includedEnvironment

enum (Environment)

ไม่บังคับ สภาพแวดล้อมที่จะกำหนดเป้าหมาย หากไม่ระบุ ระบบจะกำหนดเป้าหมายไปยังสภาพแวดล้อมทั้งหมด

includedCreativeFormat

enum (CreativeFormat)

ไม่บังคับ รูปแบบครีเอทีฟโฆษณาที่จะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายมาร์กอัปครีเอทีฟโฆษณาทุกประเภท

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

ไม่บังคับ ประเภท Accelerated Mobile Pages ที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงสถานะ AMP

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

ไม่บังคับ รายการสถานะผู้ขายที่ได้รับอนุญาตที่กำหนดเป้าหมายซึ่งรวมอยู่ หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงสถานะของผู้ขาย

includedNativeInventoryTypes[]

enum (NativeInventoryType)

ไม่บังคับ ประเภทพื้นที่โฆษณาเนทีฟที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทพื้นที่โฆษณาเนทีฟ

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

ไม่บังคับ รายการประเภทการวัดผลแบบเปิดที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงการรองรับ Open Measurement

includedRestrictedCategories[]

enum (RestrictedCategory)

ไม่บังคับ รายการหมวดหมู่ที่จำกัดที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงหมวดหมู่ที่จำกัด

includedRewardedType

enum (RewardedType)

ไม่บังคับ ประเภทรางวัลที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทที่มีการให้รางวัล

videoTargeting

object (PackageVideoTargeting)

ไม่บังคับ เกณฑ์การกำหนดเป้าหมายเฉพาะวิดีโอ

minimumPredictedViewabilityPercentage

string (int64 format)

ไม่บังคับ เปอร์เซ็นต์การมองเห็นโฆษณาขั้นต่ำที่คาดการณ์ไว้ซึ่งกำหนดเป้าหมาย

ค่านี้ต้องเป็นจำนวนที่หารด้วย 10 ลงตัวซึ่งอยู่ระหว่าง 10 ถึง 90 (รวม) เช่น 10 ใช้ได้ แต่ 0, 15 และ 100 ใช้ไม่ได้ ค่า 10 หมายความว่าการกำหนดค่าจะจับคู่กับช่องโฆษณาที่เราคาดการณ์ว่ามีการมองเห็นโฆษณาอย่างน้อย 10% เท่านั้น

ค่าที่ไม่ได้ตั้งค่าไว้บ่งบอกว่าระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงการมองเห็นโฆษณาที่คาดการณ์ไว้

languageTargeting

object (StringTargetingDimension)

ไม่บังคับ ภาษาที่จะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงภาษา ดูรายการรหัสภาษาที่รองรับได้ที่ https://developers.google.com/google-ads/api/data/codes-formats#languages

includedAdSizes[]

object (AdSize)

ไม่บังคับ รายการขนาดโฆษณาที่จะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงขนาดโฆษณา

แพ็กเกจที่ดูแลจัดการรองรับขนาดโฆษณา PIXEL และ INTERSTITIAL

publisherTargeting

object (StringTargetingDimension)

ไม่บังคับ ผู้เผยแพร่โฆษณาที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงผู้เผยแพร่โฆษณา ระบบจะระบุผู้เผยแพร่โฆษณาด้วยรหัสผู้เผยแพร่โฆษณาจาก ads.txt / app-ads.txt ดูรายละเอียดเพิ่มเติมได้ที่ https://iabtechlab.com/ads-txt/ และ https://iabtechlab.com/app-ads-txt/

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

ไม่บังคับ อัตราการคลิกผ่านขั้นต่ำที่คาดการณ์ไว้ซึ่งเป็นเป้าหมาย โดยมีค่าอยู่ในช่วง [10, 10000] (0.01% - 10%) ค่า 50 หมายความว่าการกำหนดค่าจะจับคู่กับช่องโฆษณาที่เราคาดการณ์ว่ามีอัตราการคลิกผ่านอย่างน้อย 0.05% เท่านั้น

ค่าที่ไม่ได้ตั้งค่าไว้จะระบุว่าระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงอัตราการคลิกผ่านที่คาดการณ์ไว้

verticalTargeting

object (CriteriaTargeting)

ไม่บังคับ ประเภทธุรกิจที่รวมหรือยกเว้นตามที่ระบุไว้ใน https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทธุรกิจ

geoTargeting

object (CriteriaTargeting)

ไม่บังคับ รหัสเกณฑ์ทางภูมิศาสตร์ที่จะรวมหรือยกเว้นตามที่ระบุไว้ใน https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงภูมิศาสตร์

includedDataSegments[]

string

ไม่บังคับ กลุ่มเป้าหมายตามข้อมูลที่ใช้งานอยู่ซึ่งจะกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงกลุ่มข้อมูล รูปแบบ: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

ไม่บังคับ ข้อมูลการกำหนดเป้าหมายจากตำแหน่ง เช่น URL, แอปพลิเคชันบนอุปกรณ์เคลื่อนที่

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

ไม่บังคับ สัญญาณที่ได้จากผู้เผยแพร่โฆษณาเพื่อกำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงสัญญาณที่ได้จากผู้เผยแพร่โฆษณา

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 (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
ฟิลด์
includedMimeTypes[]

enum (VideoMimeType)

ไม่บังคับ รายการประเภท MIME ของวิดีโอที่กำหนดเป้าหมายโดยใช้สตริงประเภท MIME ที่เผยแพร่โดย IANA (https://www.iana.org/assignments/media-types/media-types.xhtml) หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภท MIME ของวิดีโอ

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

ไม่บังคับ ระยะเวลาสูงสุดที่กำหนดเป้าหมายของโฆษณาวิดีโอ หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงระยะเวลาสูงสุดของโฆษณาวิดีโอ

includedPositionTypes[]

enum (PositionType)

ไม่บังคับ ประเภทตำแหน่งโฆษณาวิดีโอที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทตำแหน่งโฆษณาวิดีโอ

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

ไม่บังคับ วิธีการแสดงวิดีโอที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงวิธีการแสดงวิดีโอ

plcmtTargeting

object (VideoPlcmtTargeting)

ไม่บังคับ ประเภท Plcmt ของวิดีโอที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทตำแหน่งโฆษณาวิดีโอ

includedPlaybackMethods[]

enum (PlaybackMethod)

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

minimumPredictedCompletionRatePercentage

string (int64 format)

ไม่บังคับ เปอร์เซ็นต์อัตราการเล่นจนจบขั้นต่ำที่คาดการณ์ไว้ซึ่งกำหนดเป้าหมาย

ค่านี้ต้องเป็นจำนวนที่หารด้วย 10 ลงตัวซึ่งอยู่ระหว่าง 10 ถึง 90 (รวม) เช่น 10 ใช้ได้ แต่ 0, 15 และ 100 ใช้ไม่ได้ ค่า 10 หมายความว่าการกำหนดค่าจะจับคู่กับช่องโฆษณาที่เราคาดการณ์ว่ามีอัตราการเล่นจนจบอย่างน้อย 10% เท่านั้น

ค่าที่ไม่ได้ตั้งค่าไว้จะบ่งบอกว่าพื้นที่โฆษณาจะได้รับการกำหนดเป้าหมายโดยไม่คำนึงถึงอัตราการเล่นจนจบที่คาดการณ์ไว้

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

ไม่บังคับ ขนาดวิดีโอเพลเยอร์ที่กำหนดเป้าหมาย หากไม่ได้ตั้งค่า ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงขนาดวิดีโอเพลเยอร์

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": [
    enum (VideoPlcmtType)
  ]
}
ช่อง
selectionType

enum (SelectionType)

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

videoPlcmtTypes[]

enum (VideoPlcmtType)

ต้องระบุ รายการประเภทตำแหน่งโฆษณาวิดีโอที่กำหนดเป้าหมาย หากเว้นว่างไว้ ระบบจะกำหนดเป้าหมายพื้นที่โฆษณาโดยไม่คำนึงถึงประเภทตำแหน่งโฆษณาวิดีโอ

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

string (int64 format)

ต้องระบุ ความกว้างขั้นต่ำของวิดีโอเพลเยอร์ในหน่วยพิกเซล

minimumHeight

string (int64 format)

ต้องระบุ ความสูงขั้นต่ำของวิดีโอเพลเยอร์ในหน่วยพิกเซล

StringTargetingDimension

การกำหนดเป้าหมายทั่วไปที่มีค่าสตริง

การแสดง JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
ช่อง
selectionType

enum (SelectionType)

ต้องระบุ วิธีกำหนดเป้าหมายรายการในลิสต์นี้

values[]

string

ต้องระบุ ค่าที่ระบุ

AdSize

แสดงขนาดของช่องโฆษณาเดียวหรือครีเอทีฟโฆษณา

การแสดง JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
ช่อง
width

string (int64 format)

ความกว้างของช่องโฆษณาในหน่วยพิกเซล ช่องนี้จะแสดงก็ต่อเมื่อประเภทขนาดเป็น PIXEL เท่านั้น

height

string (int64 format)

ความสูงของช่องโฆษณาเป็นพิกเซล ช่องนี้จะแสดงก็ต่อเมื่อประเภทขนาดเป็น PIXEL เท่านั้น

type

enum (Type)

ประเภทของขนาดช่องโฆษณา

ประเภท

แสดงขนาดช่องโฆษณา/ขนาดครีเอทีฟโฆษณาประเภทต่างๆ

Enum
TYPE_UNSPECIFIED ตัวยึดตำแหน่งสำหรับประเภทขนาดที่ไม่ได้กำหนด
PIXEL ช่องโฆษณาที่มีขนาดที่ระบุตามความสูงและความกว้างเป็นพิกเซล
INTERSTITIAL ขนาดพิเศษเพื่ออธิบายช่องโฆษณาคั่นระหว่างหน้า
NATIVE โฆษณาเนทีฟ (บนอุปกรณ์เคลื่อนที่) ที่แสดงโดยผู้เผยแพร่โฆษณา
FLUID ขนาดแบบไหล (ขนาดที่ปรับเปลี่ยนตามพื้นที่โฆษณา) สามารถปรับขนาดโดยอัตโนมัติเมื่อสภาพแวดล้อมภายนอกเปลี่ยนแปลง

CriteriaTargeting

การกำหนดเป้าหมายทั่วไปที่ใช้สำหรับการกำหนดเป้าหมายมิติข้อมูลที่มีรายการรหัสตัวเลขที่รวมและยกเว้น ซึ่งไม่สามารถกรองโดยใช้ไวยากรณ์ตัวกรองรายการ

การแสดง JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
ช่อง
targetedCriteriaIds[]

string (int64 format)

รายการรหัสที่เป็นตัวเลขที่จะรวมไว้

excludedCriteriaIds[]

string (int64 format)

รายการรหัสตัวเลขที่จะยกเว้น

PackagePlacementTargeting

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

การแสดง JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
ฟิลด์
uriTargeting

object (StringTargetingDimension)

ไม่บังคับ รายการ URL ที่กำหนดเป้าหมายหรือยกเว้น โดเมนควรตัด http/https ออก (เช่น google.com) และมีเส้นทางได้สูงสุด 5 เส้นทางต่อ URL

mobileAppTargeting

object (StringTargetingDimension)

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

รหัสแอป Android เช่น com.google.android.apps.maps จะอยู่ใน URL ของ Google Play Store ส่วนรหัสแอป iOS (ซึ่งเป็นตัวเลข) จะอยู่ที่ส่วนท้ายของ URL ของ iTunes Store แอปพลิเคชันบนอุปกรณ์เคลื่อนที่ของบุคคลที่หนึ่งจะรวมอยู่หรือยกเว้น

includedMobileAppCategoryTargeting[]

string (int64 format)

ไม่บังคับ รายการหมวดหมู่แอปบนอุปกรณ์เคลื่อนที่ที่กำหนดเป้าหมาย

PackagePublisherProvidedSignalsTargeting

แสดงการกำหนดเป้าหมายเกี่ยวกับสัญญาณที่ได้จากผู้เผยแพร่โฆษณา สัญญาณที่ได้จากผู้เผยแพร่โฆษณาประเภทต่างๆ จะใช้ตรรกะ OR

การแสดง JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
ฟิลด์
audienceTargeting

object (TaxonomyTargeting)

ไม่บังคับ รายการรหัสกลุ่มเป้าหมายที่กำหนดเป้าหมายหรือยกเว้น อิงตามการจัดหมวดหมู่กลุ่มเป้าหมายของ IAB เวอร์ชัน 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

ไม่บังคับ รายการรหัส Content ID ที่กำหนดเป้าหมายหรือยกเว้น อิงตามการจัดหมวดหมู่เนื้อหาของ IAB เวอร์ชัน 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

ไม่บังคับ รายการรหัสสัญญาณวิดีโอและเสียงที่กำหนดเป้าหมายและยกเว้น สัญญาณเหล่านี้เป็นสัญญาณเพิ่มเติมที่รองรับโดยสัญญาณที่ได้จากผู้เผยแพร่โฆษณา

TaxonomyTargeting

กำหนดเกณฑ์การกำหนดเป้าหมายสำหรับการจัดการพื้นที่รหัสการจัดหมวดหมู่กลุ่มเป้าหมายและเนื้อหาของ IAB

การแสดง JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
ฟิลด์
targetedTaxonomyIds[]

string

ไม่บังคับ รายการรหัสการจัดหมวดหมู่เนื้อหาที่กำหนดเป้าหมาย

excludedTaxonomyIds[]

string

ไม่บังคับ รายการรหัสการจัดหมวดหมู่เนื้อหาที่ยกเว้น

CurationFeeVisibility

การแสดงค่าธรรมเนียมแพ็กเกจการดูแลจัดการและค่าธรรมเนียมกลุ่มเป้าหมายตามข้อมูลรวมกัน (ค่าธรรมเนียมการดูแลจัดการทั้งหมด) ผู้สร้างแพ็กเกจจะเห็นค่าธรรมเนียมเสมอ

Enum
CURATION_FEE_VISIBILITY_UNSPECIFIED ไม่ได้ระบุระดับการเข้าถึงค่าธรรมเนียมการดูแลจัดการทั้งหมด
DISCLOSED ผู้ซื้อทุกคนจะเห็นค่าธรรมเนียมการดูแลจัดการทั้งหมด ค่านี้เป็นค่าเริ่มต้นหากไม่ได้ตั้งค่าไว้
NON_DISCLOSED ผู้ซื้อบางรายจะไม่เห็นค่าธรรมเนียมการดูแลจัดการทั้งหมด

เมธอด

activate

เปิดใช้งานแพ็กเกจที่มีการดูแลจัดการที่มีอยู่

create

สร้างแพ็กเกจที่มีการดูแลจัดการใหม่

deactivate

ปิดใช้งานแพ็กเกจที่มีการดูแลจัดการที่มีอยู่

get

รับแพ็กเกจที่ดูแลจัดการตามชื่อทรัพยากร

list

แสดงรายการแพ็กเกจที่ดูแลจัดการซึ่งเป็นของผู้ดูแลจัดการที่ระบุ

patch

อัปเดตแพ็กเกจที่ดูแลจัดการที่มีอยู่