REST Resource: advertisers.lineItems.targetingTypes.assignedTargetingOptions

ทรัพยากร: AssignedTargetingOption

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

การแสดง JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรสำหรับตัวเลือกการกำหนดเป้าหมายที่กำหนดนี้

assignedTargetingOptionId

string

เอาต์พุตเท่านั้น รหัสที่ไม่ซ้ำกันของตัวเลือกการกำหนดเป้าหมายที่กำหนด รหัสจะไม่ซ้ำกันภายในทรัพยากรและประเภทการกำหนดเป้าหมายหนึ่งๆ เท่านั้น ซึ่งอาจนํามาใช้ซ้ำในบริบทอื่นๆ ได้

targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

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

ฟิลด์การรวม details ข้อมูลโดยละเอียดเกี่ยวกับตัวเลือกการกำหนดเป้าหมายที่กำหนด คุณสามารถกรอกรายละเอียดได้เพียงหนึ่งฟิลด์เท่านั้น และต้องสอดคล้องกับ targeting_type โดยที่ details ต้องเป็นฟิลด์ใดฟิลด์หนึ่งต่อไปนี้เท่านั้น:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

รายละเอียดช่อง ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CHANNEL

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

รายละเอียดหมวดหมู่แอป ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_APP_CATEGORY

appDetails

object (AppAssignedTargetingOptionDetails)

รายละเอียดแอป ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_APP

urlDetails

object (UrlAssignedTargetingOptionDetails)

รายละเอียด URL ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_URL

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

รายละเอียดวันและเวลา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_DAY_AND_TIME

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

รายละเอียดช่วงอายุ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_AGE_RANGE

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

รายละเอียดรายการสถานที่ตั้งในภูมิภาค ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_REGIONAL_LOCATION_LIST

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

รายละเอียดของรายการตำแหน่งสถานที่ใกล้เคียง ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_PROXIMITY_LOCATION_LIST

genderDetails

object (GenderAssignedTargetingOptionDetails)

รายละเอียดเพศ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_GENDER

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

รายละเอียดขนาดวิดีโอเพลเยอร์ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_VIDEO_PLAYER_SIZE

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

รายละเอียดเนื้อหาที่ได้รับรางวัลจากผู้ใช้ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_USER_REWARDED_CONTENT

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

รายละเอียดสถานะความเป็นบิดามารดา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_PARENTAL_STATUS

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

รายละเอียดตำแหน่งในสตรีมของเนื้อหา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CONTENT_INSTREAM_POSITION

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

รายละเอียดตำแหน่งนอกสตรีมของเนื้อหา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

รายละเอียดประเภทอุปกรณ์ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_DEVICE_TYPE

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

รายละเอียดการกำหนดกลุ่มเป้าหมาย ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_AUDIENCE_GROUP คุณกำหนดเป้าหมายตัวเลือกกลุ่มเป้าหมายได้เพียง 1 รายการต่อทรัพยากรเท่านั้น

browserDetails

object (BrowserAssignedTargetingOptionDetails)

รายละเอียดเบราว์เซอร์ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_BROWSER

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

รายละเอียดรายได้ครัวเรือน ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_HOUSEHOLD_INCOME

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

รายละเอียดตำแหน่งบนหน้าจอ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_ON_SCREEN_POSITION

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

รายละเอียดผู้ให้บริการและ ISP ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CARRIER_AND_ISP

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

รายละเอียดคีย์เวิร์ด ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_KEYWORD

กำหนดคีย์เวิร์ดเชิงลบโดยตรงได้สูงสุด 5,000 คำให้กับทรัพยากร ไม่มีการจํากัดจํานวนคีย์เวิร์ดเชิงบวกที่กําหนดได้

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

รายละเอียดคีย์เวิร์ด ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_NEGATIVE_KEYWORD_LIST

กำหนดรายการคีย์เวิร์ดเชิงลบให้กับทรัพยากรได้สูงสุด 4 รายการ

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

