REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Tài nguyên: AssignmentTargetingOption

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

Biểu diễn dưới dạng JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "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.
}
Trường
name

string

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

assignedTargetingOptionId

string

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

targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

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

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

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

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

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

genderDetails

object (GenderAssignedTargetingOptionDetails)

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

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

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

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

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

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

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

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

Tính kế thừa

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

Enum
INHERITANCE_UNSPECIFIED Cơ chế kế thừa chưa được xác định hoặc không xác định.
NOT_INHERITED Tùy chọn nhắm mục tiêu đã 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 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ừ 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 assignTargetingOption 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 của kênh. Phải tham chiếu đến 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 do nhà quảng cáo sở hữu.

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 tùy 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ề tuỳ chọn 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 một assignTargetingOption 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ề tuỳ chọn nhắm mục tiêu ứ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 assignTargetingOption 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 trên 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, 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 phù hợp từ ID ứng dụng.

Nền tảng ứng dụng

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

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 lựa chọn nền tảng thực.
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à một nền tảng CTV (TV kết nối Internet) không được liệt kê rõ ràng ở nơi khác.

UrlAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ 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 assignTargetingOption 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 thư mục con (ví dụ: www.example.com/one-subdirectory-level/second-level) và 5 cấp nhắm mục tiêu 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

Giá trị đại diện của 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 được biểu thị bằng endHour.

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 để 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ờ cần 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 Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY 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 để giải quyết 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 giải quyết 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

Độ tuổi của đối tượng. Chúng tôi chỉ hỗ trợ nhắm mục tiêu liên tục độ tuổi của một đối tượng. 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) thuộc phạm vi độ tuổi liên tục lớn hơn. Phạm vi tiếp cận của nhắm mục tiêu theo độ tuổi liên tục có thể mở rộng bằng cách đồng thời nhắm mục tiêu đến đối tượng có độ tuổi không xác định.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc kiểu TARGETING_TYPE_AGE_RANGE.

RegionalLocationListAssignedTargetingOptionDetails

Chi tiết nhắm mục tiêu cho danh sách vị trí theo vùng. Thông tin này sẽ được điền sẵn vào trường chi tiết của một assignTargetingOption 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ã của danh sách vị trí theo khu vực. Nên tham chiếu đến trường locationListId của tài nguyên LocationList có loại là 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í vùng 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_PROXIMITY_LOCATION_LIST.

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

string (int64 format)

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

proximityRadiusRange

enum (ProximityRadiusRange)

Bắt buộc. Phạm vi bán kính cho danh sách vị trí lân cận. Điều này thể hiện kích thước của khu vực xung quanh vị trí đã chọn sẽ được nhắm mục tiêu.

All tiêu chí nhắm mục tiêu theo vị trí vùng lân cận trong một tài nguyên phải có cùng giá trị phạm vi bán kính. Đặt giá trị này để khớp với bất kỳ tiêu chí nhắm mục tiêu hiện có nào. Nếu được cập nhật, trường này sẽ thay đổi phạm vi bán kính cho tất cả tiêu chí nhắm mục tiêu vùng lân cận trong tài nguyên.

ProximityRadiusRange

Loại phạm vi bán kính cho các tùy chọn đã chỉ định theo địa lý lân cận. Phạm vi bán kính tương ứng với mật độ dân số. Ví dụ: PROXIMITY_RADIUS_RANGE_SMALL ở khu vực nông thôn sẽ khác với PROXIMITY_RADIUS_RANGE_SMALL ở một thành phố đông dân.

Enum
PROXIMITY_RADIUS_RANGE_UNSPECIFIED Phạm vi bán kính được nhắm mục tiêu chưa được chỉ định hoặc không xác định. Giá trị mặc định khi phạm vi bán kính 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 tuỳ chọn phạm vi bán kính thực.
PROXIMITY_RADIUS_RANGE_SMALL Phạm vi bán kính được nhắm mục tiêu nhỏ.
PROXIMITY_RADIUS_RANGE_MEDIUM Phạm vi bán kính được nhắm mục tiêu là trung bình.
PROXIMITY_RADIUS_RANGE_LARGE Phạm vi bán kính được nhắm mục tiêu lớn.

GenderAssignedTargetingOptionDetails

Thông tin chi tiết về tùy chọn 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_GENDER.

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

enum (Gender)

Giới tính của người xem.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc kiểu TARGETING_TYPE_GENDER.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

string

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

videoPlayerSize

enum (VideoPlayerSize)

Kích thước trình phát video.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

UserRewardedContentAssignedTargetingOptionDetails

Chi tiết về lựa chọn nhắm mục tiêu theo nội dung tặng thưởng của người dùng. Nội dung này sẽ được điền sẵ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 cho quảng cáo dạng video.

ParentalStatusAssignedTargetingOptionDetails

Thông tin chi tiết về tùy chọn nhắm mục tiêu theo tình trạng con cá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 assignTargetingOption khi targetingTypeTARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

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

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc kiểu TARGETING_TYPE_PARENTAL_STATUS.

ContentInstreamPositionAssignedTargetingOptionDetails

Chi tiết về lựa chọn nhắm mục tiêu theo vị trí trong luồng phát cho nội dung được chỉ định. Nội dung này sẽ được điền sẵn vào trường contentInstreamPositionDetails khi targetingTypeTARGETING_TYPE_CONTENT_INSTREAM_POSITION.

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

string

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

contentInstreamPosition

enum (ContentInstreamPosition)

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

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

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 đơ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 tuỳ chọn nhắm mục tiêu này theo mặc định. Các giá trị có thể là:

  • AD_TYPE_VIDEO, mục hàng mới sẽ kế thừa chế độ cài đặt này khi lineItemTypeLINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, mục hàng mới sẽ kế thừa chế độ cài đặt này 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 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 Ví dụ: mẫu quảng cáo hiển thị hình ảnh và HTML5.
AD_TYPE_VIDEO Ví dụ: mẫu quảng cáo dạng video 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 Ví dụ: mẫu quảng cáo dạng âm thanh quảng cáo dạng âm thanh phát trong nội dung âm thanh.

ContentOutstreamPositionAssignedTargetingOptionDetails

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

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

string

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

contentOutstreamPosition

enum (ContentOutstreamPosition)

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

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

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 đơ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 tuỳ chọn nhắm mục tiêu này theo mặc định. Các giá trị có thể là:

  • AD_TYPE_DISPLAY, mục hàng mới sẽ kế thừa chế độ cài đặt này khi lineItemTypeLINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, mục hàng mới sẽ kế thừa chế độ cài đặt này 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_DEVICE_TYPE.

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

string

Bắt buộc. Mã nhận dạng của loại thiết bị.

deviceType

enum (DeviceType)

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

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

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 assignTargetingOption khi targetingTypeTARGETING_TYPE_AUDIENCE_GROUP. Mối quan hệ giữa mỗi nhóm là UNION, ngoại trừ excludedFirstAndThirdPartyAudienceGroup và loại trừGoogleAudienceGroup, trong đó "thực hiện" được dùng làm một xử lý từ đầu đến cuối với 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ùng với các nhóm đối tượng bên thứ nhất và bên thứ ba đã bao gồm. 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à Input, do đó, kết quả là UNION hợp với các nhóm đối tượng khác. Các 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 thêm 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 đã bao gồm. Chỉ chứa mã danh sách tuỳ chỉnh.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Mã đối tượng kết hợp của nhóm đối tượng kết hợp đã bao gồm. 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 và giá trị nhận dạng 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. VIỆC BỔ SUNG THỰC HIỆN 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 LẦN TIÊU CHUẨN cho bất kỳ tiêu chí nhắm mục tiêu theo đối tượng khẳng định nào. Tất cả các mục đều được sắp xếp logic "HOẶC" với nhau.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Mã đối tượng Google của nhóm đối tượng bị loại trừ của Google. Dùng để nhắm mục tiêu phủ định. VIỆC BỔ SUNG THỰC HIỆN 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 LẦN TIÊU CHUẨN cho bất kỳ tiêu chí nhắm mục tiêu theo đối tượng khẳng định nào. Chỉ chứa Đối tượng Google thuộc loại Đối tượng chung sở thích, Đối tượng đang cân nhắc mua hàng và Ứng dụng đã cài đặt. Tất cả các mục đều được sắp xếp logic "HOẶC" với nhau.

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 được sắp xếp theo logic "OR" với nhau.

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 bên thứ nhất và bên thứ ba trong nhóm đối tượng bên thứ nhất và bên thứ ba. Không cho phép các chế độ cài đặt bị 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 trong 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)

