REST Resource: advertisers.targetingTypes.assignedTargetingOptions

Tài nguyên: AssignmentTargetingOption

Một tuỳ chọn nhắm mục tiêu được chỉ định, giúp xác định trạng thái của tuỳ chọn nhắm mục tiêu cho một thực thể có chế độ cài đặt tiêu chí nhắm mục tiêu.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": 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)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên cho tùy chọn nhắm mục tiêu được chỉ định này.

assignedTargetingOptionId

string

Chỉ có đầu ra. Mã nhận dạng duy nhất của tuỳ chọn nhắm mục tiêu được chỉ định. Mã nhận dạng chỉ là duy nhất trong một tài nguyên và loại tiêu chí nhắm mục tiêu nhất định. Có thể sử dụng lại dữ liệu này trong các ngữ cảnh khác.

assignedTargetingOptionIdAlias

string

Chỉ có đầu ra. Bí danh của assignedTargetingOptionId. Bạn có thể dùng giá trị này thay cho assignedTargetingOptionId khi truy xuất hoặc xoá tiêu chí nhắm mục tiêu hiện có.

Trường này sẽ chỉ được hỗ trợ cho tất cả các tùy chọn nhắm mục tiêu được chỉ định trong các loại nhắm mục tiêu sau đây:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Trường này cũng được hỗ trợ cho các tùy chọn nhắm mục tiêu được chỉ định của mục hàng thuộc các loại nhắm mục tiêu sau:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Chỉ có đầu ra. Xác định loại tuỳ chọn nhắm mục tiêu được chỉ định này.

inheritance

enum (Inheritance)

Chỉ có đầu ra. Trạng thái kế thừa của tuỳ chọn nhắm mục tiêu được chỉ định.

Trường kết hợp details. Thông tin chi tiết về lựa chọn nhắm mục tiêu đang được chỉ định. Bạn chỉ có thể điền một trường chi tiết và trường đó phải tương ứng với targeting_type; details chỉ có thể là một trong những trạng thái sau đây:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Thông tin chi tiết về kênh. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Thông tin chi tiết về danh mục ứng dụng. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Thông tin chi tiết về ứng dụng. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Chi tiết URL. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Thông tin chi tiết về ngày và giờ. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Thông tin chi tiết về độ tuổi. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Thông tin chi tiết về danh sách vị trí theo khu vực. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Thông tin chi tiết về danh sách vị trí vùng lân cận. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Thông tin chi tiết về giới tính. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Thông tin chi tiết về kích thước trình phát video. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Thông tin chi tiết về nội dung tặng thưởng của người dùng. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Thông tin chi tiết về tình trạng con cái. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí trong luồng phát của nội dung. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí nội dung ngoài luồng phát. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Thông tin chi tiết về Loại thiết bị. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo đối tượng. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_AUDIENCE_GROUP. Bạn chỉ có thể nhắm mục tiêu một lựa chọn nhóm đối tượng cho mỗi tài nguyên.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Thông tin chi tiết về trình duyệt. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Thông tin chi tiết về thu nhập hộ gia đình. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí trên màn hình. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Thông tin chi tiết về nhà mạng và ISP. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Chi tiết từ khóa. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_KEYWORD.

Bạn có thể chỉ định tối đa 5.000 từ khoá phủ định trực tiếp cho một tài nguyên. Không có giới hạn về số lượng từ khoá khẳng định có thể chỉ định.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Chi tiết từ khóa. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Bạn có thể chỉ định tối đa 4 danh sách từ khoá phủ định cho một tài nguyên.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Thông tin chi tiết về hệ điều hành. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Chi tiết về kiểu máy và nhà sản xuất thiết bị. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Thông tin chi tiết về môi trường. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Thông tin chi tiết về nguồn khoảng không quảng cáo. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Thông tin chi tiết về danh mục. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CATEGORY.