รายละเอียดระบบปฏิบัติการ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_OPERATING_SYSTEM

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

รายละเอียดยี่ห้อและรุ่นของอุปกรณ์ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_DEVICE_MAKE_MODEL

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

รายละเอียดสภาพแวดล้อม ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_ENVIRONMENT

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

รายละเอียดแหล่งที่มาของพื้นที่โฆษณา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_INVENTORY_SOURCE

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

รายละเอียดหมวดหมู่ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CATEGORY

การกำหนดเป้าหมายหมวดหมู่จะกำหนดเป้าหมายหมวดหมู่ย่อยด้วย หากมีการยกเว้นหมวดหมู่จากการกำหนดเป้าหมาย และมีหมวดหมู่ย่อย การยกเว้นนั้นจะมีผลเหนือกว่า

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

รายละเอียดการมองเห็นโฆษณา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_VIEWABILITY

คุณกำหนดเป้าหมายตัวเลือกการมองเห็นโฆษณาได้เพียง 1 รายการต่อทรัพยากรเท่านั้น

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

รายละเอียดสถานะผู้ขายที่ได้รับอนุญาต ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_AUTHORIZED_SELLER_STATUS

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

หากทรัพยากรไม่มีตัวเลือกสถานะผู้ขายที่ได้รับอนุญาต ระบบจะกำหนดเป้าหมายผู้ขายที่ได้รับอนุญาตทั้งหมดที่ระบุว่าเป็น "โดยตรง" หรือ "ผู้ค้าปลีก" ในไฟล์ ads.txt โดยค่าเริ่มต้น

languageDetails

object (LanguageAssignedTargetingOptionDetails)

รายละเอียดภาษา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_LANGUAGE

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

รายละเอียดภูมิภาคทางภูมิศาสตร์ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_GEO_REGION

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

รายละเอียดกลุ่มแหล่งที่มาของพื้นที่โฆษณา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_INVENTORY_SOURCE_GROUP

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

รายละเอียดป้ายกำกับเนื้อหาดิจิทัล ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION

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

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

รายละเอียดหมวดหมู่ที่ละเอียดอ่อน ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION

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

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

รายละเอียดการแลกเปลี่ยน ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_EXCHANGE

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

รายละเอียด Exchange ย่อย ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_SUB_EXCHANGE

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

รายละเอียดการยืนยันของบุคคลที่สาม ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_THIRD_PARTY_VERIFIER

poiDetails

object (PoiAssignedTargetingOptionDetails)

รายละเอียดจุดที่น่าสนใจ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_POI

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

รายละเอียดเชนธุรกิจ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_BUSINESS_CHAIN

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

รายละเอียดระยะเวลาของเนื้อหา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CONTENT_DURATION

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

รายละเอียดระยะเวลาของเนื้อหา ช่องนี้จะสร้างขึ้นเมื่อ TargetingType คือ TARGETING_TYPE_CONTENT_STREAM_TYPE

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

รายละเอียดตำแหน่งเนื้อหาเนทีฟ ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_NATIVE_CONTENT_POSITION

omidDetails

object (OmidAssignedTargetingOptionDetails)

รายละเอียดพื้นที่โฆษณาที่เปิดใช้ Open Measurement ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_OMID

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

รายละเอียดของประเภทเนื้อหาเสียง ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_AUDIO_CONTENT_TYPE

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

รายละเอียดประเภทเนื้อหา ระบบจะป้อนข้อมูลช่องนี้เมื่อ targetingType คือTARGETING_TYPE_CONTENT_GENRE

วิธีการ

create

กำหนดตัวเลือกการกำหนดเป้าหมายให้กับรายการโฆษณา

delete

ลบตัวเลือกการกำหนดเป้าหมายที่กำหนดออกจากรายการโฆษณา

get

ได้รับตัวเลือกการกำหนดเป้าหมายเดียวที่กำหนดให้กับรายการโฆษณา

list

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