This page is for users who maintain their Google tag in Google Tag Manager and want to define shared configuration settings that are valid for multiple Google tags.
What is a configuration settings variable?
You can reuse configuration settings across several Google tags using a Google tag: Configuration settingsvariable. For example, let's say you publish your website in multiple languages, and want to segment your audience according to the language they read in. You can create a configuration variable with a language
parameter and use it across your Google tags, instead of manually updating each tag.
How to set up a configuration settings variable
To create a new configuration settings variable:
- Open Google Tag Manager
- In your workspace, open the Variablesmenu on the left.
- Create a Newuser-defined variable.
- In Variable Configuration,select the Google tag: Configuration settingsvariable.
- Add the parameters you want to reuse. You can find a table of pre-defined parameters below. If none of these fit your needs, you can always create a custom parameter. Just type a name of your choice in the Namefield.
- Name your variable and Save.
Reuse settings in a Google tag
- In your workspace, open the Tagsmenu on the left.
- Select a Google tagyou want to apply a settings variable to.
- Reuse settings:
- To reuse Configuration settings, select a Google tag: Configuration settingsvariable from the dropdown list.
- To reuse Shared event settings, select a Google tag: Event settingsvariable from the dropdown list.
- To see what parameters were inherited from the settings variable, click Show inherited settings.
- To edit an inherited parameter for the Google tag only, click on Edit.
- To revert an edited inherited parameter, click Reset.
- Savethe tag and Publishthe container.
Valid parameters for configurations settings
The following table lists pre-defined parameters and which products you can use them with (marked by an x).
Name
Type
Default value
Description
Ads
GA4
Merchant Center
ads_data_redaction
boolean
false
Consent mode parameter to redact ad-click identifiers (e.g.
&gclid
, &dclid
, &wbraid
, etc.) from all requests when consent is denied.x
allow_ad_personalization_signals
boolean
true
Set to
false
to disable advertising personalization features.x
x
x
allow_google_signals
boolean
true
The default value is
true
. To disable all advertising features, set allow_google_signals
to false
.x
x
allow_interest_groups
boolean
true
x
x
x
campaign_content
string
undefined
Used for A/B testing and content-targeted ads. Use
Note:Setting this value will override the
campaign_content
to differentiate ads or links that point to the same URL.Note:Setting this value will override the
utm_content
query parameter.x
x
campaign_id
string
undefined
Used to identify which campaign this referral references. Use
Note:Setting this value will override the
campaign_id
to identify a specific campaign.Note:Setting this value will override the
utm_id
query parameter.x
x
campaign_medium
string
undefined
Use
Note:Setting this value will override the
campaign_medium
to identify a medium such as email or cost-per-click.Note:Setting this value will override the
utm_medium
query parameter.x
x
campaign_name
string
undefined
Used for keyword analysis. Use
Note:Setting this value will override the
campaign_name
to identify a specific product promotion or strategic campaign.Note:Setting this value will override the
utm_name
query parameter.x
x
campaign_source
string
undefined
Use
Note:Setting this value will override the
campaign_source
to identify a search engine, newsletter name, or other source.Note:Setting this value will override the
utm_source
query parameter.x
x
campaign_term
string
undefined
Used for paid search. Use
Note:Setting this value will override the
campaign_term
to note the keywords for this ad.Note:Setting this value will override the
utm_term
query parameter.x
x
client_id
string
A randomly generated value for each user.
Pseudonymously identifies a browser instance. By default, this value is stored as part of the first-party Analytics cookie with a two-year expiration.
x
content_group
string
undefined
Content groups let you categorize pages and screens into custom buckets. Learn more about content groups
.
x
conversion_linker
boolean
true
Use this parameter to opt out of conversion linking for Ads and Floodlight. When set to
false
, you can opt-out of conversion linking.x
cookie_domain
string
'auto'
Specifies the domain used to store the analytics cookie.
To set the cookie without specifying a domain, set to
Set to
To set the cookie without specifying a domain, set to
'none'
.Set to
'auto'
(the default value) to set the cookie to the top level domain plus one subdomain (eTLD +1). For example if cookie_domain
is set to 'auto'
https://example.com
would use example.com
for the domain, and https://subdomain.example.com
would also use example.com
for the domain.x
x
x
cookie_expires
number
63072000
Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the current time plus the value of the
cookie_expires
field. This means that if you use the default value time of two years ( 63072000
seconds), and a user visits your site every month, their cookie will never expire. If you set the cookie_expires
time to 0 (zero) seconds, the cookie turns into a session based cookie and expires once the current browser session ends. Caution:If you set the cookie to expire too quickly, you will inflate your user count and decrease the quality of your measurement.x
x
x
cookie_flags
string
undefined
Appends additional flags to the cookie when set. Flags must be separated by semicolons. See write a new cookie
for some examples of flags to set.
x
x
x
cookie_path
string
'/'
Specifies the subpath used to store the Google tag cookie.
x
x
x
cookie_prefix
string
undefined
Specifies a prefix to prepend to ads and analytics cookie names. For example, you can rename ads cookies starting with
_gcl_aw
to <your-prefix>_aw.
x
x
x
cookie_update
boolean
true
When
cookie_update
is set to true
: - GA4 and Merchant Center update cookies on each page load. This will update the cookie expiration to be set relative to the most recent visit to the site. For example, if cookie expiration is set to one week, and a user visits using the same browser every five days, the cookie expiration will be updated on each visit and will effectively never expire.
- Ads and Floodlight update cookies with the original expiration date, so it is still relevant to the first visit.
false
, cookies are not updated on each page load. This has the effect of cookie expiration being relative to the first time a user visited the site.x
x
x
customer_lifetime_value
string
undefined
Specifies a time frame in which a customer counts as a repeated customer.
x
string
undefined
You can create a group of targets (e.g. products, accounts, and properties) and then route events to that group. To send events to a group, you need to set the
send_to
parameter in an event tag.x
x
x
ignore_referrer
boolean
false
Set to
true
to indicate to Analytics that the referrer shouldn't be displayed as a traffic source. Learn when to use this field
.x
x
new_customer
boolean
undefined
Reports new customer acquisitions from your Ads campaigns. See the Google Ads help
for implementation details.
x
page_hostname
string
Sets the hostname of your site. This parameter allows you to override the automatic value.
x
x
page_location
string
Specifies the full URL of the page. This parameter allows you to override the automatic value.
x
x
x
page_path
string
Specifies the page path (the string after
/
).This parameter allows you to override the automatic value.x
x
page_referrer
string
Specifies which referral source brought traffic to a page. This value is also used to compute the traffic source. This parameter allows you to override the automatic value.
x
x
x
page_title
string
The title of the page or document. This parameter allows you to override the automatic value.
x
x
x
send_page_view
boolean
true
Set to false
to prevent the default snippet from sending a page_view
event.
Note:This won’t affect enhanced measurement
from sending page_view
events based on the page’s history changes.
x
screen_resolution
string
Specifies the resolution of the screen. Should be two positive integers separated by an x. For example, for an 800px by 600px screen, the value would be "800x600". Calculated from the user's
window.screen
value.x
x
server_container_url
string
undefined
x
x
x
user_id
string
undefined
Specifies a known identifier for a user provided by the site owner/library user. It must not itself be PII (personally identifiable information). The value should never be persisted in Google Analytics cookies or other Analytics provided storage. Character limit = 256.
x
user_properties
object
undefined
User properties
are attributes that can be used to describe segments of your user base, such as language preference or geographic location. Up to 25 additional user properties can be set per project. Learn how to set up user properties
.
x
