REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Tài nguyên: AssignmentOption

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

Biểu diễn dưới dạng JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Các trường
name

string

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

assignedTargetingOptionId

string

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

targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

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

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

object (ChannelAssignedTargetingOptionDetails)

Thông tin chi tiết về kênh. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Thông tin chi tiết về danh mục ứng dụng. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

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

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Chi tiết danh sách vị trí lân cận. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Thông tin chi tiết về giới tính. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Thông tin chi tiết về vị trí trong luồng nội dung. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Thông tin chi tiết về loại thiết bị. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Thông tin chi tiết về trình duyệt. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Thông tin chi tiết về thu nhập hộ gia đình. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Thông tin về vị trí trên màn hình. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Thông tin chi tiết về từ khoá. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_KEYWORD.

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Thông tin chi tiết về từ khoá. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Thông tin chi tiết về hệ điều hành. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Thông tin chi tiết về mẫu và kiểu thiết bị. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Chi tiết về danh mục. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_CATEGORY.

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

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Thông tin chi tiết về khả năng xem. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_VIEWABILITY.

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

Nếu một tài nguyên không có lựa chọn trạng thái người bán được uỷ quyền, thì tất cả người bán được uỷ quyền biểu thị là DIRECT hoặc RESELLER trong tệp ads.txt đều được nhắm mục tiêu theo mặc định.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Thông tin chi tiết về nhãn nội dung kỹ thuật số. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Thông tin chi tiết về danh mục nhạy cảm. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

Chi tiết về địa điểm yêu thích. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Thông tin chi tiết về loại nội dung âm thanh. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Thông tin chi tiết về thể loại nội dung. Trường này sẽ được điền sẵn khi targetingType có giá trị là TARGETING_TYPE_CONTENT_GENRE.

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ừ thực thể cấp cao hơn như đối tác hay nhà quảng cáo hay không. Các tuỳ chọn nhắm mục tiêu được chỉ định được kế thừa có tiền lệ, 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 khoá 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ác thực thể đó. Việc kế thừa chỉ áp dụng cho những 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à Loại trừ Nhãn nội dung kỹ thuật số nếu các kênh này đượ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 chỉ định được kế thừa từ tùy chọn cài đặt nhắm mục tiêu của nhà quảng cáo.

ChannelAssignedTargetingOptionDetails

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

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

string (int64 format)

Bắt buộc. Mã nhận dạng của kênh. Vui lòng tham khảo trường mã nhận dạng kênh trên tài nguyên của kênh do đối tác sở hữu hoặc tài nguyên 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 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 cho tuỳ chọn nhắm mục tiêu theo danh mục ứng dụng được chỉ định. Nội dung này sẽ được điề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
}
Các 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ề lựa chọn nhắm mục tiêu theo ứng dụng được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_APP.

Biểu diễn dưới dạng JSON
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Các 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ừ mã ứng dụng.

AppPlatform

Tuỳ chọn 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 này là nền tảng CTV (TV kết nối Internet) chưa được nêu 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. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_URL.

Biểu diễn dưới dạng JSON
{
  "url": string,
  "negative": boolean
}
Các 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 được biểu thị bằng startHour 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)
}
Các 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 (bắt đầ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ế được dùng để xác định múi giờ nào 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 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 để giải quyết múi giờ.

Enum
TIME_ZONE_RESOLUTION_UNSPECIFIED Độ phân giải 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 nhìn thấy quảng cáo.
TIME_ZONE_RESOLUTION_ADVERTISER Thời gian được quyết định 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. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

Độ tuổi của đối tượng. Chúng tôi chỉ hỗ trợ việc nhắm đến một độ tuổi liên tục của một đối tượng. Do đó, độ tuổi được thể hiện trong trường này có thể 1) chỉ 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ó 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 một đối tượng có độ tuổi không xác định.

Chỉ có đầu ra ở phiên bản 1.

targetingOptionId

string

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

Bắt buộc. Mã của danh sách vị trí theo khu vực. Cần 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

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

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

string (int64 format)

