An ad parameter that is used to update numeric values (such as prices or inventory levels) in any text line of an ad (including URLs). There can be a maximum of two AdParameters per ad group criterion. (One with parameter_index = 1 and one with parameter_index = 2.) In the ad the parameters are referenced by a placeholder of the form "{param#:value}". For example, "{param1:$17}"
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_parameter.ad_group_criterion
Field description
Immutable. The ad group criterion that this ad parameter belongs to.
Category
ATTRIBUTE
Data Type
RESOURCE_NAME
Type URL
N/A
Filterable
True
Selectable
True
Sortable
False
Repeated
False
ad_parameter.insertion_text
Field description
Numeric value to insert into the ad text. The following restrictions apply: - Can use comma or period as a separator, with an optional period or comma (respectively) for fractional values. For example, 1,000,000.00 and 2.000.000,10 are valid. - Can be prepended or appended with a currency symbol. For example, $99.99 is valid. - Can be prepended or appended with a currency code. For example, 99.99USD and EUR200 are valid. - Can use '%'. For example, 1.0% and 1,0% are valid. - Can use plus or minus. For example, -10.99 and 25+ are valid. - Can use '/' between two numbers. For example 4/1 and 0.95/0.45 are valid.
Category
ATTRIBUTE
Data Type
STRING
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
ad_parameter.parameter_index
Field description
Immutable. The unique index of this ad parameter. Must be either 1 or 2.
Category
ATTRIBUTE
Data Type
INT64
Type URL
N/A
Filterable
True
Selectable
True
Sortable
True
Repeated
False
ad_parameter.resource_name
Field description
Immutable. The resource name of the ad parameter. Ad parameter resource names have the form: customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}
[null,null,["Last updated 2025-03-03 UTC."],[[["Ad parameters update numeric values like prices or inventory in ad text, including URLs."],["There's a limit of two AdParameters per ad group criterion, with unique indexes (1 and 2)."],["In ads, parameters are referenced using placeholders like \"{param1:$17}\"."],["You can select fields from related resources like ad groups and campaigns in queries, but they won't segment metrics."],["Ad parameters have a specific resource name format: `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}`."]]],[]]
