Join us live onDiscord on the Google Advertising and Measurement Community server and onYouTube on February 26th at 10:00 AM EST! We will discuss the new features added in v23.1 of the Google Ads API.

campaign_customizer

  • Campaign Customizers are customizer values at the Campaign level associated with a CustomizerAttribute.

  • Fields from campaign, customer, and customizer_attribute resources can be selected along with campaign customizer fields in SELECT and WHERE clauses.

  • These attributed resource fields will not segment metrics in the SELECT clause.

  • Key fields includecampaign,customizer_attribute,resource_name,status, andvalue.

  • Thevalue field has astring_value and atype, both of which are required and must match the associated attribute type.

A customizer value for the associated CustomizerAttribute at the Campaign level.

Attributed resources
campaign
customer
customizer_attribute

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fieldswill not segment metrics in yourSELECT clause.

campaign_customizer.campaign

Field descriptionImmutable. The campaign to which the customizer attribute is linked.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_customizer.customizer_attribute

Field descriptionRequired. Immutable. The customizer attribute which is linked to the campaign.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_customizer.resource_name

Field descriptionImmutable. The resource name of the campaign customizer. Campaign customizer resource names have the form:customers/{customer_id}/campaignCustomizers/{campaign_id}~{customizer_attribute_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_customizer.status

Field descriptionOutput only. The status of the campaign customizer.
CategoryATTRIBUTE
Data Type

ENUM

ENABLED
REMOVED
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.googleads.v22.enums.CustomizerValueStatusEnum.CustomizerValueStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_customizer.value.string_value

Field descriptionRequired. Value to insert in creative text. Customizer values of all types are stored as string to make formatting unambiguous.
CategoryATTRIBUTE
Data TypeSTRING
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_customizer.value.type

Field descriptionRequired. The data type for the customizer value. It must match the attribute type. The string_value content must match the constraints associated with the type.
CategoryATTRIBUTE
Data Type

ENUM

NUMBER
PERCENT
PRICE
TEXT
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.googleads.v22.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-29 UTC.