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.

Fields

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}

display_name

string

Output only. The display name of the criterion.

This field is ignored for mutates.

type

CriterionType

Output only. The type of the criterion.

status

CampaignCriterionStatus

The status of the criterion.

campaign

string

Immutable. The campaign to which the criterion belongs.

criterion_id

int64

Output only. The ID of the criterion.

This field is ignored during mutate.

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.

negative

bool

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

criterion

Union field criterion. The campaign criterion.

criterion. The campaign criterion.

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

criterion can be only one of the following:

keyword

KeywordInfo

Immutable. Keyword.

placement

PlacementInfo

Immutable. Placement.

mobile_app_category

MobileAppCategoryInfo

Immutable. Mobile app category.

mobile_application

MobileApplicationInfo

Immutable. Mobile application.

location

LocationInfo

Immutable. Location.

device

DeviceInfo

Immutable. Device.

ad_schedule

AdScheduleInfo

Immutable. Ad Schedule.

age_range

AgeRangeInfo

Immutable. Age range.

gender

GenderInfo

Immutable. Gender.

income_range

IncomeRangeInfo

Immutable. Income range.

parental_status

ParentalStatusInfo

Immutable. Parental status.

user_list

UserListInfo

Immutable. User List.

youtube_video

YouTubeVideoInfo

Immutable. YouTube Video.

youtube_channel

YouTubeChannelInfo

Immutable. YouTube Channel.

proximity

ProximityInfo

Immutable. Proximity.

topic

TopicInfo

Immutable. Topic.

listing_scope

ListingScopeInfo

Immutable. Listing scope.

language

LanguageInfo

Immutable. Language.

ip_block

IpBlockInfo

Immutable. IpBlock.

content_label

ContentLabelInfo

Immutable. ContentLabel.

carrier

CarrierInfo

Immutable. Carrier.

user_interest

UserInterestInfo

Immutable. User Interest.

webpage

WebpageInfo

Immutable. Webpage.

operating_system_version

OperatingSystemVersionInfo

Immutable. Operating system version.

mobile_device

MobileDeviceInfo

Immutable. Mobile Device.

location_group

LocationGroupInfo

Immutable. Location Group

custom_affinity

CustomAffinityInfo

Immutable. Custom Affinity.

custom_audience

CustomAudienceInfo

Immutable. Custom Audience

combined_audience

CombinedAudienceInfo

Immutable. Combined Audience.

keyword_theme

KeywordThemeInfo

Immutable. Smart Campaign Keyword Theme.

local_service_id

LocalServiceIdInfo

Immutable. GLS service campaign criterion.

brand_list

BrandListInfo

Immutable. Brand list campaign criterion.

life_event

LifeEventInfo

Immutable. Life event campaign criterion.

webpage_list

WebpageListInfo

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

video_lineup

VideoLineupInfo

Immutable. Video lineup criterion.

extended_demographic

ExtendedDemographicInfo

Immutable. Extended demographic criterion.