REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Tài nguyên: assignTargetingOption

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 một 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 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 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 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ể sử 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 tại.

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 của các loại 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 tùy chọn nhắm mục tiêu được chỉ định của 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 đã chỉ định.

Trường hợp details. Thông tin chi tiết về lựa chọn nhắm mục tiêu được chỉ định. Bạn chỉ có thể điền một trường 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 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 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 khi targetingTypeTARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Chi tiết về vị trí nội dung ngoài luồng phát. Trường này sẽ được điề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 khi targetingTypeTARGETING_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 khi targetingTypeTARGETING_TYPE_AUDIENCE_GROUP. Bạn chỉ có thể nhắm đến một lựa chọn về nhóm đối tượng trên 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 khi targetingTypeTARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Thông tin chi tiết về mẫu thiết bị và kiểu thiết bị. Trường này sẽ được điề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 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 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 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 đến 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 bao gồm, thì tiêu chí loại trừ sẽ được ưu tiên.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

Bạn chỉ có thể nhắm mục tiêu một tùy 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 khi targetingTypeTARGETING_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 trên mỗi tài nguyên.

Nếu tài nguyên không có tuỳ 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 được chỉ định 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 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 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 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 khi targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Nhãn nội dung kỹ thuật số là tiêu chí 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 xuất hiện trong chế độ 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 khi targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Danh mục nhạy cảm là tiêu chí loại trừ tiêu chí 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 được đặt) luôn được áp dụng trong quá trình phân phát (mặc dù các tiêu chí đó 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 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ề dịch vụ đổi trả. Trường này sẽ được điền khi targetingTypeTARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

Thông tin chi tiết về POI. Trường này sẽ được điề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 khi targetingTypeTARGETING_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 khi targetingTypeTARGETING_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 khi Giá trị nhắm mục tiêu là TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Chi tiết vị trí của nội dung gốc. Trường này sẽ được điề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 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 khi targetingTypeTARGETING_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 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 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 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 khi targetingTypeTARGETING_TYPE_SESSION_POSITION.

Tính kế thừa

Cho biết liệu lựa chọn nhắm mục tiêu bạn chỉ định có được kế thừa từ một thực thể cấp cao hơn như đối tác hoặc nhà quảng cáo hay không. Các lựa chọn nhắm mục tiêu được chỉ định kế thừa có trước, luôn được áp dụng trong quá trình phân phát thay vì tiêu chí nhắm mục tiêu được chỉ định ở cấp hiện tại, và không thể sửa đổi thông qua dịch vụ thực thể hiện tại. Các đối số này phải được sửa đổi thông qua dịch vụ thực thể mà chúng được kế thừa. Tính kế thừa chỉ áp dụng cho các Kênh được nhắm mục tiêu phủ định, các tùy chọn loại trừ Danh mục nhạy cảm và các tùy chọn loại trừ Nhãn nội dung kỹ thuật số nếu được định cấu hình ở cấp độ gốc.

Enum
INHERITANCE_UNSPECIFIED Tính kế thừa chưa được chỉ định hoặc không xác định.
NOT_INHERITED Tùy chọn nhắm mục tiêu được chỉ định không được kế thừa từ thực thể cấp cao hơn.
INHERITED_FROM_PARTNER Tùy chọn nhắm mục tiêu chỉ định được kế thừa từ tùy chọn cài đặt nhắm mục tiêu của đối tác.
INHERITED_FROM_ADVERTISER Tùy chọn nhắm mục tiêu được chỉ định được kế thừa từ chế độ cài đặt nhắm mục tiêu của nhà quảng cáo.

ChannelAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo kênh được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_CHANNEL.

Biểu diễn dưới dạng JSON
{
  "channelId": string,
  "negative": boolean
}
Trường
channelId

string (int64 format)

Bắt buộc. Mã nhận dạng kênh. Bạn cần tham khảo trường mã nhận dạng kênh trên tài nguyên Kênh thuộc sở hữu của đối tác hoặc kênh của nhà quảng cáo.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không. Đối với tuỳ chọn nhắm mục tiêu được chỉ định ở cấp nhà quảng cáo, trường này phải đúng.

AppCategoryAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo danh mục ứng dụng được chỉ định. Thông tin này sẽ được điền sẵn vào trường appCategoryDetails của AssignmentOption khi targetingTypeTARGETING_TYPE_APP_CATEGORY.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của danh mục ứng dụng.

targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_APP_CATEGORY.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

AppAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo ứng dụng được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_APP.

Biểu diễn dưới dạng JSON
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Trường
appId

string

Bắt buộc. Mã của ứng dụng.

Ứng dụng Cửa hàng Play của Android sử dụng mã nhận dạng gói, ví dụ: com.google.android.gm. Mã ứng dụng trên App Store của Apple sử dụng chuỗi gồm 9 chữ số, ví dụ: 422689480.

displayName

string

Chỉ có đầu ra. Tên hiển thị của ứng dụng.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

appPlatform

enum (AppPlatform)

Cho biết nền tảng của ứng dụng được nhắm đến. Nếu bạn không chỉ định trường này, thì nền tảng ứng dụng sẽ được giả định là thiết bị di động (tức là Android hoặc iOS) và chúng tôi sẽ lấy nền tảng di động thích hợp từ ID ứng dụng.

AppPlatform

Các lựa chọn có thể nhắm mục tiêu theo nền tảng ứng dụng.

Enum
APP_PLATFORM_UNSPECIFIED Giá trị mặc định khi nền tảng ứng dụng không được chỉ định trong phiên bản này. Enum này là một phần giữ chỗ cho giá trị mặc định và không đại diện cho một tuỳ chọn thực tế của nền tảng.
APP_PLATFORM_IOS Nền tảng ứng dụng là iOS.
APP_PLATFORM_ANDROID Nền tảng ứng dụng là Android.
APP_PLATFORM_ROKU Nền tảng ứng dụng là Roku.
APP_PLATFORM_AMAZON_FIRETV Nền tảng ứng dụng là Amazon FireTV.
APP_PLATFORM_PLAYSTATION Nền tảng ứng dụng là Playstation.
APP_PLATFORM_APPLE_TV Nền tảng ứng dụng là Apple TV.
APP_PLATFORM_XBOX Nền tảng ứng dụng là Xbox.
APP_PLATFORM_SAMSUNG_TV Nền tảng ứng dụng là Samsung TV.
APP_PLATFORM_ANDROID_TV Nền tảng ứng dụng là Android TV.
APP_PLATFORM_GENERIC_CTV Nền tảng ứng dụng là nền tảng CTV chưa được liệt kê rõ ràng ở nơi nào khác.

UrlAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo URL được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_URL.

Biểu diễn dưới dạng JSON
{
  "url": string,
  "negative": boolean
}
Trường
url

string

Bắt buộc. URL, ví dụ: example.com.

DV360 hỗ trợ 2 cấp nhắm mục tiêu theo thư mục con (ví dụ: www.example.com/one-subdirectory-level/second-level) và 5 cấp nhắm mục tiêu theo miền con (ví dụ five.four.three.two.one.example.com).

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

DayAndTimeAssignedTargetingOptionDetails

Biểu thị một phân đoạn thời gian được xác định vào một ngày cụ thể trong tuần, với thời gian bắt đầu và kết thúc. Thời gian do startHour biểu thị phải trước thời gian do endHour biểu thị.

Biểu diễn dưới dạng JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Trường
dayOfWeek

enum (DayOfWeek)

Bắt buộc. Ngày trong tuần cho chế độ cài đặt nhắm mục tiêu theo ngày và giờ này.

startHour

integer

Bắt buộc. Giờ bắt đầu để nhắm mục tiêu theo ngày và giờ. Phải nằm trong khoảng từ 0 (đầu ngày) đến 23 (1 giờ trước khi kết thúc ngày).

endHour

integer

Bắt buộc. Giờ kết thúc cho tiêu chí nhắm mục tiêu theo ngày và giờ. Phải nằm trong khoảng từ 1 (1 giờ sau khi bắt đầu ngày) đến 24 (cuối ngày).

timeZoneResolution

enum (TimeZoneResolution)

Bắt buộc. Cơ chế dùng để xác định múi giờ nào được sử dụng cho chế độ cài đặt nhắm mục tiêu theo ngày và giờ này.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Chưa xác định ngày trong tuần.
MONDAY Thứ Hai
TUESDAY Thứ Ba
WEDNESDAY Thứ Tư
THURSDAY Thursday (thứ Năm)
FRIDAY Thứ Sáu
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

TimeZoneResolution

Các phương pháp có thể áp dụng để phân giải múi giờ.

Enum
TIME_ZONE_RESOLUTION_UNSPECIFIED Độ phân giải của múi giờ không cụ thể hoặc không xác định.
TIME_ZONE_RESOLUTION_END_USER Thời gian được phân giải theo múi giờ của người dùng đã xem quảng cáo.
TIME_ZONE_RESOLUTION_ADVERTISER Thời gian được phân giải theo múi giờ của nhà quảng cáo phân phát quảng cáo.

AgeRangeAssignedTargetingOptionDetails

Đại diện cho độ tuổi có thể nhắm mục tiêu. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_AGE_RANGE.

Biểu diễn dưới dạng JSON
{
  "ageRange": enum (AgeRange)
}
Trường
ageRange

enum (AgeRange)

Bắt buộc. Độ tuổi của đối tượng. Chúng tôi chỉ hỗ trợ nhắm đến một nhóm đối tượng trong độ tuổi liên tục. Do đó, độ tuổi được thể hiện trong trường này có thể là 1) chỉ được nhắm mục tiêu hoặc 2) một phần của độ tuổi liên tục lớn hơn. Bạn cũng có thể mở rộng phạm vi tiếp cận của tiêu chí nhắm mục tiêu theo độ tuổi liên tục bằng cách nhắm đến cả đối tượng ở một độ tuổi không xác định.