Lần cập nhật gần đây của cài đặt nhắm mục tiêu theo đối tượng 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, vui lòng tham khảo https://support.google.com/displayvideo/answer/2949947#recency Khi chưa chỉ định, sẽ không có giới hạn số lần truy cập gần đây được sử dụng.

Lần truy cập gần đây

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

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

GoogleAudienceGroup

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

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. Các chế độ cài đặt lặp lại có cùng mã 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 trong 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ả chế độ cài đặt tiêu chí nhắm mục tiêu theo danh sách tuỳ chỉnh được sắp xếp theo logic "OR" với nhau.

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 tiêu chí nhắm mục tiêu theo danh sách tuỳ chỉnh trong nhóm danh sách tuỳ chỉnh. Các chế độ cài đặt lặp lại có cùng mã 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ả các chế độ cài đặt nhắm mục tiêu theo đối tượng kết hợp đều được sắp xếp theo logic "HOẶC".

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. Các chế độ cài đặt lặp lại có cùng mã sẽ bị bỏ qua. Số lượng chế độ cài đặt đối tượng kết hợp không được vượt quá 5. Nếu không, lỗi sẽ được gử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 được kết hợp của chế độ cài đặt 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 assignTargetingOption 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 kiểu 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ả tuỳ 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 cho tùy chọn nhắm mục tiêu 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

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

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc kiểu TARGETING_TYPE_HOUSEHOLD_INCOME.

OnScreenPositionAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo vị trí trên màn hình. Nội dung này sẽ được điền sẵ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 đơ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 tuỳ chọn nhắm mục tiêu này theo mặc định. Các giá trị có thể là:

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

CarrierAndIspAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo nhà mạng và ISP đượ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 assignTargetingOption 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 kiểu 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ả tuỳ chọn nhắm mục tiêu theo mạng di động và ISP đượ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ề tuỳ chọn 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 assignTargetingOption 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ừ khoá khẳng định không được là từ gây xúc phạ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 assignTargetingOption 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

Chi tiết về lựa chọn nhắm mục tiêu theo hệ điều hành được chỉ định. Nội dung này sẽ được điền sẵ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

Chi tiết về lựa chọn nhắm mục tiêu theo nhãn hiệu và mẫu thiết bị được chỉ định. Nội dung này sẽ được điền sẵ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 kiểu máy và nhãn hiệ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

Chi tiết về lựa chọn nhắm mục tiêu theo môi trườ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 assignTargetingOption khi targetingTypeTARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

Môi trường phân phát.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId thuộc TargetingOption thuộc loại TARGETING_TYPE_ENVIRONMENT (ví dụ: "508010" để nhắm mục tiêu tuỳ chọn ENVIRONMENT_WEB_OPTIMIZED).

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 assignTargetingOption 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. Nội dung này sẽ được điền sẵ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

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

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

enum (Viewability)

Tỷ lệ phần trăm khả năng xem theo dự đoán.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId thuộc TargetingOption thuộc loại TARGETING_TYPE_VIEWABILITY (ví dụ: "509010" để nhắm mục tiêu tuỳ chọn VIEWABILITY_10_PERCENT_OR_MORE).

AuthorizedSellerStatusAssignedTargetingOptionDetails

