REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

{
  "channelId": string,
  "negative": boolean
}

string (int64 format)

ต้องระบุ รหัสของช่อง ดูช่องรหัสช่องในแหล่งข้อมูลช่องที่พาร์ทเนอร์เป็นเจ้าของหรือช่องที่ผู้ลงโฆษณาเป็นเจ้าของ

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่ สำหรับตัวเลือกการกำหนดเป้าหมายระดับผู้ลงโฆษณาที่กำหนด ฟิลด์นี้ต้องเป็น "จริง"

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของหมวดหมู่แอป

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_APP_CATEGORY

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}

string

ต้องระบุ รหัสของแอป

แอป Play Store ของ Android ใช้รหัสชุด เช่น com.google.android.gm รหัสแอป App Store ของ Apple ใช้สตริง 9 หลัก เช่น 422689480

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของแอป

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

enum (AppPlatform)

ระบุแพลตฟอร์มของแอปที่กำหนดเป้าหมาย หากไม่ได้ระบุช่องนี้ ระบบจะถือว่าแพลตฟอร์มแอปเป็นอุปกรณ์เคลื่อนที่ (เช่น Android หรือ iOS) แล้วเราจะดึงข้อมูลแพลตฟอร์มอุปกรณ์เคลื่อนที่ที่เหมาะสมจากรหัสแอป

{
  "url": string,
  "negative": boolean
}

string

ต้องระบุ URL เช่น example.com

DV360 รองรับการกำหนดเป้าหมายไดเรกทอรีย่อย 2 ระดับ เช่น www.example.com/one-subdirectory-level/second-level และการกำหนดเป้าหมายโดเมนย่อย 5 ระดับ เช่น five.four.three.two.one.example.com

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}

enum (DayOfWeek)

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

integer

ต้องระบุ ชั่วโมงเริ่มต้นสำหรับการกำหนดเป้าหมายตามวันและเวลา ต้องอยู่ระหว่าง 0 (เมื่อเริ่มต้นวัน) ถึง 23 (1 ชั่วโมงก่อนสิ้นสุดวัน)

integer

ต้องระบุ ชั่วโมงสิ้นสุดสำหรับการกำหนดเป้าหมายตามวันและเวลา ต้องอยู่ระหว่าง 1 (1 ชั่วโมงหลังเริ่มวัน) ถึง 24 (สิ้นสุดวัน)

enum (TimeZoneResolution)

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

{
  "ageRange": enum (AgeRange),
  "targetingOptionId": string
}

enum (AgeRange)

ช่วงอายุของผู้ชม เราสนับสนุนเฉพาะการกำหนดเป้าหมายช่วงอายุต่อเนื่องสำหรับผู้ชมเท่านั้น ดังนั้น ช่วงอายุที่แสดงในฟิลด์นี้อาจเป็น 1) กำหนดเป้าหมายเพียงอย่างเดียว หรือ 2) เป็นส่วนหนึ่งของช่วงอายุที่ต่อเนื่องมากขึ้น สามารถขยายการเข้าถึงของการกำหนดเป้าหมายตามช่วงอายุแบบต่อเนื่องได้โดยการกำหนดกลุ่มเป้าหมายที่ไม่ทราบอายุด้วย

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_AGE_RANGE

{
  "regionalLocationListId": string,
  "negative": boolean
}

string (int64 format)

ต้องระบุ รหัสของรายการสถานที่ตั้งระดับภูมิภาค ควรอ้างอิงช่อง locationListId ของทรัพยากร LocationList ซึ่งมีประเภทเป็น TARGETING_LOCATION_TYPE_REGIONAL

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}

string (int64 format)

ต้องระบุ รหัสของรายการตำแหน่งสถานที่ใกล้เคียง ควรอ้างอิงช่อง locationListId ของทรัพยากร LocationList ซึ่งมีประเภทเป็น TARGETING_LOCATION_TYPE_PROXIMITY

enum (ProximityRadiusRange)