Bắt buộc. Mã của danh sách vị trí vùng lân cận. Cần tham chiếu đến trường locationListId của tài nguyên LocationList có loại 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 một 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í 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. Hãy đặt giá trị này để khớp với mọi tiêu chí nhắm mục tiêu hiện có. 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ả cá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 tuỳ chọn được chỉ định theo vị trí đị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 cư.

Enum
PROXIMITY_RADIUS_RANGE_UNSPECIFIED Phạm vi bán kính nhắm mục tiêu không đượ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 cho tuỳ chọn nhắm mục tiêu theo giới tính được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_GENDER.

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

enum (Gender)

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

Chỉ có đầu ra ở phiên bản 1.

targetingOptionId

string

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

VideoPlayerSizeAssignedTargetingOptionDetails

Chi tiết về tuỳ chọn nhắm mục tiêu theo kích thước trình phát video. Giá trị này sẽ được điền vào trường videoPlayerSizeDetails khi targetingTypeTARGETING_TYPE_VIDEO_PLAYER_SIZE. Không hỗ trợ tính năng 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 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
{
  "targetingOptionId": string,
  "videoPlayerSize": enum (VideoPlayerSize)
}
Các 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.

UserRewardedContentAssignedTargetingOptionDetails

Chi tiết về tuỳ chọn nhắm mục tiêu theo nội dung có tặng thưởng cho người dùng. Giá trị 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)
}
Các 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 cho người dùng đối với quảng cáo dạng video.

ParentalStatusAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu theo tình trạng con cái được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_PARENTAL_STATUS.

Biểu diễn dưới dạng JSON
{
  "parentalStatus": enum (ParentalStatus),
  "targetingOptionId": string
}
Các 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 loại TARGETING_TYPE_PARENTAL_STATUS.

ContentInstreamPositionAssignedTargetingOptionDetails

Chi tiết về tuỳ chọn nhắm mục tiêu theo vị trí trong luồng phát nội dung được chỉ định. Giá trị 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
{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
Các 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 âm thanh hoặc video.

Chỉ có đầu ra ở phiên bản 1.

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 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, 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 quảng cáo.

Enum
AD_TYPE_UNSPECIFIED Loại quảng cáo không đượ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, ví dụ: 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

Chi tiết về tuỳ chọn nhắm mục tiêu theo vị trí ngoài luồng phát nội dung đã chỉ định. Giá trị 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
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Các trường
targetingOptionId

string

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

contentOutstreamPosition

enum (ContentOutstreamPosition)

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

Chỉ có đầu ra ở phiên bản 1.

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 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, 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

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

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "deviceType": enum (DeviceType)
}
Các 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.

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. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_AUDIENCE_GROUP. Mối quan hệ giữa mỗi nhóm là UNION, ngoại trừ thuộc sư excludedFirstAndSecondPartyAudienceGroup và excludedGoogleAudienceGroup, trong đó, CompLEMENT được dùng làm một thao tác 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)
  }
}
Các trường
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

Mã nhận dạng đố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 đã 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à 4 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 bao gồm. 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 được bao gồm. Chỉ chứa mã đối tượng kết hợp.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Mã nhận dạng và đối tượng của 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. "BÌNH LUẬN 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 một phiên bản "biên tập" 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 gọi là "OR" 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. "BÌNH LUẬN 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 một phiên bản "biên tập" 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 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à ứng dụng được cài đặt. Tất cả các mục đều được gọi là "OR" theo logic.

FirstAndThirdPartyAudienceGroup

Thông tin chi tiết về nhóm đối tượng của 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 đặt theo logic 'HOẶC' của nhau.

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
Các 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 được phép sử dụng những chế độ 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 tiêu chí 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)
}
Các 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 tiêu chí 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)

Mức độ 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, sẽ không sử dụng giới hạn số ngày gần đây.

Gần đây nhất

