What is a configuration settings variable?
You can reuse configuration settings across several Google tags using a Google tag: Configuration settings variable. 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 Variables menu on the left.
- Create a New user-defined variable.
- In Variable Configuration, select the Google tag: Configuration settings variable.
- 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 Name field.
- Name your variable and Save.
Reuse settings in a Google tag
- In your workspace, open the Tags menu on the left.
- Select a Google tag you want to apply a settings variable to.
- Reuse settings:
- To reuse Configuration settings, select a Google tag: Configuration settings variable from the dropdown list.
- To reuse Shared event settings, select a Google tag: Event settings variable 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 .
- Save the tag and Publish the 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 |
A privacy sandbox API setting to allow opting out of storing interest group data. | x | x | x |
campaign_content | string | undefined | Used for A/B testing and content-targeted ads. Use 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 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 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 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 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 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 '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 :
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 | ||
groups | 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 | |
language | string | navigator.language |
Specifies the language preference of the user. | x | 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 | location.hostname |
Sets the hostname of your site. This parameter allows you to override the automatic value. | x | x | |
page_location | string | document.location |
Specifies the full URL of the page. This parameter allows you to override the automatic value. | x | x | x |
page_path | string | location.pathname |
Specifies the page path (the string after / ).This parameter allows you to override the automatic value. |
x | x | |
page_referrer | string | document.referrer |
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 | document.title |
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. |
x | ||
screen_resolution | string | window.screen | 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 | Specifies the URL of a tagging server. Learn more about server-side tagging. | 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 |