Thể hiện 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Nếu tài nguyên không có tuỳ chọn nhắm mục tiêu được chỉ định TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, thì tài nguyên đó sẽ sử dụng "Người bán trực tiếp và đại lý đượ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 kiểu TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn 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 assignTargetingOption 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 kiểu 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ề lựa chọn nhắm mục tiêu theo khu vực địa lý đượ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 assignTargetingOption 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 kiểu TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

Chỉ có đầu ra. Loại tiêu chí 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 chi tiết về tiêu chí 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 assignTargetingOption 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

string

Bắt buộc. Mã của nhãn nội dung kỹ thuật số sẽ bị LOẠI TRỪ.

contentRatingTier

enum (ContentRatingTier)

Chỉ có đầu ra. Tên hiển thị của bậc phân loại nhãn nội dung kỹ thuật số.

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 assignTargetingOption khi targetingTypeTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

string

Bắt buộc. ID của danh mục nhạy cảm bị LOẠI TRỪ.

sensitiveCategory

enum (SensitiveCategory)

Chỉ có đầu ra. Một enum của thuật toán phân loại nội dung danh mục nhạy cảm DV360.

ExchangeAssignedTargetingOptionDetails

Thông tin chi tiết về lựa 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_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 kiểu TARGETING_TYPE_EXCHANGE.

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 assignTargetingOption 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 kiểu TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Đã chỉ định thông tin chi tiết về lựa chọn nhắm mục tiêu nhà xác minh bên thứ ba. Thông tin này sẽ được điền sẵn vào trường chi tiết của một assignTargetingOption 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 kết hợp verifier. Có thể nhắm mục tiêu một trong các nhà xác minh bên thứ ba để thực thi ngưỡng an toàn thương hiệu cho lượt hiển thị. verifier chỉ có thể là một trong những trạng thái sau đây:
adloox

object (Adloox)

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

doubleVerify

object (DoubleVerify)

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

integralAdScience

object (IntegralAdScience)

Trình 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 tuỳ chọn Adloox có thể dùng.

Enum
ADLOOX_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ tuỳ chọn Adloox nào.
ADULT_CONTENT_HARD Nội dung dành cho người lớn (cứng).
ADULT_CONTENT_SOFT Nội dung người lớn (nhẹ).
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 bạo lực và vũ khí.
LOW_VIEWABILITY_DOMAINS Tên 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 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 biện pháp kiểm soát an toàn cho thương hiệu DV.

avoidedAgeRatings[]

enum (AgeRating)

Tránh đặt giá thầu cho ứng dụng có mức phân loại theo độ tuổi.

appStarRating

object (AppStarRating)

Tránh đặt giá thầu cho ứng dụng có điểm 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ó hoạt động gian lận trước đây và Tỷ lệ lưu lượng truy cập không hợp lệ (IVT).

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 tuỳ 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ần tránh có mức độ nghiêm trọng cao liên quan đến mức độ an toàn cho thương hiệu.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Các danh mục tránh mức độ nghiêm trọng trung bình về mức độ an toàn cho thương hiệu.

HighSeverityCategory

Các lựa chọn có thể áp dụng cho các danh mục 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 bất kỳ danh mục 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 & Ả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.
GRAPHIC_VIOLENCE_WEAPONS Nội dung bạo lực/vũ khí cực kỳ phản cảm/nhạy cảm.
HATE_PROFANITY Nội dung thù địch/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 Bị mua chuộc/Phần mềm độc hại/Lỗ hổng.

MediumSeverityCategory

Các lựa chọn có thể áp dụng cho các 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 bất kỳ 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ơi.
ALTERNATIVE_LIFESTYLES 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 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 tạo ra.
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ạ: Xe cộ.
ALCOHOL Thuốc/Rượu/Chất bị kiểm soát: Rượu.
SMOKING Thuốc/Rượu/Chất bị kiểm soát: 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 chuẩn: Không phải tiếng Anh.
PARKING_PAGE Nội dung không phải chuẩn: Trang đỗ xe.
UNMODERATED_UGC Nội dung do người dùng tạo 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ị gây tranh cãi.
NEGATIVE_NEWS_PHARMACEUTICAL Tin tức tiêu cực: Dược phẩm.

