Reuse event settings in Google Tag Manager

This page is for users who maintain their Google tag in Google Tag Manager and want to define event-level settings.

What is an event settings variable?

You can reuse event settings across several Google tags and GA4 Event tags using a Google Tag: Event Settings variable.
For example, suppose you own an online store and you are having a sale. Now, you would like to track how many people use the discount code that you provided them. Instead of adding a discount parameter to each of your tags manually, you can reuse the parameter with a Google Tag: Event Settings variable.

How to use an event settings variable

To create a new event settings variable:

  1. Open Google Tag Manager
  2. In your workspace, open the Variables menu on the left.
  3. Create a New user-defined variable.
  4. In Variable Configuration, select the Google Tag: Event Settings variable.
  5. 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.
  6. Optional: Add Google Analytics User Properties to your event:
    1. Under Google Analytics User Properties, click Add Property.
    2. Set up the key-value pair to send with the event:
      • Set Property Name to the category you want to send, for example, favorite_food.

      • Set Value to the user-specific data, for example, apple.
  7. Name your variable and Save.

Reuse settings in a Google tag

To send event-level parameters with every event, use the event settings variable in a Google tag.

  1. In your workspace, open the Tags menu on the left.
  2. Select a Google tag you want to apply a settings variable to.
  3. 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 .
  4. Save the tag and Publish the container.

 

Reuse settings in a GA4 Event tag

To send event-level parameters for only for select GA4 events, add the event settings variable to a GA4 Event tag.

  1. In your workspace, open the Tags menu on the left.
  2. Select a GA4 Event tag you want to apply a settings variable to.
  3. Reuse settings:
    • To reuse 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 .
  4. Save the tag and Publish the container.

Valid parameters for event settings

The following table lists pre-defined parameters and which products you can use them with (marked by an x). These are not event names. For a list of predefined event names, see the recommended events reference.

Name Type Default value Description Ads GA4 Merchant Center
achievement_id string undefined The id of the achievement that was unlocked. Part of the unlock_achievement event to measure game experience.   x  
aw_feed_country string undefined The country associated with the feed where your items are uploaded. Use CLDR territory codes, for example, 'US'.
Part of Conversions with Cart Data reporting.
x    
aw_language string undefined The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Part of Conversions with Cart Data reporting. x    
aw_merchant_id integer undefined The Merchant Center ID. Provide this parameter if you keep an item in several Merchant Center accounts and you want to control from which Merchant Center the item's data, for example, its COGS, should be read. Part of Conversions with Cart Data reporting. x    
content_group string undefined Content groups let you categorize pages and screens into custom buckets. Learn more   x x
content_id string undefined An identifier for the content that was selected, for example, C_12345. Part of the select_content event.   x x
content_type string undefined The type of content, for example 'image'. Part of the share and select_content event.   x  
coupon string undefined The coupon name/code associated with the event.

Event-level and item-level coupon parameters are independent.
  x  
country string undefined Parameter to capture the user's country. Use ISO 3166-1 alpha-2 format. (For example, 'US' for United States) x    
currency string undefined Currency of the items associated with the event, in 3-letter ISO 4217 format.
* If you set value then currency is required for revenue metrics to be computed accurately.
x x x
delivery_postal_code number undefined The regional prefix, or designation portion, of a postal code for an order's shipping address. The regional prefix is used to determine the merchant's on-time performance.
When submitting this data, we recommend only including the first 3 digits of a zip code.
Part of Ads conversion tracking to validate shipping data.
x   x
discount number undefined The monetary discount value associated with the item. x x  
estimated_delivery_date string undefined The latest (or "max") promised delivery date for an order in a customer's cart data. For orders with products that are under consideration for free and fast delivery (new or maintain status), Google uses this date to validate shipping speed.
Note: This parameter uses the international date format (YYYY-MM-DD). The date you submit here should be based on the date and time zone of the location you submitted for the delivery_postal_code.

Part of Ads conversion tracking to validate shipping data.
x    
group_id string undefined The ID of the group, for example, G_12345. Part of the join_group event used to measure how popular certain groups or social features are.   x  
items array<Item> undefined Lists the items for the event. This is an ecommerce parameter that has sub-parameters. You can find the sub-parameters for: x x x
language string navigator.language Specifies the language preference of the user. x x x
method string undefined The method a user chooses to do something, for example 'email'. Part of the login, share, and sign_up event.   x  
payment_type string undefined A customer's chosen payment method, for example, 'credit card'.   x  
score number undefined The user's score. Part of the post_score event to measure scores in games.   x  
search_term string undefined The term that was searched for. Part of the search event.   x  
send_to string undefined Specifies a Google tag destination ID. To be used together with the groups configuration parameter. x x x
shipping number undefined Shipping cost associated with a transaction, for example, 4.99. x x x
shipping_tier string undefined The shipping tier (e.g. 'Ground', 'Air', 'Next-day') selected for delivery of the purchased item. x x x
tax number undefined Tax cost associated with a transaction, for example, 1.11.   x x
transaction_id string undefined The unique identifier of a transaction, for example, T_12345.

The transaction_id parameter helps you avoid getting duplicate events for a purchase.
x x x
user_data object undefined Parameter to opt-out of automatic user-provided data collection.
To opt out for select pages, set user_data to null. To opt-out of user-defined data collection altogether, use the Google tag setting.
x    
user_properties object undefined Parameter to send additional Google Analytics User Properties with an event. Learn how to set up user properties.   x  
value number undefined The monetary value of the event, for example, 12.99.

value is required for meaningful reporting and to populate the purchasers predictive audience.

* If you set value, you also need to set currency.
x x x
virtual_currency_name string undefined The name of the virtual currency. Part of the earn_virtual_currency and spend_virtual_currency
events.
  x  

Related resources

 

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
16125526961345287637
true
Search Help Center
true
true
true
true
true
69256