CampaignCriterion

A campaign criterion.

JSON representation
{
  "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.
}
Fields
resourceName

string

Immutable. The resource name of the campaign criterion. Campaign criterion resource names have the form:

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

displayName

string

Output only. The display name of the criterion.

This field is ignored for mutates.

type

enum (CriterionType)

Output only. The type of the criterion.

status

enum (CampaignCriterionStatus)

The status of the criterion.

campaign

string

Immutable. The campaign to which the criterion belongs.

criterionId

string (int64 format)

Output only. The ID of the criterion.

This field is ignored during mutate.

bidModifier

number

The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.

negative

boolean

Immutable. Whether to target (false) or exclude (true) the criterion.

Union field criterion. The campaign criterion.

Exactly one must be set. criterion can be only one of the following:

keyword

object (KeywordInfo)

Immutable. Keyword.

placement

object (PlacementInfo)

Immutable. Placement.

mobileAppCategory

object (MobileAppCategoryInfo)

Immutable. Mobile app category.

mobileApplication

object (MobileApplicationInfo)

Immutable. Mobile application.

location

object (LocationInfo)

Immutable. Location.

device

object (DeviceInfo)

Immutable. Device.

adSchedule

object (AdScheduleInfo)

Immutable. Ad Schedule.

ageRange

object (AgeRangeInfo)

Immutable. Age range.

gender

object (GenderInfo)

Immutable. Gender.

incomeRange

object (IncomeRangeInfo)

Immutable. Income range.

parentalStatus

object (ParentalStatusInfo)

Immutable. Parental status.

userList

object (UserListInfo)

Immutable. User List.

youtubeVideo

object (YouTubeVideoInfo)

Immutable. YouTube Video.

youtubeChannel

object (YouTubeChannelInfo)

Immutable. YouTube Channel.

proximity

object (ProximityInfo)

Immutable. Proximity.

topic

object (TopicInfo)

Immutable. Topic.

listingScope

object (ListingScopeInfo)

Immutable. Listing scope.

language

object (LanguageInfo)

Immutable. Language.

ipBlock

object (IpBlockInfo)

Immutable. IpBlock.

contentLabel

object (ContentLabelInfo)

Immutable. ContentLabel.

carrier

object (CarrierInfo)

Immutable. Carrier.

userInterest

object (UserInterestInfo)

Immutable. User Interest.

webpage

object (WebpageInfo)

Immutable. Webpage.

operatingSystemVersion

object (OperatingSystemVersionInfo)

Immutable. Operating system version.

mobileDevice

object (MobileDeviceInfo)

Immutable. Mobile Device.

locationGroup

object (LocationGroupInfo)

Immutable. Location Group

customAffinity

object (CustomAffinityInfo)

Immutable. Custom Affinity.

customAudience

object (CustomAudienceInfo)

Immutable. Custom Audience

combinedAudience

object (CombinedAudienceInfo)

Immutable. Combined Audience.

keywordTheme

object (KeywordThemeInfo)

Immutable. Smart Campaign Keyword Theme.

localServiceId

object (LocalServiceIdInfo)

Immutable. GLS service campaign criterion.

brandList

object (BrandListInfo)

Immutable. Brand list campaign criterion.

CampaignCriterionStatus

The possible statuses of a CampaignCriterion.

Enums
UNSPECIFIED No value has been specified.
UNKNOWN

The received value is not known in this version.

This is a response-only value.

ENABLED The campaign criterion is enabled.
PAUSED The campaign criterion is paused.
REMOVED The campaign criterion is removed.

ListingScopeInfo

A listing scope criterion.

JSON representation
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Fields
dimensions[]

object (ListingDimensionInfo)

Scope of the campaign criterion.

CarrierInfo

Represents a Carrier Criterion.

JSON representation
{
  "carrierConstant": string
}
Fields
carrierConstant

string

The Carrier constant resource name.

OperatingSystemVersionInfo

Represents an operating system version to be targeted.

JSON representation
{
  "operatingSystemVersionConstant": string
}
Fields
operatingSystemVersionConstant

string

The operating system version constant resource name.

MobileDeviceInfo

A mobile device criterion.

JSON representation
{
  "mobileDeviceConstant": string
}
Fields
mobileDeviceConstant

string

The mobile device constant resource name.

LocationGroupInfo

A radius around a list of locations specified through a feed or assetSet.

JSON representation
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
Fields
geoTargetConstants[]

string

Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. Cannot be set with AssetSet fields.

radiusUnits

enum (LocationGroupRadiusUnits)

Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets and asset sets. This is required and must be set in CREATE operations.

feedItemSets[]

string

FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geoTargetConstants. This is optional and can only be set in CREATE operations. Cannot be set with AssetSet fields.

locationGroupAssetSets[]

string

AssetSets whose Assets are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or enableCustomerLevelLocationAssetSet should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.

feed

string

Feed specifying locations for targeting. Cannot be set with AssetSet fields. This is required and must be set in CREATE operations.

radius

string (int64 format)

Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations.

enableCustomerLevelLocationAssetSet

boolean

Denotes that the latest customer level asset set is used for targeting. Used with radius and radiusUnits. Cannot be used with feed, geo target constants or feed item sets. When using asset sets, either this field or locationGroupAssetSets should be specified. Both cannot be used at the same time. This can only be set in CREATE operations.

LocationGroupRadiusUnits

The unit of radius distance in location group (for example, MILES)

Enums
UNSPECIFIED Not specified.
UNKNOWN Used for return value only. Represents value unknown in this version.
METERS Meters
MILES Miles
MILLI_MILES Milli Miles

LocalServiceIdInfo

A Local Services Ads service ID. Represents a service type (such as install_faucet) that a Local Services Campaign can target.

JSON representation
{
  "serviceId": string
}
Fields
serviceId

string

The criterion resource name.

BrandListInfo

A Brand List Criterion is used to specify a list of brands. The list is represented as a SharedSet id type BRAND_HINT. A criterion of this type can be either targeted or excluded.

JSON representation
{
  "sharedSet": string
}
Fields
sharedSet

string

Shared set resource name of the brand list.