RegionalLocationListAssignedTargetingOptionDetails

Thông tin nhắm mục tiêu cho danh sách vị trí theo khu vực. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_REGIONAL_LOCATION_LIST.

Biểu diễn dưới dạng JSON
{
  "regionalLocationListId": string,
  "negative": boolean
}
Trường
regionalLocationListId

string (int64 format)

Bắt buộc. Mã danh sách vị trí theo khu vực. Phải tham chiếu đến trường locationListId của tài nguyên LocationList có loại TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

ProximityLocationListAssignedTargetingOptionDetails

Chi tiết nhắm mục tiêu cho danh sách vị trí lân cận. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST.

Biểu diễn dưới dạng JSON
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Trường
proximityLocationListId

string (int64 format)

Bắt buộc. Mã của danh sách vị trí lân cận. Phải tham chiếu đến trường locationListId của tài nguyên LocationList có loại TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadius

number

Bắt buộc. Bán kính được biểu thị bằng đơn vị khoảng cách đã đặt trong proximityRadiusUnit. Thuộc tính này thể hiện kích thước của khu vực xung quanh một vị trí đã chọn sẽ được nhắm mục tiêu. Bán kính nên nằm trong khoảng từ 1 đến 500 dặm hoặc 800 km.

proximityRadiusUnit

enum (ProximityRadiusUnit)

Bắt buộc. Đơn vị khoảng cách bán kính.

ProximityRadiusUnit

Enum đơn vị khoảng cách cho bán kính khoảng cách.

Enum
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Giá trị mặc định khi đơn vị khoảng cách không được chỉ định trong phiên bản này. Enum này là phần giữ chỗ cho giá trị mặc định và không đại diện cho đơn vị khoảng cách thực.
PROXIMITY_RADIUS_UNIT_MILES Đơn vị khoảng cách bán kính tính bằng dặm.
PROXIMITY_RADIUS_UNIT_KILOMETERS Đơn vị khoảng cách bán kính bằng kilômét

GenderAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo giới tính được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_GENDER.

Biểu diễn dưới dạng JSON
{
  "gender": enum (Gender)
}
Trường
gender

enum (Gender)

Bắt buộc. Giới tính của đối tượng.

VideoPlayerSizeAssignedTargetingOptionDetails

Chi tiết về lựa chọn nhắm mục tiêu theo kích thước trình phát video. Thuộc tính này sẽ được điền vào trường videoPlayerSizeDetails khi targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE. Không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Hãy xoá tất cả tiêu chí nhắm mục tiêu theo kích thước trình phát video để có được hiệu ứng này.

Biểu diễn dưới dạng JSON
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Trường
videoPlayerSize

enum (VideoPlayerSize)

Bắt buộc. Kích thước trình phát video.

UserRewardedContentAssignedTargetingOptionDetails

Chi tiết về lựa chọn nhắm mục tiêu nội dung có tặng thưởng cho người dùng. Thuộc tính này sẽ được điền vào trường userRewardedContentDetails khi targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
Trường
targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_USER_REWARDED_CONTENT.

userRewardedContent

enum (UserRewardedContent)

Chỉ có đầu ra. Trạng thái nội dung có tặng thưởng của người dùng đối với quảng cáo dạng video.

ParentalStatusAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo tình trạng con cái đã chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_PARENTAL_STATUS.

Biểu diễn dưới dạng JSON
{
  "parentalStatus": enum (ParentalStatus)
}
Trường
parentalStatus

enum (ParentalStatus)

Bắt buộc. Tình trạng con cái của đối tượng.

ContentInstreamPositionAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo vị trí trong luồng nội dung được chỉ định. Thuộc tính này sẽ được điền vào trường contentInstreamPositionDetails khi targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Biểu diễn dưới dạng JSON
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
Trường
contentInstreamPosition

enum (ContentInstreamPosition)

Bắt buộc. Vị trí trong luồng nội dung cho quảng cáo dạng video hoặc âm thanh.

adType

enum (AdType)

Chỉ có đầu ra. Loại quảng cáo cần nhắm mục tiêu. Chỉ áp dụng cho tiêu chí nhắm mục tiêu theo đơn đặt hàng quảng cáo và các mục hàng mới hỗ trợ loại quảng cáo đã chỉ định sẽ kế thừa lựa chọn nhắm mục tiêu này theo mặc định. Các giá trị có thể là:

  • AD_TYPE_VIDEO, chế độ cài đặt này sẽ được mục hàng mới kế thừa khi lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, chế độ cài đặt này sẽ được mục hàng mới kế thừa khi lineItemTypeLINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Đại diện cho loại mẫu quảng cáo được liên kết với các quảng cáo.

Enum
AD_TYPE_UNSPECIFIED Loại quảng cáo chưa được chỉ định hoặc không xác định trong phiên bản này.
AD_TYPE_DISPLAY Mẫu quảng cáo hiển thị, ví dụ: hình ảnh và HTML5.
AD_TYPE_VIDEO Mẫu quảng cáo dạng video, chẳng hạn như quảng cáo dạng video phát trong nội dung truyền trực tuyến trên trình phát video.
AD_TYPE_AUDIO Mẫu quảng cáo dạng âm thanh, ví dụ: quảng cáo dạng âm thanh phát trong nội dung âm thanh.

ContentOutstreamPositionAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo vị trí ngoài luồng phát của nội dung đã chỉ định. Thuộc tính này sẽ được điền vào trường contentOutstreamPositionDetails khi targetingTypeTARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Biểu diễn dưới dạng JSON
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Trường
contentOutstreamPosition

enum (ContentOutstreamPosition)

Bắt buộc. Vị trí nội dung ngoài luồng phát.

adType

enum (AdType)

Chỉ có đầu ra. Loại quảng cáo cần nhắm mục tiêu. Chỉ áp dụng cho tiêu chí nhắm mục tiêu theo đơn đặt hàng quảng cáo và các mục hàng mới hỗ trợ loại quảng cáo đã chỉ định sẽ kế thừa lựa chọn nhắm mục tiêu này theo mặc định. Các giá trị có thể là:

  • AD_TYPE_DISPLAY, chế độ cài đặt này sẽ được mục hàng mới kế thừa khi lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, chế độ cài đặt này sẽ được mục hàng mới kế thừa khi lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Chi tiết nhắm mục tiêu cho loại thiết bị. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_DEVICE_TYPE.

