REST Resource: partners.targetingTypes.assignedTargetingOptions

Tài nguyên: AssignedTargetingOption

Một lựa chọn nhắm mục tiêu được chỉ định duy nhất, xác định trạng thái của một lựa 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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên cho lựa 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 lựa chọn nhắm mục tiêu được chỉ định. Mã nhận dạng này 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. Bạn có thể dùng lại mã này trong các bối cảnh khác.
assignedTargetingOptionIdAlias

string

Chỉ có đầu ra. Bí danh cho 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 lựa chọn nhắm mục tiêu được chỉ định của các loại tiêu chí nhắm mục tiêu sau:

  • 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 lựa chọn nhắm mục tiêu được chỉ định của mục hàng thuộc các loại tiêu chí 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 lựa 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 tiêu chí nhắm mục tiêu được chỉ định.
Thông tin chi tiết về lựa chọn nhắm mục tiêu được chỉ định. Bạn chỉ được điền một trường trong phần thông tin chi tiết và trường đó phải tương ứng với targeting_type; Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Thông tin chi tiết về kênh. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Chi tiết ứng dụng. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Thông tin chi tiết về URL. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Thông tin chi tiết về danh sách địa điểm theo khu vực. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Thông tin chi tiết về danh sách vị trí lân cận. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Thông tin chi tiết về nội dung có tặng thưởng cho người dùng. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Thông tin chi tiết về tình trạng làm cha mẹ. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí của nội dung ngoài luồng phát. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_AUDIENCE_GROUP. Bạn chỉ có thể nhắm đến 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 targetingType là TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Thông tin về thu nhập hộ gia đình. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Thông tin chi tiết về nhà mạng và nhà cung cấp dịch vụ Internet. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Thông tin chi tiết về từ khoá. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 giới hạn số lượng từ khoá tích cực có thể được chỉ định.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Thông tin chi tiết về từ khoá. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Thông tin chi tiết về nhà sản xuất và mẫu thiết bị. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Thông tin chi tiết về nguồn kho hàng. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_TYPE_CATEGORY.

Khi nhắm đến một danh mục, bạn cũng sẽ nhắm đến các danh mục con của danh mục đó. Nếu một danh mục bị loại trừ khỏi tiêu chí nhắm mục tiêu và một danh mục con được đưa vào, thì tiêu chí 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 targetingType là TARGETING_TYPE_VIEWABILITY.

Bạn chỉ có thể nhắm đến một lựa chọn về 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 người bán được uỷ quyền. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Bạn chỉ có thể nhắm đến một lựa chọn trạng thái người bán được uỷ quyền cho mỗi tài nguyên.

Nếu một tài nguyên không có lựa chọn trạng thái người bán được uỷ quyền, thì theo mặc định, tất cả người bán được uỷ quyền được chỉ định là TRỰC TIẾP hoặc ĐẠI LÝ trong tệp ads.txt đều là mục tiêu.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Thông tin về ngôn ngữ. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Nhãn nội dung kỹ thuật số là tiêu chí loại trừ nhắm mục tiêu. Nhãn nội dung kỹ thuật số ở cấp nhà quảng cáo (nếu được đặt) luôn được áp dụng trong quá trình phân phát (mặc dù không xuất hiện trong phần cài đặt tài nguyên). Chế độ cài đặt tài nguyên có thể loại trừ nhãn nội dung ngoài các tiêu chí loại trừ nhà quảng cáo, nhưng không thể ghi đè các tiêu chí đó. Một mục hàng sẽ không phân phát nếu bạn loại trừ tất cả nhãn nội dung kỹ thuật số.
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 targetingType là TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Danh mục nhạy cảm là tiêu chí loại trừ nhắm mục tiêu. Nếu bạn đặt chế độ loại trừ danh mục nhạy cảm ở cấp nhà quảng cáo, thì chế độ này sẽ luôn được áp dụng trong quá trình phân phát (mặc dù chế độ này không xuất hiện trong phần 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 các tiêu chí loại trừ nhà quảng cáo, nhưng không thể ghi đè các tiêu chí đó.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

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

Chủ đề nội dung là tiêu chí loại trừ nhắm mục tiêu. Nếu được đặt, tiêu chí loại trừ chủ đề nội dung ở cấp nhà quảng cáo luôn được áp dụng trong quá trình phân phát (mặc dù tiêu chí này không xuất hiện trong phần cài đặt tài nguyên). Ngoài tiêu chí loại trừ nhà quảng cáo, chế độ cài đặt tài nguyên còn có thể loại trừ chủ đề nội dung.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Thông tin chi tiết về sàn giao dịch. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Thông tin chi tiết về sàn giao dịch phụ. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

Thông tin 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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Thông tin chi tiết về thể loại nội dung. Trường này sẽ được điền sẵn khi targetingType là TARGETING_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 targetingType là TARGETING_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 targetingType là TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

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

object (YoutubeChannelPackAssignedTargetingOptionDetails)

Thông tin chi tiết về gói kênh YouTube. Trường này sẽ được điền sẵn khi targetingType là TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
Kết thúc các trường loại trừ lẫn nhau.

Phương thức

create

 Chỉ định một lựa chọn nhắm mục tiêu cho đối tác.

delete

 Xoá một tiêu chí nhắm mục tiêu được chỉ định khỏi một đối tác.

get

 Lấy một tiêu chí nhắm mục tiêu duy nhất được chỉ định cho một đối tác.

list

 Liệt kê các lựa chọn nhắm mục tiêu được chỉ định cho một đối tác.