ต้องระบุ ช่วงรัศมีสำหรับรายการตำแหน่งสถานที่ใกล้เคียง ค่านี้แสดงถึงขนาดพื้นที่รอบๆ สถานที่ที่เลือกที่จะกำหนดเป้าหมาย

All การกำหนดเป้าหมายสถานที่ใกล้เคียงภายใต้ทรัพยากรเดียวต้องมีค่าช่วงรัศมีเหมือนกัน ตั้งค่านี้ให้ตรงกับการกำหนดเป้าหมายที่มีอยู่ หากอัปเดตแล้ว ช่องนี้จะเปลี่ยนช่วงรัศมีสำหรับการกำหนดเป้าหมายที่ใกล้เคียงกันทั้งหมดภายใต้แหล่งข้อมูล

{
  "gender": enum (Gender),
  "targetingOptionId": string
}

enum (Gender)

เพศของผู้ชม

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_GENDER

{
  "targetingOptionId": string,
  "videoPlayerSize": enum (VideoPlayerSize)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_VIDEO_PLAYER_SIZE

enum (VideoPlayerSize)

ขนาดของวิดีโอเพลเยอร์

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_USER_REWARDED_CONTENT

enum (UserRewardedContent)

เอาต์พุตเท่านั้น สถานะเนื้อหาที่มีการให้รางวัลจากผู้ใช้สำหรับโฆษณาวิดีโอ

{
  "parentalStatus": enum (ParentalStatus),
  "targetingOptionId": string
}

enum (ParentalStatus)

สถานะความเป็นบิดามารดาของกลุ่มเป้าหมาย

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_PARENTAL_STATUS

{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_CONTENT_INSTREAM_POSITION

enum (ContentInstreamPosition)

ตำแหน่งในสตรีมของเนื้อหาสำหรับโฆษณาวิดีโอหรือโฆษณาเสียง

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

enum (AdType)

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

• AD_TYPE_VIDEO รายการโฆษณาใหม่จะรับค่าการตั้งค่านี้เมื่อ lineItemType เท่ากับ LINE_ITEM_TYPE_VIDEO_DEFAULT
• AD_TYPE_AUDIO รายการโฆษณาใหม่จะรับค่าการตั้งค่านี้เมื่อ lineItemType เท่ากับ LINE_ITEM_TYPE_AUDIO_DEFAULT

{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION

enum (ContentOutstreamPosition)

ตำแหน่งเนื้อหานอกสตรีม

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

enum (AdType)

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

• AD_TYPE_DISPLAY รายการโฆษณาใหม่จะรับค่าการตั้งค่านี้เมื่อ lineItemType เท่ากับ LINE_ITEM_TYPE_DISPLAY_DEFAULT
• AD_TYPE_VIDEO รายการโฆษณาใหม่จะรับค่าการตั้งค่านี้เมื่อ lineItemType เท่ากับ LINE_ITEM_TYPE_VIDEO_DEFAULT

{
  "targetingOptionId": string,
  "deviceType": enum (DeviceType)
}

string

ต้องระบุ รหัสของประเภทอุปกรณ์

enum (DeviceType)

ชื่อที่แสดงของประเภทอุปกรณ์

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

รหัสกลุ่มเป้าหมาย Google ของกลุ่มเป้าหมายโดย Google ที่รวมอยู่ มีเฉพาะรหัสกลุ่มเป้าหมาย Google เท่านั้น

object (CustomListGroup)

รหัสรายการที่กำหนดเองของกลุ่มรายการที่กำหนดเองซึ่งรวมอยู่ มีเฉพาะรหัสรายการที่กำหนดเองเท่านั้น

object (CombinedAudienceGroup)

รหัสกลุ่มเป้าหมายแบบรวมของกลุ่มเป้าหมายแบบรวมที่รวมไว้ มีเฉพาะรหัสกลุ่มเป้าหมายแบบรวมเท่านั้น

object (FirstAndThirdPartyAudienceGroup)

รหัสกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สาม รวมถึงแหล่งที่มาของกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สามที่ยกเว้น ใช้สำหรับการกำหนดเป้าหมายเชิงลบ การใช้ความสอดคล้องของ UNION ของกลุ่มนี้และกลุ่มผู้ชมที่ยกเว้นอื่นๆ จะใช้เป็น INTERSECTION สำหรับการกำหนดกลุ่มเป้าหมายเชิงบวกใดๆ รายการทั้งหมดเป็น "OR" ของแต่ละรายการอย่างมีเหตุผล

object (GoogleAudienceGroup)

รหัสกลุ่มเป้าหมาย Google ของกลุ่มเป้าหมายโดย Google ที่ยกเว้น ใช้สำหรับการกำหนดเป้าหมายเชิงลบ การใช้ความสอดคล้องของ UNION ของกลุ่มนี้และกลุ่มผู้ชมที่ยกเว้นอื่นๆ จะใช้เป็น INTERSECTION สำหรับการกำหนดกลุ่มเป้าหมายเชิงบวกใดๆ มีเฉพาะกลุ่มเป้าหมายของ Google ประเภทผู้สนใจ กลุ่มเป้าหมายที่มีแผนจะซื้อ และแอปที่ติดตั้งแล้ว รายการทั้งหมดเป็น "OR" ของแต่ละรายการอย่างมีเหตุผล

{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}

object (FirstAndThirdPartyAudienceTargetingSetting)

ต้องระบุ การตั้งค่าการกำหนดกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สามทั้งหมดในกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สาม ไม่อนุญาตการตั้งค่าซ้ำที่มีรหัสเดียวกัน

{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}

string (int64 format)

ต้องระบุ รหัสกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สามของการตั้งค่าการกำหนดกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สาม รหัสนี้คือ firstAndThirdPartyAudienceId

enum (Recency)

ความใหม่ของการตั้งค่าการกำหนดกลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สาม มีผลกับกลุ่มเป้าหมายบุคคลที่หนึ่งเท่านั้น มิฉะนั้นระบบจะไม่สนใจ ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/displayvideo/answer/2949947#recency เมื่อไม่ระบุ ระบบจะไม่ใช้ขีดจำกัดความใหม่

{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}

object (GoogleAudienceTargetingSetting)

ต้องระบุ การตั้งค่าการกำหนดกลุ่มเป้าหมายทั้งหมดของ Google ในกลุ่มเป้าหมายของ Google ระบบจะไม่สนใจการตั้งค่าที่ซ้ำกันโดยใช้รหัสเดียวกัน

{
  "googleAudienceId": string
}

string (int64 format)

ต้องระบุ รหัสกลุ่มเป้าหมายของ Google ของการตั้งค่าการกำหนดกลุ่มเป้าหมายของ Google รหัสนี้คือ googleAudienceId

{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}

object (CustomListTargetingSetting)

ต้องระบุ การตั้งค่าการกำหนดเป้าหมายตามรายการที่กำหนดเองทั้งหมดในกลุ่มรายการที่กำหนดเอง ระบบจะไม่สนใจการตั้งค่าที่ซ้ำกันโดยใช้รหัสเดียวกัน

{
  "customListId": string
}

string (int64 format)

ต้องระบุ รหัสที่กำหนดเองของการตั้งค่าการกำหนดเป้าหมายรายการที่กำหนดเอง รหัสนี้คือ customListId

{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}

object (CombinedAudienceTargetingSetting)

ต้องระบุ การตั้งค่าการกำหนดกลุ่มเป้าหมายแบบรวมทั้งหมดในกลุ่มเป้าหมายแบบรวม ระบบจะไม่สนใจการตั้งค่าที่ซ้ำกันโดยใช้รหัสเดียวกัน จำนวนการตั้งค่ากลุ่มเป้าหมายแบบรวมไม่ควรเกิน 5 รายการ ไม่เช่นนั้นระบบจะแสดงข้อผิดพลาด

{
  "combinedAudienceId": string
}

string (int64 format)

ต้องระบุ รหัสกลุ่มเป้าหมายแบบรวมของการตั้งค่าการกำหนดกลุ่มเป้าหมายแบบรวม รหัสนี้คือ combinedAudienceId

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของเบราว์เซอร์

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_BROWSER

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่ ตัวเลือกการกำหนดเป้าหมายเบราว์เซอร์ที่กำหนดไว้ทั้งหมดในทรัพยากรเดียวกันต้องมีค่าเหมือนกันสำหรับช่องนี้

{
  "householdIncome": enum (HouseholdIncome),
  "targetingOptionId": string
}

enum (HouseholdIncome)

รายได้ครัวเรือนของกลุ่มเป้าหมาย

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_HOUSEHOLD_INCOME

{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_ON_SCREEN_POSITION

enum (OnScreenPosition)

เอาต์พุตเท่านั้น ตำแหน่งบนหน้าจอ

enum (AdType)

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

• AD_TYPE_DISPLAY รายการโฆษณาใหม่จะรับค่าการตั้งค่านี้เมื่อ lineItemType เท่ากับ LINE_ITEM_TYPE_DISPLAY_DEFAULT
• AD_TYPE_VIDEO รายการโฆษณาใหม่จะรับค่าการตั้งค่านี้เมื่อ lineItemType เท่ากับ LINE_ITEM_TYPE_VIDEO_DEFAULT

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของผู้ให้บริการหรือ ISP

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_CARRIER_AND_ISP

boolean

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

{
  "keyword": string,
  "negative": boolean
}

string

ต้องระบุ คีย์เวิร์ด เช่น car insurance

คีย์เวิร์ดเชิงบวกต้องไม่เป็นคำที่ไม่เหมาะสม ต้องเป็น UTF-8 ที่เข้ารหัสขนาดไม่เกิน 255 ไบต์ มีอักขระได้สูงสุด 80 ตัว จำนวนคำสูงสุดคือ 10 คำ

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "negativeKeywordListId": string
}

string (int64 format)

ต้องระบุ รหัสของรายการคีย์เวิร์ดเชิงลบ ควรอ้างอิงช่อง negativeKeywordListId ของทรัพยากร NegativeKeywordList

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของระบบปฏิบัติการ

string

ต้องระบุ รหัสตัวเลือกการกำหนดเป้าหมายจะสร้างขึ้นในช่อง targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_OPERATING_SYSTEM

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของยี่ห้อและรุ่นของอุปกรณ์

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_DEVICE_MAKE_MODEL

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "environment": enum (Environment),
  "targetingOptionId": string
}

enum (Environment)

สภาพแวดล้อมการให้บริการ

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_ENVIRONMENT (เช่น "508010" สำหรับการกำหนดเป้าหมายตัวเลือก ENVIRONMENT_WEB_OPTIMIZED)

{
  "inventorySourceId": string
}

string (int64 format)

ต้องระบุ รหัสแหล่งที่มาของพื้นที่โฆษณา ควรอ้างอิงช่อง inventorySourceId ของทรัพยากร InventorySource

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของหมวดหมู่

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_CATEGORY

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "viewability": enum (Viewability),
  "targetingOptionId": string
}

enum (Viewability)

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

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_VIEWABILITY (เช่น "509010" สำหรับการกำหนดเป้าหมายตัวเลือก VIEWABILITY_10_PERCENT_OR_MORE)

{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}

enum (AuthorizedSellerStatus)

เอาต์พุตเท่านั้น สถานะผู้ขายที่ได้รับอนุญาตที่จะกำหนดเป้าหมาย

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_AUTHORIZED_SELLER_STATUS

{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของภาษา (เช่น "ฝรั่งเศส")

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_LANGUAGE

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่ ตัวเลือกการกำหนดภาษาเป้าหมายที่กำหนดทั้งหมดในทรัพยากรเดียวกันต้องมีค่าเหมือนกันสำหรับช่องนี้

{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของภูมิภาคทางภูมิศาสตร์ (เช่น "ออนแทรีโอ แคนาดา")

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_GEO_REGION

enum (GeoRegionType)

เอาต์พุตเท่านั้น ประเภทของการกำหนดเป้าหมายตามพื้นที่ทางภูมิศาสตร์

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่

{
  "inventorySourceGroupId": string
}

string (int64 format)

ต้องระบุ รหัสของกลุ่มแหล่งที่มาของพื้นที่โฆษณา ควรอ้างอิงช่อง inventorySourceGroupId ของทรัพยากร InventorySourceGroup

{
  "excludedTargetingOptionId": string,
  "contentRatingTier": enum (ContentRatingTier)
}

string

ต้องระบุ รหัสของป้ายกำกับเนื้อหาดิจิทัลที่จะยกเว้น

enum (ContentRatingTier)

เอาต์พุตเท่านั้น ชื่อที่แสดงของระดับการให้คะแนนป้ายกำกับเนื้อหาดิจิทัล

{
  "excludedTargetingOptionId": string,
  "sensitiveCategory": enum (SensitiveCategory)
}

string

ต้องระบุ รหัสของหมวดหมู่ที่ละเอียดอ่อนที่จะยกเว้น

enum (SensitiveCategory)

เอาต์พุตเท่านั้น Enum สำหรับตัวแยกประเภทเนื้อหาที่ละเอียดอ่อนของ DV360

{
  "targetingOptionId": string
}

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_EXCHANGE

{
  "targetingOptionId": string
}

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_SUB_EXCHANGE

{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}

object (Adloox)

ผู้ยืนยันแบรนด์บุคคลที่สาม -- Adloox

object (DoubleVerify)

ผู้ตรวจสอบแบรนด์บุคคลที่สาม -- DoubleVerify

object (IntegralAdScience)

ผู้ตรวจสอบแบรนด์บุคคลที่สาม ได้แก่ Integral Ad Science

{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}

enum (AdlooxCategory)

การตั้งค่าความปลอดภัยของแบรนด์ของ Adloox

{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}

object (BrandSafetyCategories)

การควบคุมความปลอดภัยของแบรนด์ของ DV

enum (AgeRating)

หลีกเลี่ยงการเสนอราคาสําหรับแอปที่มีการจัดประเภทตามอายุ

object (AppStarRating)

หลีกเลี่ยงการเสนอราคาสำหรับแอปที่มีการให้ดาว

object (DisplayViewability)

การตั้งค่าการมองเห็นโฆษณาในเครือข่ายดิสเพลย์ (ใช้ได้กับรายการโฆษณาในเครือข่ายดิสเพลย์เท่านั้น)

object (VideoViewability)

การตั้งค่าการมองเห็นโฆษณาวิดีโอ (ใช้ได้กับรายการโฆษณาวิดีโอเท่านั้น)

object (FraudInvalidTraffic)

หลีกเลี่ยงเว็บไซต์และแอปที่มีประวัติการฉ้อโกง และ อัตรา IVT

string (int64 format)

รหัสกลุ่มเป้าหมายที่กำหนดเองจาก DoubleVerify รหัสต้องขึ้นต้นด้วย "51" และประกอบด้วยตัวเลข 8 หลัก ระบุรหัสกลุ่มเป้าหมายที่กำหนดเองพร้อมกับช่องต่อไปนี้ไม่ได้

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}

boolean

ไม่รู้จักหรือไม่สามารถให้คะแนนได้

enum (HighSeverityCategory)

หมวดหมู่การหลีกเลี่ยงความรุนแรงสูงด้านความปลอดภัยของแบรนด์

enum (MediumSeverityCategory)

หมวดหมู่การหลีกเลี่ยงความรุนแรงระดับปานกลางเรื่องความปลอดภัยของแบรนด์

{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}

enum (StarRating)

หลีกเลี่ยงการเสนอราคาสำหรับแอปที่มีการให้ดาว

boolean

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

{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}

enum (IAB)

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

enum (ViewableDuring)

กำหนดเป้าหมายพื้นที่โฆษณาในเว็บและแอปเพื่อเพิ่มระยะเวลาที่ได้แสดง 100% ให้สูงสุด

{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}

enum (VideoIAB)

กำหนดเป้าหมายพื้นที่โฆษณาเว็บเพื่อเพิ่มอัตราที่มองเห็นได้ของ IAB ให้ได้สูงสุด

enum (VideoViewableRate)

กำหนดเป้าหมายพื้นที่โฆษณาเว็บเพื่อเพิ่มอัตราที่มองเห็นได้ทั้งหมดให้ได้สูงสุด

enum (PlayerImpressionRate)

กำหนดเป้าหมายพื้นที่โฆษณาเพื่อเพิ่มการแสดงผลให้ได้สูงสุดด้วยโปรแกรมเล่นขนาด 400x300 ขึ้นไป

{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}

enum (FraudOption)

หลีกเลี่ยงเว็บไซต์และแอปที่มีประวัติการฉ้อโกง และ IVT

boolean

การประพฤติมิชอบที่ผ่านมาไม่เพียงพอและ สถิติ IVT

{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}

enum (TRAQScore)

คุณภาพการโฆษณาที่แท้จริง (ใช้ได้กับรายการโฆษณาในเครือข่ายดิสเพลย์เท่านั้น)

boolean

ความปลอดภัยของแบรนด์ - ประเมินไม่ได้

enum (Adult)

ความปลอดภัยของแบรนด์ - เนื้อหาสำหรับผู้ใหญ่

enum (Alcohol)

ความปลอดภัยของแบรนด์ - เครื่องดื่มแอลกอฮอล์

enum (IllegalDownloads)

ความปลอดภัยของแบรนด์ - การดาวน์โหลดที่ผิดกฎหมาย

enum (Drugs)

ความปลอดภัยของแบรนด์ - ยา

enum (HateSpeech)

ความปลอดภัยของแบรนด์ - วาจาสร้างความเกลียดชัง

enum (OffensiveLanguage)

ความปลอดภัยของแบรนด์ - ภาษาที่ไม่เหมาะสม

enum (Violence)

ความปลอดภัยของแบรนด์ - ความรุนแรง

enum (Gambling)

ความปลอดภัยของแบรนด์ - การพนัน

enum (AdFraudPrevention)

การตั้งค่าการฉ้อโกงผ่านโฆษณา

enum (DisplayViewability)

ส่วนความสามารถในการแสดงตัวโฆษณา (ใช้กับรายการโฆษณาแบบดิสเพลย์เท่านั้น)

enum (VideoViewability)

ส่วนการมองเห็นโฆษณาวิดีโอ (ใช้ได้กับรายการโฆษณาวิดีโอเท่านั้น)

string (int64 format)

รหัสกลุ่มเป้าหมายที่กำหนดเองจาก Integral Ad Science รหัสต้องอยู่ระหว่าง 1000001 ถึง 1999999 เท่านั้น

{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของจุดที่น่าสนใจ เช่น "ไทม์สแควร์", "สเปซนีดเดิล" ตามด้วยที่อยู่แบบเต็ม หากมี

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_POI

ดึงรหัสตัวเลือกการกำหนดเป้าหมายจุดที่น่าสนใจที่ยอมรับได้โดยใช้ SearchTargetingOptions

หากกำหนดเป้าหมายพิกัดละติจูด/ลองจิจูดที่เฉพาะเจาะจงถูกลบออกจากที่อยู่หรือชื่อจุดที่น่าสนใจ คุณสามารถสร้างรหัสตัวเลือกการกำหนดเป้าหมายที่จำเป็นโดยปัดเศษค่าพิกัดที่ต้องการไปยังตำแหน่งทศนิยมที่ 6 ลบทศนิยม และเชื่อมค่าสตริงที่คั่นด้วยเครื่องหมายอัฒภาค ตัวอย่างเช่น คุณกำหนดเป้าหมายคู่ละติจูด/ลองจิจูดเป็น 40.7414691, -74.003387 ได้โดยใช้รหัสตัวเลือกการกำหนดเป้าหมาย "40741469;-74003387"

number

เอาต์พุตเท่านั้น ละติจูดของจุดที่น่าสนใจปัดเศษทศนิยมที่ 6

number

เอาต์พุตเท่านั้น ลองจิจูดของจุดที่น่าสนใจจะปัดเศษทศนิยมที่ 6

number

ต้องระบุ รัศมีของพื้นที่รอบๆ จุดที่น่าสนใจที่จะกำหนดเป้าหมาย หน่วยของรัศมีระบุด้วย proximityRadiusUnit ต้องเป็น 1 ถึง 800 หากหน่วยเป็น DISTANCE_UNIT_KILOMETERS และ 1 ถึง 500 หากหน่วยเป็น DISTANCE_UNIT_MILES

enum (DistanceUnit)

ต้องระบุ หน่วยของระยะทางที่ใช้วัดรัศมีการกำหนดเป้าหมาย

{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของเชนธุรกิจ เช่น "KFC", "Chase Bank"

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_BUSINESS_CHAIN

ดูรหัสตัวเลือกการกำหนดเป้าหมายเชนธุรกิจที่ยอมรับได้โดยใช้ SearchTargetingOptions

number

ต้องระบุ รัศมีของพื้นที่รอบๆ เชนธุรกิจที่จะกำหนดเป้าหมาย หน่วยของรัศมีระบุด้วย proximityRadiusUnit ต้องเป็น 1 ถึง 800 หากหน่วยเป็น DISTANCE_UNIT_KILOMETERS และ 1 ถึง 500 หากหน่วยเป็น DISTANCE_UNIT_MILES จำนวนที่เพิ่มขึ้นต่ำสุดสำหรับทั้ง 2 กรณีคือ 0.1 ระบบจะปัดเศษอินพุตเป็นค่าที่ยอมรับได้ที่ใกล้เคียงที่สุด หากมีรายละเอียดมากเกินไป เช่น 15.57 จะกลายเป็น 15.6

enum (DistanceUnit)

ต้องระบุ หน่วยของระยะทางที่ใช้วัดรัศมีการกำหนดเป้าหมาย

{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_CONTENT_DURATION

enum (ContentDuration)

เอาต์พุตเท่านั้น ระยะเวลาของเนื้อหา

{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_CONTENT_STREAM_TYPE

enum (ContentStreamType)

เอาต์พุตเท่านั้น ประเภทสตรีมเนื้อหา

{
  "targetingOptionId": string,
  "contentPosition": enum (NativeContentPosition)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_NATIVE_CONTENT_POSITION

enum (NativeContentPosition)

ตำแหน่งเนื้อหา

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

{
  "omid": enum (Omid),
  "targetingOptionId": string
}

enum (Omid)

ประเภทของพื้นที่โฆษณาที่เปิดใช้ Open Measurement

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

string

ต้องระบุ targetingOptionId ของ TargetingOption ประเภท TARGETING_TYPE_OMID

{
  "targetingOptionId": string,
  "audioContentType": enum (AudioContentType)
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_AUDIO_CONTENT_TYPE

enum (AudioContentType)

ประเภทเนื้อหาเสียง

เอาต์พุตเฉพาะใน v1 ต้องระบุในเวอร์ชัน 2

{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}

string

ต้องระบุ ฟิลด์ targetingOptionId เมื่อ targetingType คือ TARGETING_TYPE_CONTENT_GENRE

string

เอาต์พุตเท่านั้น ชื่อที่แสดงของประเภทเนื้อหา

boolean

บ่งบอกว่าตัวเลือกนี้มีการกำหนดเป้าหมายเชิงลบหรือไม่