REST Resource: advertisers.lineItems.targetingTypes.assignedTargetingOptions

Tài nguyên: AssignmentOption

Một tuỳ chọn nhắm mục tiêu được chỉ định, xác định trạng thái của một tuỳ chọn 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,
  "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.
}
Các trường
name

string

Chỉ có đầu ra. Tên tài nguyên cho tuỳ 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ã 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. Nội dung này có thể được sử dụng lại trong các ngữ cảnh khác.

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 nhóm details. Thông tin chi tiết về tuỳ chọn nhắm mục tiêu đang được chỉ định. Bạn chỉ có thể điền vào một trường có thông tin chi tiết và trường đó phải tương ứng với targeting_type; details chỉ có thể là một trong các 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 có giá trị 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 có giá trị 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 có giá trị 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 có giá trị 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 có giá trị 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 có giá trị là TARGETING_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 targetingType có giá trị là TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Chi tiết danh sách vị trí lân cận. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị 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 có giá trị là TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Thông tin chi tiết về trạng thái là phụ huynh. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí trong luồng nội dung. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị là TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Thông tin chi tiết về tính năng nhắm mục tiêu theo đối tượng. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị là TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Thông tin về vị trí trên màn hình. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị 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á khẳng định 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 có giá trị 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 có giá trị là TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Thông tin chi tiết về mẫu và kiểu thiết bị. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị là TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Chi tiết về danh mục. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_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ụ 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à có một danh mục phụ được bao gồm, 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 có giá trị là TARGETING_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 targetingType có giá trị 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ì tất cả người bán được uỷ quyền biểu thị là DIRECT hoặc RESELLER trong tệp ads.txt đều được nhắm mục tiêu theo mặc định.

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 có giá trị 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 có giá trị 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 có giá trị 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 có giá trị là TARGETING_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) 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 hiển thị 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 nhãn đó. Mục hàng sẽ không phân phát nếu tất cả các nhãn nội dung kỹ thuật số 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 có giá trị 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. Các tiêu chí loại trừ danh mục nhạy cảm ở cấp nhà quảng cáo (nếu đã đặt) 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 hiển thị 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 danh mục đó.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Thông tin về giao dịch phụ. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

Chi tiết về địa điểm yêu thích. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị 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 có giá trị là TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Thông tin chi tiết về khoảng không quảng cáo có bật tính năng Đo lường mở. Trường này sẽ được điền sẵn khi targetingType có giá trị 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 có giá trị 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 có giá trị là TARGETING_TYPE_CONTENT_GENRE.

Phương thức

create

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

delete

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

get

Nhận một tuỳ chọn nhắm mục tiêu được chỉ định cho một mục hàng.

list

Liệt kê các tuỳ chọn nhắm mục tiêu được chỉ định cho một mục hàng.