Tất cả giá trị được hỗ trợ về thời gian cập nhật 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ố ngày gần đây.
RECENCY_1_MINUTE Số ngày gần đây là 1 phút.
RECENCY_5_MINUTES Thời gian gần đây là 5 phút.
RECENCY_10_MINUTES Thời gian tìm kiếm gần đây là 10 phút.
RECENCY_15_MINUTES Thời gian gần đây nhất là 15 phút.
RECENCY_30_MINUTES Thời gian tìm kiếm gần đây là 30 phút.
RECENCY_1_HOUR Số ngày 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 Số ngày 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 Số ngày gần đây là 15 ngày.
RECENCY_21_DAYS Số ngày gần đây là 21 ngày.
RECENCY_28_DAYS Số ngày 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 được đặt theo logic "OR" với nhau.

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Các 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
}
Các trường
googleAudienceId

string (int64 format)

Bắt buộc. Mã đối tượng của 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 nhắm mục tiêu theo danh sách tuỳ chỉnh đều là "HOẶC" của nhau theo logic.

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

object (CustomListTargetingSetting)

Bắt buộc. Tất cả chế độ cài đặt nhắm mục tiêu theo 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
}
Các 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 đặt theo logic 'OR' của nhau.

Biểu diễn dưới dạng JSON
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Các 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ẽ gửi lỗi.

CombinedAudienceTargetingSetting

Thông tin chi tiết về chế độ cài đặt tiêu chí 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
}
Các 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. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_BROWSER.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Các 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ả các lựa 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 tuỳ chọn nhắm mục tiêu theo thu nhập hộ gia đình được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_HOUSEHOLD_INCOME.

Biểu diễn dưới dạng JSON
{
  "householdIncome": enum (HouseholdIncome),
  "targetingOptionId": string
}
Các 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 loại TARGETING_TYPE_HOUSEHOLD_INCOME.

OnScreenPositionAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo vị trí trên màn hình. Giá trị 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)
}
Các 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 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, 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 cho tuỳ chọn nhắm mục tiêu theo nhà mạng và Nhà cung cấp dịch vụ Internet (ISP) được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_CARRIER_AND_ISP.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Các 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 tuỳ chọn nhắm mục tiêu nhà cung cấp dịch vụ và nhà cung cấp dịch vụ Internet (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 cho lựa chọn nhắm mục tiêu theo từ khoá được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_KEYWORD.

Biểu diễn dưới dạng JSON
{
  "keyword": string,
  "negative": boolean
}
Các 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 là mã 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 nhắm mục tiêu cho danh sách từ khoá phủ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Biểu diễn dưới dạng JSON
{
  "negativeKeywordListId": string
}
Các 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ề tuỳ chọn nhắm mục tiêu theo hệ điều hành đã chỉ định. Giá trị 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
}
Các 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ã tuỳ 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ề tuỳ chọn nhắm mục tiêu theo mẫu thiết bị và nhãn thiết bị được chỉ định. Giá trị 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
}
Các 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ề tuỳ chọn nhắm mục tiêu theo môi trường được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

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

Chỉ có đầu ra ở phiên bản 1.

targetingOptionId

string

Bắt buộc. targetingOptionId của 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 nhắm mục tiêu cho nguồn khoảng không quảng cáo. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_INVENTORY_SOURCE.

Biểu diễn dưới dạng JSON
{
  "inventorySourceId": string
}
Các 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

Chi tiết về tuỳ chọn nhắm mục tiêu theo danh mục được chỉ định. Giá trị 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
}
Các 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ề tuỳ chọn nhắm mục tiêu theo khả năng xem được chỉ định. Nội dung này sẽ được điề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),
  "targetingOptionId": string
}
Các 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.

targetingOptionId

string

Bắt buộc. targetingOptionId của 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

Đại diện cho trạng thái người bán được uỷ quyền đã chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Biểu diễn dưới dạng JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
Các 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 cho tuỳ chọn nhắm mục tiêu theo ngôn ngữ được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_LANGUAGE.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Các 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ả các tuỳ 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 cho tuỳ chọn nhắm mục tiêu theo vùng địa lý được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_GEO_REGION.

