ad_group_customizer

  • An ad group customizer provides a customizer value for an associated CustomizerAttribute at the AdGroup level.

  • You can select fields from ad_group, campaign, customer, and customizer_attribute resources along with ad_group_customizer fields in your SELECT and WHERE clauses.

  • The resource name for an ad group customizer follows the format customers/{customer_id}/adGroupCustomizers/{ad_group_id}~{customizer_attribute_id}.

  • The ad group customizer includes fields for linking to the ad group and the customizer attribute, its status, and the customizer value with its type and string representation.

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

Attributed resources
ad_group
campaign
customer
customizer_attribute

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

ad_group_customizer.ad_group

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

ad_group_customizer.customizer_attribute

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

ad_group_customizer.resource_name

Field descriptionImmutable. The resource name of the ad group customizer. Ad group customizer resource names have the form: customers/{customer_id}/adGroupCustomizers/{ad_group_id}~{customizer_attribute_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

ad_group_customizer.status

Field descriptionOutput only. The status of the ad group customizer.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v22.enums.CustomizerValueStatusEnum.CustomizerValueStatus
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

ad_group_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

ad_group_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
Type URLgoogle.ads.googleads.v22.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse