CampaignCriterion

  • A campaign criterion defines targeting or exclusion parameters for a campaign.

  • Key fields include resource name, display name, type, status, and the associated campaign and criterion ID.

  • The bid modifier adjusts bids based on matching criteria.

  • The negative field determines whether the criterion is used for targeting or exclusion.

  • Various types of criteria can be used, such as keywords, locations, devices, demographics, and audiences.

A campaign criterion.

Proto definition

Fields

bid_modifier

float

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.

campaign

string

Immutable. The campaign to which the criterion belongs.

criterion

Union field. The campaign criterion.

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

ad_schedule

AdScheduleInfo

Immutable. Ad Schedule.

age_range

AgeRangeInfo

Immutable. Age range.

brand_list

BrandListInfo

Immutable. Brand list campaign criterion.

carrier

CarrierInfo

Immutable. Carrier.

combined_audience

CombinedAudienceInfo

Immutable. Combined Audience.

content_label

ContentLabelInfo

Immutable. ContentLabel.

custom_affinity

CustomAffinityInfo

Immutable. Custom Affinity.

custom_audience

CustomAudienceInfo

Immutable. Custom Audience

device

DeviceInfo

Immutable. Device.

extended_demographic

ExtendedDemographicInfo

Immutable. Extended demographic criterion.

gender

GenderInfo

Immutable. Gender.

income_range

IncomeRangeInfo

Immutable. Income range.

ip_block

IpBlockInfo

Immutable. IpBlock.

You can exclude up to 500 IP addresses per campaign.

keyword

KeywordInfo

Immutable. Keyword.

keyword_theme

KeywordThemeInfo

Immutable. Smart Campaign Keyword Theme.

language

LanguageInfo

Immutable. Language.

life_event

LifeEventInfo

Immutable. Life event campaign criterion.

listing_scope

ListingScopeInfo

Immutable. Listing scope.

local_service_id

LocalServiceIdInfo

Immutable. GLS service campaign criterion.

location

LocationInfo

Immutable. Location.

location_group

LocationGroupInfo

Immutable. Location Group

mobile_app_category

MobileAppCategoryInfo

Immutable. Mobile app category.

mobile_application

MobileApplicationInfo

Immutable. Mobile application.

mobile_device

MobileDeviceInfo

Immutable. Mobile Device.

operating_system_version

OperatingSystemVersionInfo

Immutable. Operating system version.

parental_status

ParentalStatusInfo

Immutable. Parental status.

placement

PlacementInfo

Immutable. Placement.

proximity

ProximityInfo

Immutable. Proximity.

topic

TopicInfo

Immutable. Topic.

user_interest

UserInterestInfo

Immutable. User Interest.

user_list

UserListInfo

Immutable. User List.

video_lineup

VideoLineupInfo

Immutable. Video lineup criterion.

webpage

WebpageInfo

Immutable. Webpage.

webpage_list

WebpageListInfo

Immutable. Webpage list. This criterion is not publicly available.

youtube_channel

YouTubeChannelInfo

Immutable. YouTube Channel.

youtube_video

YouTubeVideoInfo

Immutable. YouTube Video.

criterion_id

int64

Output only. The ID of the criterion.

This field is ignored during mutate.

display_name

string

Output only. The display name of the criterion.

This field is ignored for mutates.

negative

bool

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

resource_name

string

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

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

status

CampaignCriterionStatus

The status of the criterion.

type

CriterionType

Output only. The type of the criterion.