AgeRating

Các tùy chọn có thể có 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ỳ lựa chọn xếp hạng độ 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 phân loại cho Mọi người (9+).
APP_AGE_RATE_12_PLUS Các ứng dụng được phân loại là thanh thiếu niên (12 tuổi trở lên).
APP_AGE_RATE_17_PLUS Ứng dụng được xếp hạng là Người trưởng thành (17 tuổi trở lên).
APP_AGE_RATE_18_PLUS Ứng dụng được phân loại là Chỉ người lớn (18+).

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 cho ứng dụng có điểm xếp hạng theo sao.

avoidInsufficientStarRating

boolean

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

StarRating

Các lựa chọn có thể áp dụng cho điểm 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 bất kỳ lựa chọn xếp hạng sao cho ứng dụng nào.
APP_STAR_RATE_1_POINT_5_LESS Ứng dụng chính thức có xếp hạng < 1,5 sao.
APP_STAR_RATE_2_LESS Ứng dụng chính thức có xếp hạng < 2 sao.
APP_STAR_RATE_2_POINT_5_LESS Ứng dụng chính thức có xếp hạng < 2,5 sao.
APP_STAR_RATE_3_LESS Ứng dụng chính thức có xếp hạng < 3 sao.
APP_STAR_RATE_3_POINT_5_LESS Ứng dụng chính thức có xếp hạng < 3,5 sao.
APP_STAR_RATE_4_LESS Ứng dụng chính thức có xếp hạng < 4 sao.
APP_STAR_RATE_4_POINT_5_LESS Ứng dụng chính thức có xếp hạng < 4,5 sao.

DisplayViewability

Thông tin chi tiết về chế độ cài đặt khả năng xem của quảng cáo hiển thị 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 hoá tỷ lệ có thể xem của 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 hoá 100% thời lượng có thể xem.

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

Các lựa chọn có thể áp dụng cho tỷ lệ có thể xem của 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 về tỷ lệ đã 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 hoá tỷ lệ có thể xem của IAB từ 80% trở lên.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 75% trở lên.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 70% trở lên.
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ối đa hoá tỷ lệ có thể xem của IAB từ 65% trở lên.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 60% trở lên.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 55% trở lên.
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 hoá tỷ lệ có thể xem của IAB từ 50% trở lên.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đ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ối đa hoá tỷ lệ có thể xem của IAB từ 30% trở lên.

ViewableDuring

Tùy chọn có thể có về thời lượng có thể xem.

Enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ lựa chọn nào về thời lượng xem trung bình.
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 hoá 100% thời lượng có thể xem là 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 hoá 100% thời lượng có thể xem là 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 hoá 100% thời lượng có thể xem là 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 hoá tỷ lệ có thể xem của IAB.

videoViewableRate

enum (VideoViewableRate)

Nhắm mục tiêu khoảng không quảng cáo trên web để tối đa hóa tỷ lệ có thể xem toàn bộ.

playerImpressionRate

enum (PlayerImpressionRate)

Nhắm mục tiêu 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ừ 400x300 trở lên.

VideoIAB

Các lựa chọn có thể có về tỷ lệ có thể xem 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ỳ lựa chọn tỷ lệ có thể xem video nào theo IAB.
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 hoá tỷ lệ có thể xem của IAB từ 80% trở lên.
IAB_VIEWABILITY_75_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 75% trở lên.
IAB_VIEWABILITY_70_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 70% trở lên.
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ối đa hoá tỷ lệ có thể xem của IAB từ 65% trở lên.
IAB_VIEWABILITY_60_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 60% trở lên.
IAB_VIEWABILITY_55_PERCENT_HIHGER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đa tỷ lệ có thể xem của IAB từ 55% trở lên.
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 hoá tỷ lệ có thể xem của IAB từ 50% trở lên.
IAB_VIEWABILITY_40_PERCENT_HIHGER Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tăng tối đ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ối đa hoá tỷ lệ có thể xem của IAB từ 30% trở lên.