Biểu diễn dưới dạng JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
Các 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. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_INVENTORY_SOURCE_GROUP.

Biểu diễn dưới dạng JSON
{
  "inventorySourceGroupId": string
}
Các 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

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

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

string

Bắt buộc. Mã nhận dạng của nhãn nội dung kỹ thuật số cần 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

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

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

string

Bắt buộc. Mã nhận dạng của danh mục nhạy cảm cần LOẠI TRỪ.

sensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

Thông tin chi tiết cho tuỳ chọn nhắm mục tiêu trao đổi được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_EXCHANGE.

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

string

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

SubExchangeAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu theo sàn giao dịch phụ được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_SUB_EXCHANGE.

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu của người xác minh bên thứ ba được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption 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.
}
Các trường
Trường nhóm verifier. Có thể nhắm đến một trong các bên xác minh bên thứ ba để áp dụng ngưỡng an toàn thương hiệu cho số 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 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)

Bên xác minh thương hiệu 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)
  ]
}
Các 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 Adloox có thể áp 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 người lớn (khó).
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 và vũ khí bạo lực.
LOW_VIEWABILITY_DOMAINS Các miền có khả năng xem thấp.
FRAUD Lừa đảo.

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
}
Các trường
brandSafetyCategories

object (BrandSafetyCategories)

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 ứng dụng có mức phân loại theo độ 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ố. 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)
  ]
}
Các trường
avoidUnknownBrandSafetyCategory

boolean

Không xác định hoặc không thể xếp hạng.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Danh mục tránh mức độ nghiêm trọng trung bình đối với sự an toàn thương hiệu.

HighSeverityCategory

Các lựa chọn dành cho 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 có mức độ nghiêm trọng cao nào.
ADULT_CONTENT_PORNOGRAPHY Nội dung người lớn: 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 hận thù/Ngôn từ thô tục.
CRIMINAL_SKILLS Hoạt động bất hợp pháp: Kỹ năng thực hiện hành vi phạm tội.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Phần thưởng/Phần mềm độc hại/Sự cố định hình.

MediumSeverityCategory

Các lựa chọn có thể dành 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 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 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 được kiểm soát: Rượu.
SMOKING Thuốc/Rượu/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 Standard: Trang đỗ xe.
UNMODERATED_UGC UGC chưa được kiểm duyệt: Diễn đàn, hình ảnh và video.
INFLAMMATORY_POLITICS_AND_NEWS Các 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 tuỳ chọn xếp hạng độ tuổi có thể có.

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 dành cho mọi người (9+).
APP_AGE_RATE_12_PLUS Ứng dụng được xếp hạng 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à dành cho 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+).

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
}
Các 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 những ứng dụng không có đủ điểm xếp hạng theo sao.

StarRating

Các tuỳ chọn có thể 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ỳ tuỳ chọn xếp hạng theo sao nào 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 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)
}
Các trường
iab

enum (IAB)

Nhắm đến khoảng không quảng cáo trên web và ứng dụng để tối đa hoá tỷ lệ có thể xem theo IAB.

viewableDuring

enum (ViewableDuring)

Nhắm đến 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 khả thi 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 giá đã xem nào của IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Nhắm đến 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ối đa 80%.
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ối đa hoá tỷ lệ có thể xem của IAB tối đa 75%.
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ối đa hoá tỷ lệ có thể xem của IAB tối đa 70% trở lên.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Nhắm đến 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ối đa 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ối đa hoá tỷ lệ có thể xem của IAB tối đa 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ối đa hoá tỷ lệ có thể xem theo IAB tối đa 55% trở lên.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Nhắm đến 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ối đa 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ối đa hoá tỷ lệ có thể xem của IAB tối đa 40%.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Nhắm đến 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ối đa 30%.

ViewableDuring

Các tuỳ chọn có thể áp dụng 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ỳ tuỳ chọn nào về thời lượng xem trung bình.
AVERAGE_VIEW_DURATION_5_SEC Nhắm đến 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 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)
}
Các trường
videoIab

enum (VideoIAB)