Biểu diễn dưới dạng JSON
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
Trường
deviceType

enum (DeviceType)

Bắt buộc. Tên hiển thị của loại thiết bị.

youtubeAndPartnersBidMultiplier

number

Chỉ có đầu ra. Hệ số giá thầu cho phép bạn hiển thị quảng cáo của mình thường xuyên hơn hoặc ít thường xuyên hơn dựa trên loại thiết bị. Giá thầu này sẽ áp dụng hệ số cho giá thầu ban đầu. Khi trường này bằng 0, trường này cho biết trường này không áp dụng được thay vì nhân 0 với giá thầu ban đầu.

Ví dụ: nếu giá giá thầu không có hệ số là 10 đô la và hệ số là 1, 5 cho Máy tính bảng, thì giá giá thầu kết quả cho Máy tính bảng sẽ là 15 đô la.

Chỉ áp dụng cho các mục hàng YouTube và Đối tác.

AudienceGroupAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo nhóm đối tượng được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_AUDIENCE_GROUP. Mối quan hệ giữa mỗi nhóm là UNION, ngoại trừ RemoveFirstAndSecondPartyAudienceGroup và Loại trừGoogleAudienceGroup, trong đó CompLEMENT được sử dụng như một phí của các nhóm khác.

Biểu diễn dưới dạng JSON
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
Trường
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

Mã đối tượng bên thứ nhất và bên thứ ba của các nhóm đối tượng bên thứ nhất và bên thứ ba được đưa vào. Mỗi nhóm đối tượng bên thứ nhất và bên thứ ba chỉ chứa mã đối tượng của bên thứ nhất và bên thứ ba. Mối quan hệ giữa mỗi nhóm đối tượng bên thứ nhất và bên thứ ba là Quảng cáo đi kèm kết quả tìm kiếm và kết quả là Liên kết với các nhóm đối tượng khác. Những nhóm lặp lại có cùng chế độ cài đặt sẽ bị bỏ qua.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Mã đối tượng Google của nhóm đối tượng Google được đưa vào. Chỉ chứa mã đối tượng của Google.

includedCustomListGroup

object (CustomListGroup)

Mã danh sách tuỳ chỉnh của nhóm danh sách tuỳ chỉnh đã đưa vào. Chỉ chứa mã danh sách tuỳ chỉnh.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Các mã đối tượng kết hợp của nhóm đối tượng kết hợp được đưa vào. Chỉ chứa mã đối tượng kết hợp.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Mã đối tượng bên thứ nhất và bên thứ ba của nhóm đối tượng bên thứ nhất và bên thứ ba bị loại trừ. Dùng để nhắm mục tiêu phủ định. Tính năng BỔ SUNG LIÊN KẾT của nhóm này và các nhóm đối tượng bị loại trừ khác được dùng làm điểm dừng cho mọi tiêu chí nhắm mục tiêu khẳng định theo đối tượng. Tất cả các mục đều được coi là "OR" với nhau theo logic.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Mã đối tượng Google của nhóm đối tượng Google bị loại trừ. Dùng để nhắm mục tiêu phủ định. Tính năng BỔ SUNG LIÊN KẾT của nhóm này và các nhóm đối tượng bị loại trừ khác được dùng làm điểm dừng cho mọi tiêu chí nhắm mục tiêu khẳng định theo đối tượng. Chỉ chứa các đối tượng của Google thuộc loại Đối tượng chung sở thích, Đối tượng đang cân nhắc mua hàng và Loại ứng dụng đã cài đặt. Tất cả các mục đều được coi là "OR" với nhau theo logic.

FirstAndThirdPartyAudienceGroup

Thông tin chi tiết về nhóm đối tượng bên thứ nhất và bên thứ ba. Tất cả chế độ cài đặt nhắm mục tiêu theo đối tượng của bên thứ nhất và bên thứ ba đều theo logic "HOẶC".

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
Trường
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

Bắt buộc. Tất cả chế độ cài đặt nhắm mục tiêu theo đối tượng của bên thứ nhất và bên thứ ba trong nhóm đối tượng của bên thứ nhất và bên thứ ba. Không cho phép các tùy chọn cài đặt lặp lại có cùng mã nhận dạng.

FirstAndThirdPartyAudienceTargetingSetting

Thông tin chi tiết về chế độ cài đặt nhắm mục tiêu theo đối tượng của bên thứ nhất và bên thứ ba.

Biểu diễn dưới dạng JSON
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
Trường
firstAndThirdPartyAudienceId

string (int64 format)

Bắt buộc. Mã đối tượng của bên thứ nhất và bên thứ ba của chế độ cài đặt nhắm mục tiêu theo đối tượng của bên thứ nhất và bên thứ ba. Mã này là firstAndThirdPartyAudienceId.

recency

enum (Recency)

Thời gian gần đây của chế độ cài đặt nhắm mục tiêu theo đối tượng của bên thứ nhất và bên thứ ba. Chỉ áp dụng cho đối tượng bên thứ nhất, nếu không sẽ bị bỏ qua. Để biết thêm thông tin, hãy tham khảo https://support.google.com/displayvideo/answer/2949947#recency Khi không chỉ định thì sẽ không áp dụng giới hạn số ngày gần đây.

Gần đây nhất

Tất cả giá trị lần truy cập gần đây của đối tượng bên thứ nhất và bên thứ ba được hỗ trợ.

Enum
RECENCY_NO_LIMIT Không có giới hạn về số ngày gần đây.
RECENCY_1_MINUTE Số ngày gần đây là 1 phút.
RECENCY_5_MINUTES Lần cập nhật gần đây là 5 phút.
RECENCY_10_MINUTES Lần cập nhật gần đây là 10 phút.
RECENCY_15_MINUTES Lần cập nhật gần đây là 15 phút.
RECENCY_30_MINUTES Lần cập nhật gần đây là 30 phút.
RECENCY_1_HOUR Lần cập nhật gần đây là 1 giờ.
RECENCY_2_HOURS Số ngày gần đây là 2 giờ.
RECENCY_3_HOURS Số ngày gần đây là 3 giờ.
RECENCY_6_HOURS Số ngày gần đây là 6 giờ.
RECENCY_12_HOURS Số ngày gần đây là 12 giờ.
RECENCY_1_DAY Số ngày gần đây là 1 ngày.
RECENCY_2_DAYS Số ngày gần đây là 2 ngày.
RECENCY_3_DAYS Số ngày gần đây là 3 ngày.
RECENCY_5_DAYS Lần cập nhật gần đây là 5 ngày.
RECENCY_7_DAYS Số ngày gần đây là 7 ngày.
RECENCY_10_DAYS Số ngày gần đây là 10 ngày.
RECENCY_14_DAYS Số ngày gần đây là 14 ngày.
RECENCY_15_DAYS Lần cập nhật gần đây là 15 ngày.
RECENCY_21_DAYS Số ngày gần đây là 21 ngày.
RECENCY_28_DAYS Lần cập nhật gần đây là 28 ngày.
RECENCY_30_DAYS Số ngày gần đây là 30 ngày.
RECENCY_40_DAYS Số ngày gần đây là 40 ngày.
RECENCY_45_DAYS Số ngày gần đây là 45 ngày.
RECENCY_60_DAYS Số ngày gần đây là 60 ngày.
RECENCY_90_DAYS Số ngày gần đây là 90 ngày.
RECENCY_120_DAYS Số ngày gần đây là 120 ngày.
RECENCY_180_DAYS Số ngày gần đây là 180 ngày.
RECENCY_270_DAYS Số ngày gần đây là 270 ngày.
RECENCY_365_DAYS Số ngày gần đây là 365 ngày.

GoogleAudienceGroup

Thông tin chi tiết về nhóm đối tượng trên Google. Tất cả chế độ cài đặt nhắm mục tiêu theo đối tượng của Google đều là cụm từ "HOẶC" lẫn nhau theo logic.

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Trường
settings[]

object (GoogleAudienceTargetingSetting)

Bắt buộc. Tất cả chế độ cài đặt nhắm mục tiêu theo đối tượng của Google trong nhóm đối tượng của Google. Những chế độ cài đặt lặp lại có cùng mã nhận dạng sẽ bị bỏ qua.