VideoViewableRate

Các lựa chọn về tỷ lệ có thể xem toàn bộ.

Enum
VIDEO_VIEWABLE_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 tỷ lệ có thể xem video nào.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem toàn bộ lên từ 40% trở lên.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web để tối đa hoá tỷ lệ có thể xem toàn bộ từ 35% trở lên.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem đầy đủ từ 30% trở lên.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem đầy đủ từ 25% trở lên.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem đầy đủ từ 20% trở lên.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Nhắm mục tiêu khoảng không quảng cáo trên web để tăng tối đa tỷ lệ có thể xem đầy đủ từ 10% trở lên.

PlayerImpressionRate

Các lựa chọn 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ỳ lựa chọn 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

Gian lận DoubleVerify và Chế độ cài đặt Lưu lượng truy cập không hợp lệ.

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ó hoạt động gian lận trước đây và lưu lượng truy cập không hợp lệ (IVT)

avoidInsufficientOption

boolean

Không đủ dữ liệu về gian lận trong quá khứ và Số liệu thống kê về lưu lượng truy cập không hợp lệ (IVT).

FraudOption

Các cách thức có thể xảy ra về Hành vi gian lận trong quá khứ và Tỷ lệ lưu lượng truy cập không hợp lệ.

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

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 cho thương hiệu – Không thể phân loại.

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 cho thương hiệu – Nội dung 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 cho 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)

Sự an toàn cho thương hiệu – Cờ bạc.

excludedAdFraudRisk

enum (AdFraudPrevention)

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

displayViewability

enum (DisplayViewability)

Mục Khả năng xem trên Mạng Hiển thị (chỉ áp dụng cho mục hàng hiển thị).

videoViewability

enum (VideoViewability)

Mục về khả năng xem video (chỉ áp dụng cho mục hàng video).

customSegmentId[]

string (int64 format)

Mã phân khúc tuỳ 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 số TRAQ (chất lượng quảng cáo thực sự) của Integral Ad Science có thể có.

Enum
TRAQ_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định đ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 Điểm TRAQ 1000.

Người lớn

Tùy chọn có thể có dành cho người lớn 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 dành cho người lớn nào.
ADULT_HR Người lớn – Loại trừ nguy cơ cao.
ADULT_HMR Người lớn – Loại trừ nguy cơ cao và trung bình.

Đồ uống có cồn

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

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 về đồ uống có cồn nào.
ALCOHOL_HR Rượu - Loại trừ nguy cơ cao.
ALCOHOL_HMR Rượu - Loại trừ nguy cơ cao và trung bình.

IllegalDownloads

Tùy chọn tải xuống bất hợp pháp Integral Ad Science có thể có.

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.

Ma túy

Các loại thuốc Integral Ad Science có thể có.

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 về thuốc nào.
DRUGS_HR Thuốc – Loại trừ nguy cơ cao.
DRUGS_HMR Thuốc – Loại trừ rủi ro cao và trung bình.

HateSpeech

Các lựa chọn có thể có về lời nói hận thù của 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ừ rủi ro cao.
HATE_SPEECH_HMR Lời nói hận thù – Loại trừ rủi ro cao và trung bình.

OffensiveLanguage

Lựa chọn có thể có về ngôn từ gây 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 bất kỳ tuỳ chọn ngôn ngữ nào.
OFFENSIVE_LANGUAGE_HR Ngôn từ gây phản cảm – Loại trừ 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ể xảy ra về Bạo lực 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

Lựa chọn cờ bạc Integral Ad Science có thể có.

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 lựa chọn có thể giúp ngăn chặn hành vi gian lận của Integral Ad Science Ad Science.

Enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Enum này chỉ là một phần giữ chỗ và không chỉ định bất kỳ phương án ngăn chặn hành vi gian lận nào trong quảng cá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 lựa chọn về khả năng xem trên Mạng 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 quảng cáo 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 về khả năng xem video Integral Ad Science có thể có.

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 Hơn 40%trong khung nhìn (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_50 Hơn 50%trong khung nhìn (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_60 Hơn 60%trong khung hình (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_70 Hơn 70%trong khung nhìn (tiêu chuẩn về khả năng xem video của IAB).

PoiAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo địa điểm yêu thích đượ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 assignTargetingOption 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 một địa điểm yêu thích, ví dụ: "Times Square", "Space Kim", theo sau là địa chỉ đầy đủ nếu có.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc kiểu TARGETING_TYPE_POI.

Bạn có thể truy xuất mã lựa chọn nhắm mục tiêu địa điểm yêu thích được chấp nhận bằng cách sử dụng SearchTargetingOptions.

Nếu việc nhắm mục tiêu một vĩ độ/kinh độ cụ thể bị xóa khỏi địa chỉ hoặc tên POI, bạn có thể tạo ID tùy 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 vị trí thập phân thứ 6, loại bỏ 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ã lựa chọn nhắm mục tiêu "40741469;-74003387".

latitude

number

Chỉ có đầu ra. Vĩ độ của địa điểm yêu thích làm tròn đến vị trí thập phân thứ 6.

longitude

number

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

proximityRadiusAmount

number

Bắt buộc. Bán kính của khu vực xung quanh POI sẽ được nhắm mục tiêu. Đơn vị của bán kính được chỉ định theo 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 để đo bán kính nhắm mục tiêu.

DistanceUnit

Tùy chọn đơn vị khoảng cách có thể có.

Enum
DISTANCE_UNIT_UNSPECIFIED Giá trị loại chưa đượ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 assignTargetingOption 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 kiểu 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 mà bạn sẽ nhắm đến. Đơn vị của bán kính được chỉ định theo 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. Mức tăng tối thiểu cho cả hai trường hợp là 0,1. Dữ liệu đầu vào sẽ được làm tròn đến giá trị gần nhất chấp nhận được 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 để đo bán kính nhắm mục tiêu.

ContentDurationAssignedTargetingOptionDetails

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

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ề tuỳ chọn nhắm mục tiêu được chỉ định cho loại luồng nội dung. Nội dung này sẽ được điền sẵn vào trường contentStreamTypeDetails khi targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE. Hệ thống không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Để đạt được hiệu quả này, hãy xoá tất cả lựa chọn nhắm mục tiêu theo loại luồng nội dung.

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 được chỉ định theo vị trí nội dung gốc. Nội dung này sẽ được điền sẵn vào trường nativeContentPositionDetails khi targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION. Hệ thống 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ả các lựa 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
{
  "targetingOptionId": string,
  "contentPosition": enum (NativeContentPosition)
}
Trường
targetingOptionId

string

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

contentPosition

enum (NativeContentPosition)

Vị trí nội dung.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

OmidAssignedTargetingOptionDetails

Đại diện cho loại khoảng không quảng cáo đã 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 assignTargetingOption khi targetingTypeTARGETING_TYPE_OMID.

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

enum (Omid)

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

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

targetingOptionId

string

Bắt buộc. targetingOptionId của TargetingOption thuộc kiểu TARGETING_TYPE_OMID.

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. Nội dung này sẽ được điền sẵn vào trường audioContentTypeDetails khi targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE. Hệ thống không hỗ trợ việc nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Để đạt được hiệu ứng này, hãy xoá tất cả lựa chọn nhắm mục tiêu theo loại nội dung âm thanh.

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

string

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

audioContentType

enum (AudioContentType)

Loại nội dung âm thanh.

Chỉ có đầu ra ở phiên bản 1. Bắt buộc trong phiên bản 2.

ContentGenreAssignedTargetingOptionDetails

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

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.

Phương thức

get

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

list

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