REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Tài nguyên: AssignedTargetingOption

Một tiêu chí nhắm mục tiêu được chỉ định duy nhất, xác định trạng thái của một tiêu chí nhắm mục tiêu cho một thực thể có chế độ cài đặt 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)
  },
  "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)
  }
  // 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 tiêu chí 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ể sử 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 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 của 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.
Trường nhóm details. Thông tin chi tiết về tiêu chí nhắm mục tiêu được chỉ định. Bạn chỉ có thể điền một trường trong phần 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 sau:
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)

Thông tin chi tiết về ứ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 con cái. 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 chi tiết 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à ISP. 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 có giới hạn về 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à kiểu máy của 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ảng không quảng cáo. 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 bạn nhắm đến một danh mục, các danh mục con của danh mục đó cũng sẽ được nhắm đến. 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 chi tiết 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. Nếu bạn đặt tiêu chí loại trừ nhãn nội dung kỹ thuật số ở cấp nhà quảng cáo, thì tiêu chí này 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). 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ừ của 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 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 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 được đặt, tiêu chí loại trừ danh mục nhạy cảm ở cấp nhà quảng cáo sẽ 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). 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ủ đề của 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 sẽ 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ũng 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ề chuỗi doanh nghiệp. 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 Open Measurement. 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.

Phương thức

create

 Chỉ định một tiêu chí nhắm mục tiêu cho đơn đặt hàng quảng cáo.

delete

 Xoá một tiêu chí nhắm mục tiêu được chỉ định khỏi đơn đặt hàng quảng cáo.

get

 Lấy một tiêu chí nhắm mục tiêu duy nhất được chỉ định cho một đơn đặt hàng quảng cáo.

list

 Liệt kê các tiêu chí nhắm mục tiêu được chỉ định cho một lệnh chèn.