GoogleAudienceTargetingSetting

Thông tin chi tiết về chế độ cài đặt nhắm mục tiêu theo đối tượng của Google.

Biểu diễn dưới dạng JSON
{
  "googleAudienceId": string
}
Trường
googleAudienceId

string (int64 format)

Bắt buộc. Mã đối tượng Google của chế độ cài đặt nhắm mục tiêu theo đối tượng của Google. Mã này là googleAudienceId.

CustomListGroup

Thông tin chi tiết về nhóm danh sách tuỳ chỉnh. Tất cả các chế độ cài đặt nhắm mục tiêu cho danh sách tuỳ chỉnh đều là cụm từ "HOẶC" lẫn nhau theo logic.

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Trường
settings[]

object (CustomListTargetingSetting)

Bắt buộc. Tất cả chế độ cài đặt nhắm mục tiêu danh sách tuỳ chỉnh trong nhóm danh sách tuỳ chỉnh. Những chế độ cài đặt lặp lại có cùng mã nhận dạng sẽ bị bỏ qua.

CustomListTargetingSetting

Thông tin chi tiết về chế độ cài đặt tiêu chí nhắm mục tiêu theo danh sách tuỳ chỉnh.

Biểu diễn dưới dạng JSON
{
  "customListId": string
}
Trường
customListId

string (int64 format)

Bắt buộc. Mã tuỳ chỉnh của chế độ cài đặt tiêu chí nhắm mục tiêu theo danh sách tuỳ chỉnh. Mã này là customListId.

CombinedAudienceGroup

Thông tin chi tiết về nhóm đối tượng kết hợp. Tất cả chế độ cài đặt nhắm mục tiêu theo đối tượng kết hợp đều có logic "HOẶC" với nhau.

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Trường
settings[]

object (CombinedAudienceTargetingSetting)

Bắt buộc. Tất cả chế độ cài đặt nhắm mục tiêu theo đối tượng kết hợp trong nhóm đối tượng kết hợp. Những chế độ cài đặt lặp lại có cùng mã nhận dạng sẽ bị bỏ qua. Số lượng chế độ cài đặt đối tượng kết hợp không được nhiều hơn 5. Nếu không, hệ thống sẽ báo lỗi.

CombinedAudienceTargetingSetting

Thông tin chi tiết về chế độ cài đặt nhắm mục tiêu theo đối tượng kết hợp.

Biểu diễn dưới dạng JSON
{
  "combinedAudienceId": string
}
Trường
combinedAudienceId

string (int64 format)

Bắt buộc. Mã đối tượng kết hợp của chế độ cài đặt tiêu chí nhắm mục tiêu theo đối tượng kết hợp. Mã này là combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo trình duyệt được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_BROWSER.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của trình duyệt.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_BROWSER.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không. Tất cả tùy chọn nhắm mục tiêu theo trình duyệt được chỉ định trên cùng một tài nguyên phải có cùng giá trị cho trường này.

HouseholdIncomeAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo thu nhập hộ gia đình được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME.

Biểu diễn dưới dạng JSON
{
  "householdIncome": enum (HouseholdIncome)
}
Trường
householdIncome

enum (HouseholdIncome)

Bắt buộc. Thu nhập hộ gia đình của đối tượng.

OnScreenPositionAssignedTargetingOptionDetails

Chi tiết về lựa chọn nhắm mục tiêu theo vị trí trên màn hình. Thuộc tính này sẽ được điền vào trường onScreenPositionDetails khi targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
Trường
targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Chỉ có đầu ra. Vị trí trên màn hình.

adType

enum (AdType)

Chỉ có đầu ra. Loại quảng cáo cần nhắm mục tiêu. Chỉ áp dụng cho tiêu chí nhắm mục tiêu theo đơn đặt hàng quảng cáo và các mục hàng mới hỗ trợ loại quảng cáo đã chỉ định sẽ kế thừa lựa chọn nhắm mục tiêu này theo mặc định. Các giá trị có thể là:

  • AD_TYPE_DISPLAY, chế độ cài đặt này sẽ được mục hàng mới kế thừa khi lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, chế độ cài đặt này sẽ được mục hàng mới kế thừa khi lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Thông tin chi tiết về nhà mạng được chỉ định và tuỳ chọn nhắm mục tiêu theo ISP. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_CARRIER_AND_ISP.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của nhà mạng hoặc ISP.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không. Tất cả các tùy chọn nhắm mục tiêu ISP và nhà cung cấp dịch vụ được chỉ định trên cùng một tài nguyên phải có cùng giá trị cho trường này.

KeywordAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo từ khoá được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_KEYWORD.

Biểu diễn dưới dạng JSON
{
  "keyword": string,
  "negative": boolean
}
Trường
keyword

string

Bắt buộc. Từ khoá, ví dụ: car insurance.

Từ khóa khẳng định không được là từ gây phản cảm. Phải được mã hoá UTF-8 với kích thước tối đa là 255 byte. Số ký tự tối đa là 80. Số từ tối đa là 10.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

NegativeKeywordListAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu cho danh sách từ khoá phủ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Biểu diễn dưới dạng JSON
{
  "negativeKeywordListId": string
}
Trường
negativeKeywordListId

string (int64 format)

Bắt buộc. Mã của danh sách từ khoá phủ định. Phải tham chiếu đến trường negativeKeywordListId của tài nguyên NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo hệ điều hành đã chỉ định. Thuộc tính này sẽ được điền vào trường operatingSystemDetails khi targetingTypeTARGETING_TYPE_OPERATING_SYSTEM.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của hệ điều hành.

targetingOptionId

string

Bắt buộc. Mã lựa chọn nhắm mục tiêu được điền vào trường targetingOptionId khi targetingTypeTARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

DeviceMakeModelAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo kiểu thiết bị và kiểu thiết bị đã chỉ định. Thuộc tính này sẽ được điền vào trường deviceMakeModelDetails khi targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của nhà sản xuất và mẫu thiết bị.

targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

EnvironmentAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo môi trường đã chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_ENVIRONMENT.

Biểu diễn dưới dạng JSON
{
  "environment": enum (Environment)
}
Trường
environment

enum (Environment)

Bắt buộc. Môi trường phân phát.

InventorySourceAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu cho nguồn khoảng không quảng cáo. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_INVENTORY_SOURCE.

Biểu diễn dưới dạng JSON
{
  "inventorySourceId": string
}
Trường
inventorySourceId

string (int64 format)

Bắt buộc. Mã của nguồn khoảng không quảng cáo. Phải tham chiếu đến trường inventorySourceId của tài nguyên InventorySource.

CategoryAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo danh mục được chỉ định. Thuộc tính này sẽ được điền vào trường categoryDetails khi targetingTypeTARGETING_TYPE_CATEGORY.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của danh mục.

targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_CATEGORY.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

ViewabilityAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo khả năng xem đã chỉ định. Thông tin này sẽ được điền sẵn vào trường viewabilityDetails của AssignmentOption khi targetingTypeTARGETING_TYPE_VIEWABILITY.

Biểu diễn dưới dạng JSON
{
  "viewability": enum (Viewability)
}
Trường
viewability

enum (Viewability)

Bắt buộc. Tỷ lệ phần trăm khả năng xem dự đoán.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Đại diện cho trạng thái người bán được uỷ quyền được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Nếu tài nguyên không được chỉ định tùy chọn nhắm mục tiêu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, tài nguyên đó đang sử dụng tùy chọn "Người bán và đại lý trực tiếp được ủy quyền".

Biểu diễn dưới dạng JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
Trường
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Chỉ có đầu ra. Trạng thái người bán được uỷ quyền để nhắm mục tiêu.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo ngôn ngữ được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_LANGUAGE.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của ngôn ngữ (ví dụ: "tiếng Pháp").

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_LANGUAGE.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không. Tất cả lựa chọn nhắm mục tiêu theo ngôn ngữ được chỉ định trên cùng một tài nguyên phải có cùng giá trị cho trường này.

GeoRegionAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo vùng địa lý đã chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_GEO_REGION.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của khu vực địa lý (ví dụ: "Ontario, Canada").

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