Nhắm đến khoảng không quảng cáo trên web để tối đa hoá tỷ lệ có thể xem 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ệ 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 là 400x300 trở lên.

VideoIAB

Các lựa chọn khả thi 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ỳ tuỳ chọn tỷ lệ có thể xem của IAB cho video nào.
IAB_VIEWABILITY_80_PERCENT_HIGHER Nhắm đến 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ối đa 80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Nhắm đến 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ối đa 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Nhắm đến 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ối đa 70% trở lên.
IAB_VIEWABILITY_65_PERCENT_HIHGER Nhắm đến 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ối đa 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ối đa hoá tỷ lệ có thể xem của IAB tối đa 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ối đa hoá tỷ lệ có thể xem theo IAB tối đa 55% trở lên.
IAB_VIEWABILITY_50_PERCENT_HIGHER Nhắm đến 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ối đa 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ối đa hoá tỷ lệ có thể xem của IAB tối đa 40%.
IAB_VIEWABILITY_30_PERCENT_HIHGER Nhắm đến 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ối đa 30%.

VideoViewableRate

Các lựa chọn có thể áp dụng về tỷ lệ xem đầ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ối đa hoá tỷ lệ có thể xem toàn bộ tối đa 40% trở lên.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tối đa hoá tỷ lệ có thể xem toàn bộ tối thiểu là 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tối đa hoá tỷ lệ có thể xem toàn bộ tối đa 30% trở lên.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tối đa hoá 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ối đa hoá tỷ lệ có thể xem toàn bộ tối đa 20% trở lên.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Nhắm đến khoảng không quảng cáo trên web để tối đa hoá tỷ lệ có thể xem toàn bộ tối thiểu 10%.

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ỳ 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 Hoạt động 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
}
Các trường
avoidedFraudOption

enum (FraudOption)

Tránh các trang web và ứng dụng có nội dung Gian lận và IVT trong quá khứ.

avoidInsufficientOption

boolean

Không đủ số liệu thống kê về gian lận trong quá khứ và IVT.

FraudOption

Các lựa chọn có thể xảy ra liên quan đến tỷ lệ Gian lận và IVT trước đây.

Enum
FRAUD_UNSPECIFIED Enum này chỉ là một phần giữ chỗ, không chỉ định bất kỳ lựa chọn gian lận và lưu lượng truy cập không hợp lệ nào.
AD_IMPRESSION_FRAUD_100 100% gian lận và lưu lượng truy cập không hợp lệ.
AD_IMPRESSION_FRAUD_50 Gian lận và lưu lượng truy cập không hợp lệ từ 50% trở lê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 Gian lận và lưu lượng truy cập không hợp lệ từ 10% trở lên.
AD_IMPRESSION_FRAUD_8 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 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
  ]
}
Các 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ể 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)

Sự 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 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)

Sự an toàn đối với 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 các 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 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 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 Điểm TraQ: 1000.

Người lớn

Có thể có các tuỳ chọn Integral Ad Science dành cho người lớn.

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ừ rủi ro cao.
ADULT_HMR Người lớn – Loại trừ rủi ro cao và trung bình.

Đồ uống có cồn

Các tuỳ chọn Integral Ad Science Rượu có thể có.

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

Tuỳ chọn Tải xuống không hợp lệ 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 không hợp lệ 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ể có dành 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ừ rủi ro cao.
DRUGS_HMR Thuốc - Loại trừ nguy cơ cao và trung bình.

HateSpeech

Các lựa chọn lời nói hận thù có thể có trong 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

Các lựa chọn ngôn ngữ có thể có của Integral Ad Science Sản xuất.

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ể có Bạo lực trong khoa học quảng cáo tích hợp.

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

