CampaignCriterion

Một tiêu chí chiến dịch.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "campaign": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "adSchedule": {
    object (AdScheduleInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "proximity": {
    object (ProximityInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "listingScope": {
    object (ListingScopeInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "ipBlock": {
    object (IpBlockInfo)
  },
  "contentLabel": {
    object (ContentLabelInfo)
  },
  "carrier": {
    object (CarrierInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "operatingSystemVersion": {
    object (OperatingSystemVersionInfo)
  },
  "mobileDevice": {
    object (MobileDeviceInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "keywordTheme": {
    object (KeywordThemeInfo)
  },
  "localServiceId": {
    object (LocalServiceIdInfo)
  },
  "brandList": {
    object (BrandListInfo)
  }
  // End of list of possible types for union field criterion.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của tiêu chí chiến dịch. Tên tài nguyên của tiêu chí chiến dịch có dạng:

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}

displayName

string

Chỉ có đầu ra. Tên hiển thị của tiêu chí.

Trường này bị bỏ qua đối với các trường hợp biến đổi.

type

enum (CriterionType)

Chỉ có đầu ra. Loại tiêu chí.

status

enum (CampaignCriterionStatus)

Trạng thái của tiêu chí.

campaign

string

Không thể thay đổi. Chiến dịch chứa tiêu chí.

criterionId

string (int64 format)

Chỉ có đầu ra. Mã của tiêu chí.

Trường này sẽ bị bỏ qua trong quá trình thay đổi.

bidModifier

number

Công cụ sửa đổi cho giá thầu khi tiêu chí khớp. Giá trị sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Hầu hết các loại tiêu chí có thể nhắm mục tiêu đều hỗ trợ đối tượng sửa đổi. Sử dụng 0 để chọn không sử dụng một loại thiết bị.

negative

boolean

Không thể thay đổi. Liệu sẽ nhắm mục tiêu (false) hay loại trừ (true) tiêu chí này.

Trường hợp criterion. Tiêu chí chiến dịch.

Bạn phải đặt chính xác một thuộc tính. criterion chỉ có thể là một trong những trạng thái sau:

keyword

object (KeywordInfo)

Không thể thay đổi. Từ khoá.

placement

object (PlacementInfo)

Không thể thay đổi. Vị trí.

mobileAppCategory

object (MobileAppCategoryInfo)

Không thể thay đổi. Danh mục ứng dụng dành cho thiết bị di động.

mobileApplication

object (MobileApplicationInfo)

Không thể thay đổi. Ứng dụng dành cho thiết bị di động.

location

object (LocationInfo)

Không thể thay đổi. Vị trí.

device

object (DeviceInfo)

Không thể thay đổi. Thiết bị.

adSchedule

object (AdScheduleInfo)

Không thể thay đổi. Lịch quảng cáo.

ageRange

object (AgeRangeInfo)

Không thể thay đổi. Độ tuổi.

gender

object (GenderInfo)

Không thể thay đổi. Giới tính.

incomeRange

object (IncomeRangeInfo)

Không thể thay đổi. Phạm vi thu nhập.

parentalStatus

object (ParentalStatusInfo)

Không thể thay đổi. Tình trạng con cái.

userList

object (UserListInfo)

Không thể thay đổi. Danh sách người dùng.

youtubeVideo

object (YouTubeVideoInfo)

Không thể thay đổi. Video trên YouTube.

youtubeChannel

object (YouTubeChannelInfo)

Không thể thay đổi. Kênh YouTube.

proximity

object (ProximityInfo)

Không thể thay đổi. Tiệm cận.

topic

object (TopicInfo)

Không thể thay đổi. Chủ đề.

listingScope

object (ListingScopeInfo)

Không thể thay đổi. Phạm vi trang thông tin.

language

object (LanguageInfo)

Không thể thay đổi. Ngôn ngữ.

ipBlock

object (IpBlockInfo)

Không thể thay đổi. IpBlock.

contentLabel

object (ContentLabelInfo)

Không thể thay đổi. ContentLabel (Nhãn nội dung).

carrier

object (CarrierInfo)

Không thể thay đổi. Nhà mạng.

userInterest

object (UserInterestInfo)

Không thể thay đổi. Sở thích của người dùng.

webpage

object (WebpageInfo)

Không thể thay đổi. Trang web.

operatingSystemVersion

object (OperatingSystemVersionInfo)

Không thể thay đổi. Phiên bản hệ điều hành.

mobileDevice

object (MobileDeviceInfo)

Không thể thay đổi. Thiết bị di động.

locationGroup

object (LocationGroupInfo)

Không thể thay đổi. Nhóm địa điểm

customAffinity

object (CustomAffinityInfo)

Không thể thay đổi. Đối tượng chung sở thích tùy chỉnh.

customAudience

object (CustomAudienceInfo)

Không thể thay đổi. Đối tượng tuỳ chỉnh

combinedAudience

object (CombinedAudienceInfo)

Không thể thay đổi. Đối tượng được kết hợp.

keywordTheme

object (KeywordThemeInfo)

Không thể thay đổi. Chủ đề từ khóa của chiến dịch Thông minh.

localServiceId

object (LocalServiceIdInfo)

Không thể thay đổi. Tiêu chí chiến dịch dịch vụ GLS.

brandList

object (BrandListInfo)

Không thể thay đổi. Tiêu chí chiến dịch danh sách thương hiệu.

CampaignCriterionStatus

Các trạng thái có thể có của Tiêu chí chiến dịch.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Tiêu chí chiến dịch đã được bật.
PAUSED Tiêu chí chiến dịch đã bị tạm dừng.
REMOVED Tiêu chí chiến dịch đã bị xóa.

ListingScopeInfo

Tiêu chí phạm vi trang thông tin.

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

object (ListingDimensionInfo)

Phạm vi của tiêu chí chiến dịch.

IpBlockInfo

Một tiêu chí IpBlock được sử dụng để loại trừ IP. Chúng tôi cho phép: - Địa chỉ IPv4 và IPv6 - địa chỉ cá nhân (192.168.0.1) - mặt nạ cho các địa chỉ cá nhân (192.168.0.1/32) - mặt nạ cho mạng Lớp C (192.168.0.1/24)

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

string

Địa chỉ IP của khối IP này.

CarrierInfo

Đại diện cho Tiêu chí nhà mạng.

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

string

Tên tài nguyên hằng số của nhà mạng.

OperatingSystemVersionInfo

Biểu thị phiên bản hệ điều hành sẽ được nhắm mục tiêu.

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

string

Tên tài nguyên hằng số của phiên bản hệ điều hành.

MobileDeviceInfo

Tiêu chí về thiết bị di động.

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

string

Tên tài nguyên hằng số của thiết bị di động.

LocationGroupInfo

Bán kính xung quanh danh sách các vị trí được chỉ định thông qua nguồn cấp dữ liệu hoặc assetSet.

Biểu diễn dưới dạng JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
Trường
geoTargetConstants[]

string

(Các) hằng số mục tiêu theo vị trí địa lý giới hạn phạm vi khu vực địa lý trong nguồn cấp dữ liệu. Hiện tại, chúng tôi chỉ cho phép một hằng số mục tiêu địa lý. Không thể đặt bằng các trường AssetSet.

radiusUnits

enum (LocationGroupRadiusUnits)

Đơn vị của bán kính. Dặm và mét được hỗ trợ cho các hằng số mục tiêu địa lý. Mili dặm và mét được hỗ trợ cho bộ mục nguồn cấp dữ liệu và bộ thành phần. Đây là yêu cầu bắt buộc và phải được đặt trong thao tác CREATE.

feedItemSets[]

string

FeedItemSets có FeedItems được nhắm mục tiêu. Nếu bạn chỉ định nhiều mã nhận dạng, thì tất cả các mục xuất hiện trong ít nhất một nhóm đều được nhắm mục tiêu. Không thể sử dụng trường này với geoTargetConstants. Đây là tính năng không bắt buộc và chỉ có thể thiết lập trong thao tác CREATE. Không thể đặt bằng các trường AssetSet.

locationGroupAssetSets[]

string

AssetSets có Thành phần được nhắm mục tiêu. Nếu bạn chỉ định nhiều mã nhận dạng, thì tất cả các mục xuất hiện trong ít nhất một nhóm đều được nhắm mục tiêu. Bạn không thể sử dụng trường này với nguồn cấp dữ liệu, hằng số mục tiêu địa lý hoặc bộ mục nguồn cấp dữ liệu. Khi sử dụng tập hợp thành phần, bạn phải chỉ định trường này hoặc enableCustomerLevelLocationAssetSet. Bạn không thể sử dụng cả hai cùng một lúc. Bạn chỉ có thể đặt giá trị này trong thao tác CREATE.

feed

string

Nguồn cấp dữ liệu chỉ định vị trí để nhắm mục tiêu. Không thể đặt bằng các trường AssetSet. Đây là yêu cầu bắt buộc và phải được đặt trong thao tác CREATE.

radius

string (int64 format)

Khoảng cách tính bằng đơn vị xác định bán kính xung quanh các vị trí được nhắm mục tiêu. Đây là yêu cầu bắt buộc và phải được đặt trong thao tác CREATE.

enableCustomerLevelLocationAssetSet

boolean

Cho biết rằng tập hợp thành phần mới nhất ở cấp khách hàng được dùng để nhắm mục tiêu. Được dùng với bán kính và bán kínhUnit. Không thể sử dụng với nguồn cấp dữ liệu, hằng số mục tiêu địa lý hoặc bộ mục nguồn cấp dữ liệu. Khi sử dụng tập hợp nội dung, bạn phải chỉ định trường này hoặc locationGroupAssetSets. Bạn không thể sử dụng cả hai cùng một lúc. Bạn chỉ có thể đặt giá trị này trong thao tác CREATE.

LocationGroupRadiusUnits

Đơn vị khoảng cách bán kính trong nhóm vị trí (ví dụ: MILES)

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
METERS Mét
MILES Dặm
MILLI_MILES Mili Dặm

LocalServiceIdInfo

Mã dịch vụ Quảng cáo dịch vụ địa phương. Đại diện cho một loại dịch vụ (chẳng hạn như install_faucet) mà Chiến dịch dịch vụ địa phương có thể nhắm đến.

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

string

Tên tài nguyên của tiêu chí.

BrandListInfo

Tiêu chí Danh sách thương hiệu được dùng để chỉ định một danh sách các thương hiệu. Danh sách này được biểu thị dưới dạng loại mã SharedSet BRAND_HINT. Bạn có thể nhắm mục tiêu hoặc loại trừ tiêu chí thuộc loại này.

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

string

Tên tài nguyên của nhóm dùng chung của danh sách thương hiệu.