Chỉ có đầu ra. Loại nhắm mục tiêu theo vùng địa lý.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

InventorySourceGroupAssignedTargetingOptionDetails

Thông tin nhắm mục tiêu cho nhóm nguồn khoảng không quảng cáo. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP.

Biểu diễn dưới dạng JSON
{
  "inventorySourceGroupId": string
}
Trường
inventorySourceGroupId

string (int64 format)

Bắt buộc. Mã của nhóm nguồn khoảng không quảng cáo. Phải tham chiếu đến trường inventorySourceGroupId của tài nguyên InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Chi tiết nhắm mục tiêu cho nhãn nội dung kỹ thuật số. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Biểu diễn dưới dạng JSON
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
Trường
excludedContentRatingTier

enum (ContentRatingTier)

Bắt buộc. Tên hiển thị của cấp phân loại nhãn nội dung kỹ thuật số cần được LOẠI TRỪ.

SensitiveCategoryAssignedTargetingOptionDetails

Chi tiết nhắm mục tiêu cho danh mục nhạy cảm. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Biểu diễn dưới dạng JSON
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
Trường
excludedSensitiveCategory

enum (SensitiveCategory)

Bắt buộc. Danh sách cho nội dung danh mục nhạy cảm của DV360 được phân loại là LOẠI TRỪ.

ExchangeAssignedTargetingOptionDetails

Chi tiết về tùy chọn nhắm mục tiêu trao đổi được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_EXCHANGE.

Biểu diễn dưới dạng JSON
{
  "exchange": enum (Exchange)
}
Trường
exchange

enum (Exchange)

Bắt buộc. Giá trị enum của sàn giao dịch.

SubExchangeAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu giao dịch phụ được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_SUB_EXCHANGE.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string
}
Trường
targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Chi tiết về lựa chọn nhắm mục tiêu của trình xác minh bên thứ ba đã chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_THIRD_PARTY_VERIFIER.

Biểu diễn dưới dạng JSON
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Trường
Trường hợp verifier. Có thể nhắm đến một trong các nhà xác minh bên thứ ba để áp dụng ngưỡng an toàn thương hiệu cho các lượt hiển thị. verifier chỉ có thể là một trong những trạng thái sau:
adloox

object (Adloox)

Trình xác minh thương hiệu của bên thứ ba -- Adloox.

doubleVerify

object (DoubleVerify)

Người xác minh thương hiệu của bên thứ ba -- DoubleVerify.

integralAdScience

object (IntegralAdScience)

Người xác minh thương hiệu của bên thứ ba -- Integral Ad Science.

Adloox

Thông tin chi tiết về chế độ cài đặt Adloox.

Biểu diễn dưới dạng JSON
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
Trường
excludedAdlooxCategories[]

enum (AdlooxCategory)

Chế độ cài đặt an toàn thương hiệu của Adloox.

AdlooxCategory

Các lựa chọn có thể dùng cho Adloox.

Enum
ADLOOX_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định tuỳ chọn Adloox.
ADULT_CONTENT_HARD Nội dung người lớn (khó).
ADULT_CONTENT_SOFT Nội dung người lớn (giá mềm).
ILLEGAL_CONTENT Nội dung bất hợp pháp.
BORDERLINE_CONTENT Nội dung gần ranh giới vi phạm chính sách.
DISCRIMINATORY_CONTENT Nội dung phân biệt đối xử.
VIOLENT_CONTENT_WEAPONS Nội dung và vũ khí bạo lực.
LOW_VIEWABILITY_DOMAINS Miền có khả năng xem thấp.
FRAUD Gian lận.

DoubleVerify

Thông tin chi tiết về chế độ cài đặt của DoubleVerify.

Biểu diễn dưới dạng JSON
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Trường
brandSafetyCategories

object (BrandSafetyCategories)

Các chế độ kiểm soát an toàn đối với thương hiệu DV.

avoidedAgeRatings[]

enum (AgeRating)

Tránh đặt giá thầu trên các ứng dụng có xếp hạng độ tuổi.

appStarRating

object (AppStarRating)

Tránh đặt giá thầu trên các ứng dụng có xếp hạng theo sao.

displayViewability

object (DisplayViewability)

Chế độ cài đặt khả năng xem trên Mạng Hiển thị (chỉ áp dụng cho mục hàng hiển thị).

videoViewability

object (VideoViewability)

Chế độ cài đặt khả năng xem video (chỉ áp dụng cho mục hàng video).

fraudInvalidTraffic

object (FraudInvalidTraffic)

Tránh các trang web và ứng dụng có tỷ lệ gian lận và IVT trước đây.

customSegmentId

string (int64 format)

Mã phân khúc tuỳ chỉnh do DoubleVerify cung cấp. Mã nhận dạng phải bắt đầu bằng "51" và bao gồm 8 chữ số. Bạn không thể chỉ định mã phân khúc tùy chỉnh cùng với bất kỳ trường nào sau đây:

BrandSafetyCategories

Chế độ cài đặt cho các biện pháp kiểm soát an toàn thương hiệu.

Biểu diễn dưới dạng JSON
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Trường
avoidUnknownBrandSafetyCategory

boolean

Không xác định hoặc không thể định giá.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Các danh mục cách tránh mức độ nghiêm trọng cao cho sự an toàn đối với thương hiệu.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Các danh mục tránh trường hợp an toàn thương hiệu có mức độ nghiêm trọng trung bình.

HighSeverityCategory

Các lựa chọn có thể áp dụng cho các danh mục mức độ nghiêm trọng cao.

Enum
HIGHER_SEVERITY_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định danh mục mức độ nghiêm trọng cao nào.
ADULT_CONTENT_PORNOGRAPHY Nội dung người lớn: Nội dung khiêu dâm, Chủ đề dành cho người trưởng thành và ảnh khoả thân.
COPYRIGHT_INFRINGEMENT Vi phạm bản quyền.
SUBSTANCE_ABUSE Thuốc/Rượu/Chất bị kiểm soát: Lạm dụng chất gây nghiện.
GRAPHIC_VIOLENCE_WEAPONS Bạo lực/vũ khí phản cảm quá mức/phản cảm.
HATE_PROFANITY Nội dung gây hận thù/Ngôn từ thô tục.
CRIMINAL_SKILLS Hoạt động bất hợp pháp: Kỹ năng phạm tội.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Nội dung có phần thưởng/Phần mềm độc hại/Xáo trộn.

MediumSeverityCategory

Các lựa chọn có thể áp dụng cho danh mục mức độ nghiêm trọng trung bình.

Enum
MEDIUM_SEVERITY_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định danh mục mức độ nghiêm trọng trung bình nào.
AD_SERVERS Máy chủ quảng cáo.
ADULT_CONTENT_SWIMSUIT Nội dung người lớn: Bộ đồ bơi.
ALTERNATIVE_LIFESTYLES Các chủ đề gây tranh cãi: Lối sống thay thế.
CELEBRITY_GOSSIP Chủ đề gây tranh cãi: Chuyện phiếm về người nổi tiếng.
GAMBLING Chủ đề gây tranh cãi: Cờ bạc.
OCCULT Chủ đề gây tranh cãi: Huyền bí.
SEX_EDUCATION Các chủ đề gây tranh cãi: Giáo dục giới tính.
DISASTER_AVIATION Thảm hoạ: Hàng không.
DISASTER_MAN_MADE Thảm hoạ: Do con người.
DISASTER_NATURAL Thảm hoạ: Tự nhiên.
DISASTER_TERRORIST_EVENTS Thảm hoạ: Sự kiện khủng bố.
DISASTER_VEHICLE Thảm hoạ: Phương tiện di chuyển.
ALCOHOL Thuốc/Đồ uống có cồn/Chất thuộc diện quản lý: Rượu.
SMOKING Thuốc/Đồ uống có cồn/Chất thuộc diện quản lý: Hút thuốc.
NEGATIVE_NEWS_FINANCIAL Tin tức tiêu cực: Tài chính.
NON_ENGLISH Nội dung không phải tiếng Anh: Không phải tiếng Anh.
PARKING_PAGE Nội dung không phải SD: Trang đỗ xe.
UNMODERATED_UGC UGC chưa được kiểm duyệt: Diễn đàn, hình ảnh và video.
INFLAMMATORY_POLITICS_AND_NEWS Chủ đề gây tranh cãi: Tin tức và chính trị mang tính kích động.
NEGATIVE_NEWS_PHARMACEUTICAL Tin tức tiêu cực: Dược phẩm.