Việc nhắm mục tiêu một danh mục cũng sẽ nhắm mục tiêu các danh mục phụ. Nếu một danh mục bị loại trừ khỏi tiêu chí nhắm mục tiêu và có một danh mục phụ được đưa vào, thì việc loại trừ sẽ được ưu tiên.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Thông tin chi tiết về khả năng xem. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_VIEWABILITY.

Bạn chỉ có thể nhắm mục tiêu một tuỳ chọn khả năng xem cho mỗi tài nguyên.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Thông tin chi tiết về trạng thái của người bán được uỷ quyền. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Bạn chỉ có thể nhắm mục tiêu một tùy chọn trạng thái người bán được ủy quyền cho mỗi tài nguyên.

Nếu tài nguyên không có tùy chọn trạng thái người bán được ủy quyền, tất cả người bán được ủy quyền được chỉ định là TRỰC TIẾP hoặc RESELLER trong tệp ads.txt đều được nhắm mục tiêu theo mặc định.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Chi tiết ngôn ngữ. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Thông tin chi tiết về khu vực địa lý. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Thông tin chi tiết về nhóm nguồn khoảng không quảng cáo. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Thông tin chi tiết về nhãn nội dung kỹ thuật số. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Nhãn nội dung kỹ thuật số đang loại trừ tiêu chí nhắm mục tiêu. Các tiêu chí loại trừ nhãn nội dung kỹ thuật số cấp nhà quảng cáo (nếu được đặt) sẽ luôn được áp dụng trong quá trình phân phát (mặc dù các tiêu chí này không xuất hiện trong chế độ cài đặt tài nguyên). Các chế độ cài đặt về tài nguyên có thể loại trừ nhãn nội dung cùng với quy tắc loại trừ nhà quảng cáo, nhưng không thể ghi đè các nhãn này. Mục hàng sẽ không phân phát nếu tất cả nhãn nội dung kỹ thuật số đều bị loại trừ.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Thông tin chi tiết về danh mục nhạy cảm. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Danh mục nhạy cảm là danh mục loại trừ nhắm mục tiêu. Nếu được đặt, các tiêu chí loại trừ danh mục nhạy cảm cấp nhà quảng cáo cấp nhà quảng cáo sẽ luôn được áp dụng trong hoạt động phân phát (mặc dù các tiêu chí này không hiển thị trong chế độ cài đặt tài nguyên). Chế độ cài đặt tài nguyên có thể loại trừ các danh mục nhạy cảm ngoài việc loại trừ nhà quảng cáo, nhưng không thể ghi đè các danh mục đó.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Chi tiết về việc trao đổi. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Thông tin về việc trao đổi phụ. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Thông tin chi tiết về quy trình xác minh của bên thứ ba. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Thông tin chi tiết về địa điểm yêu thích. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Thông tin chi tiết về chuỗi doanh nghiệp. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Thông tin chi tiết về thời lượng của nội dung. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Thông tin chi tiết về thời lượng của nội dung. Trường này sẽ được điền sẵn khi Loại nhắm mục tiêu là TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí nội dung gốc. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Thông tin chi tiết về khoảng không quảng cáo đã bật tính năng Đo lường mở. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Thông tin chi tiết về loại nội dung âm thanh. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Chi tiết về thể loại nội dung. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_CONTENT_GENRE.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Thông tin chi tiết về video trên YouTube. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Thông tin chi tiết về kênh YouTube. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí trong phiên. Trường này sẽ được điền sẵn khi targetingTypeTARGETING_TYPE_SESSION_POSITION.

Phương thức

create

Chỉ định tuỳ chọn nhắm mục tiêu cho nhà quảng cáo.

delete

Xoá tuỳ chọn nhắm mục tiêu được chỉ định khỏi nhà quảng cáo.

get

Xem một tuỳ chọn nhắm mục tiêu duy nhất được chỉ định cho một nhà quảng cáo.

list

Liệt kê các lựa chọn nhắm mục tiêu được chỉ định cho một nhà quảng cáo.