Tuỳ 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ỳ tuỳ 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 ngăn chặn gian lận có thể có trong 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ỳ tuỳ chọn 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 khả năng xem có thể có của Integral Ad Science Display.

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 có thể có về khả năng xem 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 Lượt xem tăng hơn 40% (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_50 50%lượt xem trở lên (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_60 Hơn 60%lượt xem (tiêu chuẩn về khả năng xem video của IAB).
VIDEO_VIEWABILITY_70 Hơn 70%lượt xem (tiêu chuẩn 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 được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption 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)
}
Các trường
displayName

string

Chỉ có đầu ra. Tên hiển thị của địa điểm yêu thích, ví dụ: "Times Square", "Space Needle", 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 POI được chấp nhận bằng cách sử dụng targetingOptions.search.

Nếu nhắm mục tiêu một 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, 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 độ của 40.7414691, -74.003387 bằng cách sử dụng ID tùy chọn nhắm mục tiêu "40741469; -74003387".

latitude

number

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

longitude

number

Chỉ có đầu ra. Kinh độ của địa điểm yêu thích 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 POI sẽ được nhắm mục tiêu. Đơn vị của bán kính được chỉ định bằng proximityRadiusUnit. Giá trị phải từ 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 tuỳ chọn đơn vị khoảng cách có thể có.

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ề tuỳ chọn nhắm mục tiêu theo Chuỗi doanh nghiệp được chỉ định. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_BUSINESS_CHAIN.

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

string

Chỉ có đầu ra. Tên hiển thị của một chuỗi cửa hàng kinh doanh, 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ã tuỳ chọn nhắm mục tiêu theo chuỗi doanh nghiệp được chấp nhận bằng targetingOptions.search.

proximityRadiusAmount

number

Bắt buộc. Bán kính của khu vực xung quanh chuỗi địa điểm kinh doanh sẽ được nhắm đến. Đơn vị của bán kính được chỉ định bằng proximityRadiusUnit. Giá trị phải từ 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. 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. Giá trị này sẽ được điền vào trường contentDurationDetails khi targetingTypeTARGETING_TYPE_CONTENT_DURATION. Không hỗ trợ tính năng nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Hãy xoá tất cả tuỳ chọn nhắm mục tiêu theo thời lượng nội dung để có được hiệu ứng này.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
Các 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. Giá trị này sẽ được điền vào trường contentStreamTypeDetails khi targetingTypeTARGETING_TYPE_CONTENT_STREAM_TYPE. Không hỗ trợ tính năng 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 tuỳ chọn nhắm mục tiêu 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)
}
Các 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 chương trình phát 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. Giá trị này sẽ được điền vào trường nativeContentPositionDetails khi targetingTypeTARGETING_TYPE_NATIVE_CONTENT_POSITION. Không hỗ trợ tính năng nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Xoá tất cả tuỳ chọn nhắm mục tiêu theo vị trí nội dung gốc để có được hiệu ứng này.

Biểu diễn dưới dạng JSON
{
  "targetingOptionId": string,
  "contentPosition": enum (NativeContentPosition)
}
Các 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.

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. Nội dung này sẽ được điền vào trường chi tiết của Assign TargetingOption khi targetingTypeTARGETING_TYPE_OMID.

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

enum (Omid)

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

Chỉ có đầu ra ở phiên bản 1.

targetingOptionId

string

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

AudioContentTypeAssignedTargetingOptionDetails

Thông tin chi tiết về lựa chọn nhắm mục tiêu được chỉ định cho loại nội dung âm thanh. Giá trị này sẽ được điền vào trường audioContentTypeDetails khi targetingTypeTARGETING_TYPE_AUDIO_CONTENT_TYPE. Không hỗ trợ tính năng nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Xoá tất cả tuỳ 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
{
  "targetingOptionId": string,
  "audioContentType": enum (AudioContentType)
}
Các 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.

ContentGenreAssignedTargetingOptionDetails

Thông tin chi tiết về tuỳ chọn nhắm mục tiêu được chỉ định theo thể loại nội dung. Giá trị này sẽ được điền vào trường contentGenreDetails khi targetingTypeTARGETING_TYPE_CONTENT_GENRE. Không hỗ trợ tính năng nhắm mục tiêu rõ ràng tất cả các tuỳ chọn. Hãy xoá tất cả tuỳ 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
}
Các 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

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 tuỳ 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ể.