AgeRating

Các tuỳ chọn có thể cho xếp hạng độ tuổi.

Enum
AGE_RATING_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn phân loại độ tuổi nào.
APP_AGE_RATE_UNKNOWN Ứng dụng có mức phân loại độ tuổi không xác định.
APP_AGE_RATE_4_PLUS Ứng dụng được xếp hạng cho Mọi người (4+).
APP_AGE_RATE_9_PLUS Ứng dụng được xếp hạng cho Mọi người (9+).
APP_AGE_RATE_12_PLUS Các ứng dụng được phân loại dành cho thanh thiếu niên (12 tuổi trở lên).
APP_AGE_RATE_17_PLUS Ứng dụng được phân loại là Người trưởng thành (17 trở lên).
APP_AGE_RATE_18_PLUS Ứng dụng được phân loại là Chỉ người lớn (18 trở lên).

AppStarRating

Thông tin chi tiết về chế độ cài đặt điểm xếp hạng theo sao của DoubleVerify.

Biểu diễn dưới dạng JSON
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Trường
avoidedStarRating

enum (StarRating)

Tránh đặt giá thầu trên các ứng dụng có xếp hạng theo sao.

avoidInsufficientStarRating

boolean

Tránh đặt giá thầu trên các ứng dụng không có đủ điểm xếp hạng theo sao.

StarRating

Các tuỳ chọn có thể cho xếp hạng theo sao.

Enum
APP_STAR_RATE_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định tuỳ chọn xếp hạng theo sao của ứng dụng.
APP_STAR_RATE_1_POINT_5_LESS Ứng dụng chính thức có điểm xếp hạng < 1,5 sao.
APP_STAR_RATE_2_LESS Ứng dụng chính thức có điểm xếp hạng < 2 sao.
APP_STAR_RATE_2_POINT_5_LESS Ứng dụng chính thức có điểm xếp hạng < 2,5 sao.
APP_STAR_RATE_3_LESS Ứng dụng chính thức có điểm xếp hạng < 3 sao.
APP_STAR_RATE_3_POINT_5_LESS Ứng dụng chính thức có điểm xếp hạng < 3,5 sao.
APP_STAR_RATE_4_LESS Ứng dụng chính thức có điểm xếp hạng < 4 sao.
APP_STAR_RATE_4_POINT_5_LESS Ứng dụng chính thức có điểm xếp hạng < 4,5 sao.

DisplayViewability

Thông tin chi tiết về chế độ cài đặt khả năng xem trên quảng cáo hiển thị của DoubleVerify.

Biểu diễn dưới dạng JSON
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Trường
iab

enum (IAB)

Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem được IAB.

viewableDuring

enum (ViewableDuring)

Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa 100% thời lượng có thể xem.

IAB (Cục Quảng cáo tương tác)

Các tùy chọn có thể cho tỷ lệ xem được IAB.

Enum
IAB_VIEWED_RATE_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ lựa chọn giá đã xem nào theo IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 80% trở lên theo IAB.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 75% trở lên theo IAB.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 70% trở lên theo IAB.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ xem IAB tối đa 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ xem IAB tối đa 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 55% trở lên theo IAB.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ có thể xem theo IAB từ 50% trở lên.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ có thể xem của IAB từ 40% trở lên.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ xem IAB từ 30% trở lên.

ViewableDuring

Các tuỳ chọn có thể cho thời lượng xem được.

Enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn thời lượng xem trung bình nào.
AVERAGE_VIEW_DURATION_5_SEC Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa 100% thời lượng có thể xem từ 5 giây trở lên.
AVERAGE_VIEW_DURATION_10_SEC Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa 100% thời lượng có thể xem từ 10 giây trở lên.
AVERAGE_VIEW_DURATION_15_SEC Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa 100% thời lượng có thể xem từ 15 giây trở lên.

VideoViewability

Thông tin chi tiết về chế độ cài đặt khả năng xem video của DoubleVerify.

Biểu diễn dưới dạng JSON
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Trường
videoIab

enum (VideoIAB)

Nhắm mục tiêu khoảng không quảng cáo trên web để tối đa hóa tỷ lệ xem được theo IAB.

videoViewableRate

enum (VideoViewableRate)

Nhắm đến khoảng không quảng cáo trên web để tối đa hoá tỷ lệ xem toàn bộ.

playerImpressionRate

enum (PlayerImpressionRate)

Nhắm đến khoảng không quảng cáo để tối đa hoá số lượt hiển thị có kích thước trình phát từ 400 x 300 trở lên.

VideoIAB

Các tùy chọn tỷ lệ xem được có thể của IAB.

Enum
VIDEO_IAB_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn tỷ lệ có thể xem theo IAB dành cho video.
IAB_VIEWABILITY_80_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 80% trở lên theo IAB.
IAB_VIEWABILITY_75_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 75% trở lên theo IAB.
IAB_VIEWABILITY_70_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 70% trở lên theo IAB.
IAB_VIEWABILITY_65_PERCENT_HIHGER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ xem IAB tối đa 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ xem IAB tối đa 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ xem từ 55% trở lên theo IAB.
IAB_VIEWABILITY_50_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ có thể xem theo IAB từ 50% trở lên.
IAB_VIEWABILITY_40_PERCENT_HIHGER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tối đa hóa tỷ lệ có thể xem của IAB từ 40% trở lên.
IAB_VIEWABILITY_30_PERCENT_HIHGER Nhắm mục tiêu khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ xem IAB từ 30% trở lên.

VideoViewableRate

Các lựa chọn có thể cho tỷ lệ xem được đầy đủ.

Enum
VIDEO_VIEWABLE_RATE_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn tỷ lệ xem video nào.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ từ 40% trở lên.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ từ 35% trở lên.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ từ 30% trở lên.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ từ 25% trở lên.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ từ 20% trở lên.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ từ 10% trở lên.

PlayerImpressionRate

Các tuỳ chọn lượt hiển thị có thể có.

Enum
PLAYER_SIZE_400X300_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn lượt hiển thị nào.
PLAYER_SIZE_400X300_95 Trang web có hơn 95%số lượt hiển thị.
PLAYER_SIZE_400X300_70 Trang web có hơn 70%số lượt hiển thị.
PLAYER_SIZE_400X300_25 Trang web có hơn 25%số lượt hiển thị.
PLAYER_SIZE_400X300_5 Trang web có hơn 5%số lượt hiển thị.

FraudInvalidTraffic

Chế độ cài đặt về hành vi gian lận và lưu lượng truy cập không hợp lệ của DoubleVerify.

Biểu diễn dưới dạng JSON
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Trường
avoidedFraudOption

enum (FraudOption)

Tránh các trang web và ứng dụng có hành vi gian lận và lưu lượng truy cập không hợp lệ trong quá khứ.

avoidInsufficientOption

boolean

Không đủ số liệu thống kê về gian lận và IVT trước đây.

FraudOption

Các lựa chọn có thể xảy ra liên quan đến tỷ lệ Gian lận và tỷ lệ lưu lượng truy cập không hợp lệ trước đây.

Enum
FRAUD_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ lựa chọn lưu lượng truy cập gian lận và không hợp lệ nào.
AD_IMPRESSION_FRAUD_100 100% hành vi gian lận và lưu lượng truy cập không hợp lệ.
AD_IMPRESSION_FRAUD_50 50% mức độ gian lận và lưu lượng truy cập không hợp lệ cao hơn.
AD_IMPRESSION_FRAUD_25 Gian lận và lưu lượng truy cập không hợp lệ từ 25% trở lên.
AD_IMPRESSION_FRAUD_10 10% hành vi lừa đảo và lưu lượng truy cập không hợp lệ trở lên.
AD_IMPRESSION_FRAUD_8 Mức độ gian lận và lưu lượng truy cập không hợp lệ từ 8% trở lên.
AD_IMPRESSION_FRAUD_6 Gian lận và lưu lượng truy cập không hợp lệ từ 6% trở lên.
AD_IMPRESSION_FRAUD_4 Mức độ gian lận và lưu lượng truy cập không hợp lệ từ 4% trở lên.
AD_IMPRESSION_FRAUD_2 Gian lận và lưu lượng truy cập không hợp lệ từ 2% trở lên.

IntegralAdScience

Thông tin chi tiết về chế độ cài đặt Integral Ad Science.

Biểu diễn dưới dạng JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
Trường
traqScoreOption

enum (TRAQScore)

Chất lượng quảng cáo thực sự (chỉ áp dụng cho mục hàng Hiển thị).

excludeUnrateable

boolean

Sự an toàn đối với thương hiệu – Không thể xếp hạng.

excludedAdultRisk

enum (Adult)

An toàn thương hiệu – Nội dung người lớn.

excludedAlcoholRisk

enum (Alcohol)

An toàn thương hiệu – Đồ uống có cồn.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

An toàn thương hiệu – Tải xuống bất hợp pháp.

excludedDrugsRisk

enum (Drugs)

An toàn thương hiệu - Thuốc.

excludedHateSpeechRisk

enum (HateSpeech)

Sự an toàn của thương hiệu – Lời nói hận thù.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

An toàn thương hiệu – Ngôn từ phản cảm.

excludedViolenceRisk

enum (Violence)

An toàn thương hiệu – Bạo lực.

excludedGamblingRisk

enum (Gambling)

An toàn thương hiệu – Cờ bạc.

excludedAdFraudRisk

enum (AdFraudPrevention)

Chế độ cài đặt về Gian lận trong quảng cáo.

displayViewability

enum (DisplayViewability)

Phần Khả năng xem hiển thị (chỉ áp dụng cho mục hàng hiển thị).

videoViewability

enum (VideoViewability)

Phần Khả năng xem video (chỉ áp dụng cho mục hàng video).

customSegmentId[]

string (int64 format)

Mã phân khúc tùy chỉnh do Integral Ad Science cung cấp. Mã nhận dạng phải nằm trong khoảng từ 1000001 đến 1999999.

TRAQScore

Phạm vi điểm của Integral Ad Science TRAQ (chất lượng quảng cáo thực sự).

Enum
TRAQ_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ điểm chất lượng quảng cáo thực sự nào.
TRAQ_250 Điểm TRAQ 250-1000.
TRAQ_500 Điểm TRAQ 500-1000.
TRAQ_600 Điểm TRAQ 600-1000.
TRAQ_700 Điểm TRAQ 700-1000.
TRAQ_750 Điểm TRAQ 750-1000.
TRAQ_875 Điểm TRAQ 875-1000.
TRAQ_1000 đạt 1.000 điểm TRAQ.

Người lớn

Các tuỳ chọn có thể có của Integral Ad Science.

Enum
ADULT_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn người lớn nào.
ADULT_HR Người lớn – Loại trừ nhóm có rủi ro cao.
ADULT_HMR Người lớn – Loại trừ nguy cơ cao và trung bình.

Rượu

Các lựa chọn có thể có của Integral Ad Science Rượu.

Enum
ALCOHOL_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ lựa chọn rượu nào.
ALCOHOL_HR Rượu - Loại trừ rủi ro cao.
ALCOHOL_HMR Rượu - Loại trừ rủi ro cao và trung bình.

IllegalDownloads

Các tuỳ chọn tải xuống không hợp lệ có thể có của Integral Ad Science.

Enum
ILLEGAL_DOWNLOADS_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn tải xuống bất hợp pháp nào.
ILLEGAL_DOWNLOADS_HR Tải xuống bất hợp pháp – Loại trừ rủi ro cao.
ILLEGAL_DOWNLOADS_HMR Tải xuống bất hợp pháp – Loại trừ rủi ro cao và trung bình.

Thuốc

Các lựa chọn có thể dùng cho Integral Ad Science.

Enum
DRUGS_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ lựa chọn thuốc nào.
DRUGS_HR Thuốc - Loại trừ nguy cơ cao.
DRUGS_HMR Thuốc – Loại trừ nguy cơ cao và trung bình.

HateSpeech

Tuỳ chọn lời nói hận thù có thể là Integral Ad Science.

Enum
HATE_SPEECH_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn lời nói hận thù nào.
HATE_SPEECH_HR Lời nói hận thù – Loại trừ nguy cơ cao.
HATE_SPEECH_HMR Lời nói hận thù – Loại trừ rủi ro cao và trung bình.

OffensiveLanguage

Các lựa chọn ngôn ngữ có thể có cho Nội dung phản cảm của Integral Ad Science.

Enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định tuỳ chọn ngôn ngữ nào.
OFFENSIVE_LANGUAGE_HR Ngôn từ gây phản cảm – Loại trừ mức độ rủi ro cao.
OFFENSIVE_LANGUAGE_HMR Ngôn từ gây phản cảm – Loại trừ rủi ro cao và trung bình.

Bạo lực

Các lựa chọn có thể là Bạo lực trong Integral Ad Science.

Enum
VIOLENCE_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn bạo lực nào.
VIOLENCE_HR Bạo lực - Loại trừ rủi ro cao.
VIOLENCE_HMR Bạo lực - Loại trừ rủi ro cao và trung bình.

Cờ bạc

Các tùy chọn cờ bạc có thể có của Integral Ad Science.

Enum
GAMBLING_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ lựa chọn cờ bạc nào.
GAMBLING_HR Cờ bạc - Loại trừ rủi ro cao.
GAMBLING_HMR Cờ bạc - Loại trừ rủi ro cao và trung bình.

AdFraudPrevention

Các phương án ngăn chặn lừa đảo có thể có đối với Integral Ad Science Ad.

Enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ biện pháp ngăn chặn gian lận quảng cáo nào.
SUSPICIOUS_ACTIVITY_HR Gian lận trong quảng cáo – Loại trừ rủi ro cao.
SUSPICIOUS_ACTIVITY_HMR Gian lận trong quảng cáo – Loại trừ rủi ro cao và trung bình.

DisplayViewability

Các tuỳ chọn có thể có về khả năng xem cho chiến dịch Hiển thị Integral Ad Science.

Enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn khả năng xem hiển thị nào.
PERFORMANCE_VIEWABILITY_40 Nhắm mục tiêu khả năng xem 40% trở lên.
PERFORMANCE_VIEWABILITY_50 Nhắm mục tiêu khả năng xem 50% trở lên.
PERFORMANCE_VIEWABILITY_60 Nhắm mục tiêu khả năng xem 60% trở lên.
PERFORMANCE_VIEWABILITY_70 Nhắm mục tiêu khả năng xem 70% trở lên.

VideoViewability

Các lựa chọn có thể có về khả năng xem video của Integral Ad Science.

Enum
VIDEO_VIEWABILITY_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn khả năng xem video nào.
VIDEO_VIEWABILITY_40 40%trở lên (tiêu chuẩn khả năng xem video của IAB).
VIDEO_VIEWABILITY_50 50%trở lên (tiêu chuẩn khả năng xem video của IAB).
VIDEO_VIEWABILITY_60 60%trở lên (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_70 70%lượt xem trở lên (tiêu chuẩn về khả năng xem video của IAB).

PoiAssignedTargetingOptionDetails

Thông tin chi tiết về tiêu chí nhắm mục tiêu theo địa điểm yêu thích đã chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_POI.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của POI, ví dụ: "Times Square", "SpaceSpace", theo sau là địa chỉ đầy đủ của địa điểm đó (nếu có).

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_POI.

Bạn có thể truy xuất mã tuỳ chọn nhắm mục tiêu địa điểm yêu thích được chấp nhận bằng targetingTypes.targetingOptions.search.

Nếu nhắm mục tiêu một toạ độ vĩ độ/kinh độ cụ thể bị xoá khỏi tên địa chỉ hoặc POI, bạn có thể tạo ID tuỳ chọn nhắm mục tiêu cần thiết bằng cách làm tròn các giá trị toạ độ mong muốn đến chữ số thập phân thứ 6, xoá số thập phân và nối các giá trị chuỗi được phân tách bằng dấu chấm phẩy. Ví dụ: bạn có thể nhắm mục tiêu cặp vĩ độ/kinh độ là 40,7414691, -74,003387 bằng cách sử dụng mã tuỳ chọn nhắm mục tiêu là "40741469;-74003387". Sau khi tạo, giá trị trường này sẽ được cập nhật để nối thêm dấu chấm phẩy và giá trị băm dạng chữ và số nếu chỉ có toạ độ vĩ độ/kinh độ được cung cấp.

latitude

number

Chỉ có đầu ra. Vĩ độ của POI làm tròn đến chữ số thập phân thứ 6.

longitude

number

Chỉ có đầu ra. Kinh độ của POI làm tròn đến chữ số thập phân thứ 6.

proximityRadiusAmount

number

Bắt buộc. Bán kính của khu vực xung quanh địa điểm yêu thích sẽ được nhắm mục tiêu. Đơn vị của bán kính được chỉ định bởi proximityRadiusUnit. Giá trị phải là 1 đến 800 nếu đơn vị là DISTANCE_UNIT_KILOMETERS và từ 1 đến 500 nếu đơn vị là DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

Bắt buộc. Đơn vị khoảng cách mà bán kính nhắm mục tiêu được đo.

DistanceUnit

Các lựa chọn có thể có về đơn vị khoảng cách.

Enum
DISTANCE_UNIT_UNSPECIFIED Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này.
DISTANCE_UNIT_MILES Dặm.
DISTANCE_UNIT_KILOMETERS Ki lô mét.

BusinessChainAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo Chuỗi doanh nghiệp được chỉ định. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_BUSINESS_CHAIN.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của một chuỗi doanh nghiệp, ví dụ: "KFC", "Chase Bank".

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc loại TARGETING_TYPE_BUSINESS_CHAIN.

Bạn có thể truy xuất mã lựa chọn nhắm mục tiêu theo chuỗi doanh nghiệp được chấp nhận bằng SearchTargetingOptions.

proximityRadiusAmount

number

Bắt buộc. Bán kính của khu vực xung quanh chuỗi doanh nghiệp sẽ được nhắm mục tiêu. Đơn vị của bán kính được chỉ định bởi proximityRadiusUnit. Giá trị phải là 1 đến 800 nếu đơn vị là DISTANCE_UNIT_KILOMETERS và từ 1 đến 500 nếu đơn vị là DISTANCE_UNIT_MILES. Giá trị gia tăng tối thiểu cho cả hai trường hợp là 0,1. Giá trị nhập vào sẽ được làm tròn thành giá trị gần nhất được chấp nhận nếu quá chi tiết, ví dụ: 15,57 sẽ trở thành 15,6.

proximityRadiusUnit

enum (DistanceUnit)

Bắt buộc. Đơn vị khoảng cách mà bán kính nhắm mục tiêu được đo.

ContentDurationAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu được chỉ định theo thời lượng nội dung. Thuộc tính này sẽ được điền vào trường contentDurationDetails khi targetingTypeTARGETING_TYPE_CONTENT_DURATION. Không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Hãy xoá tất cả lựa chọn nhắm mục tiêu theo thời lượng nội dung để đạt được hiệu ứng này.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
Trường
targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_CONTENT_DURATION.

contentDuration

enum (ContentDuration)

Chỉ có đầu ra. Thời lượng nội dung.

ContentStreamTypeAssignedTargetingOptionDetails

Thông tin chi tiết về loại luồng nội dung được chỉ định tuỳ chọn nhắm mục tiêu. Thuộc tính này sẽ được điền vào trường contentStreamTypeDetails khi targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE. Không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Hãy xoá tất cả những lựa chọn nhắm mục tiêu theo loại luồng nội dung để đạt được hiệu quả này.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
Trường
targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE.

contentStreamType

enum (ContentStreamType)

Chỉ có đầu ra. Loại luồng nội dung.

NativeContentPositionAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo vị trí nội dung gốc. Thuộc tính này sẽ được điền vào trường nativeContentPositionDetails khi targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION. Không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Xóa tất cả tùy chọn nhắm mục tiêu theo vị trí nội dung gốc để đạt được hiệu quả này.

Biểu diễn dưới dạng JSON
{
  "contentPosition": enum (NativeContentPosition)
}
Trường
contentPosition

enum (NativeContentPosition)

Bắt buộc. Vị trí nội dung.

OmidAssignedTargetingOptionDetails

Đại diện cho loại khoảng không quảng cáo có bật tính năng Đo lường mở có thể nhắm mục tiêu. Thông tin này sẽ được điền sẵn vào trường chi tiết của một GánNhắm mục tiêu khi targetingTypeTARGETING_TYPE_OMID.

Biểu diễn dưới dạng JSON
{
  "omid": enum (Omid)
}
Trường
omid

enum (Omid)

Bắt buộc. Loại khoảng không quảng cáo đã bật tính năng Đo lường mở.

AudioContentTypeAssignedTargetingOptionDetails

Thông tin chi tiết về loại nội dung âm thanh được chỉ định tuỳ chọn nhắm mục tiêu. Thuộc tính này sẽ được điền vào trường audioContentTypeDetails khi targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE. Không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Xoá tất cả lựa chọn nhắm mục tiêu theo loại nội dung âm thanh để có được hiệu ứng này.

Biểu diễn dưới dạng JSON
{
  "audioContentType": enum (AudioContentType)
}
Trường
audioContentType

enum (AudioContentType)

Bắt buộc. Loại nội dung âm thanh.

ContentGenreAssignedTargetingOptionDetails

Thông tin chi tiết về thể loại nội dung được chỉ định cho tuỳ chọn nhắm mục tiêu. Thuộc tính này sẽ được điền vào trường contentGenreDetails khi targetingTypeTARGETING_TYPE_CONTENT_GENRE. Không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Hãy xoá tất cả lựa chọn nhắm mục tiêu theo thể loại nội dung để có được hiệu ứng này.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Trường
targetingOptionId

string

Bắt buộc. Trường targetingOptionId khi targetingTypeTARGETING_TYPE_CONTENT_GENRE.

displayName

string

Chỉ có đầu ra. Tên hiển thị của thể loại nội dung.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

YoutubeVideoAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu được chỉ định cho video trên YouTube. Thuộc tính này sẽ được điền vào trường youtubeVideoDetails khi targetingTypeTARGETING_TYPE_YOUTUBE_VIDEO.

Biểu diễn dưới dạng JSON
{
  "videoId": string,
  "negative": boolean
}
Trường
videoId

string

Mã video trên YouTube giống với mã xuất hiện trên trang xem của YouTube.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

YoutubeChannelAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu được chỉ định cho kênh YouTube. Thuộc tính này sẽ được điền vào trường youtubeChannelDetails khi targetingTypeTARGETING_TYPE_YOUTUBE_CHANNEL.

Biểu diễn dưới dạng JSON
{
  "channelId": string,
  "negative": boolean
}
Trường
channelId

string

Mã nhận dạng kênh của người tải lên YouTube hoặc mã kênh của một kênh YouTube.

negative

boolean

Cho biết liệu tùy chọn này có đang được nhắm mục tiêu phủ định hay không.

SessionPositionAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu được chỉ định theo vị trí phiên. Thuộc tính này sẽ được điền vào trường sessionPositionDetails khi targetingTypeTARGETING_TYPE_SESSION_POSITION.

Biểu diễn dưới dạng JSON
{
  "sessionPosition": enum (SessionPosition)
}
Trường
sessionPosition

enum (SessionPosition)

Vị trí mà quảng cáo sẽ xuất hiện trong một phiên hoạt động.

SessionPosition

Các vị trí có thể có trong một phiên hoạt động.

Enum
SESSION_POSITION_UNSPECIFIED Đây là trình giữ chỗ, không cho biết vị trí nào.
SESSION_POSITION_FIRST_IMPRESSION Hiển thị đầu tiên của phiên.

Phương thức

get

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

list

Liệt kê các lựa chọn nhắm mục tiêu được chỉ định cho chiến dịch với một loại nhắm mục tiêu cụ thể.