{"id":95383,"date":"2025-02-18T10:51:44","date_gmt":"2025-02-18T10:51:44","guid":{"rendered":"https:\/\/peraltafinancing.com\/analytics\/user-distributor-custom-tag-template-for-google-tag-manager\/"},"modified":"2025-02-18T10:51:44","modified_gmt":"2025-02-18T10:51:44","slug":"user-distributor-custom-tag-template-for-google-tag-manager","status":"publish","type":"post","link":"https:\/\/fivemor.com\/?p=95383","title":{"rendered":"User Distributor Custom Tag Template For Google Tag Manager"},"content":{"rendered":"


\n<\/p>\n

\n

I\u2019ve enjoyed working with custom templates<\/a> for Google Tag Manager<\/a>. A lot. So much so that whenever the need to add some custom code to a container emerges, my first thought is how to turn that into a custom template.<\/p>\n

Google has been forthcoming in introducing new APIs<\/a> steadily, and I think the variety of things you can do with template is improving with every new API release.<\/p>\n

In this article, I\u2019ll show you how to use a simple tag template for distributing your users to groups, based on a random split.<\/p>\n

\n

<\/p>\n

\"User<\/p>\n

<\/a><\/p>\n<\/div>\n

You can download and\/or install the template here<\/a>.<\/p>\n


\n X<\/span><\/p>\n

\n
\n The Simmer Newsletter<\/strong>\n <\/p>\n

\n Subscribe to the Simmer newsletter<\/a> to get the latest news and content from Simo Ahava into your email inbox!\n <\/p>\n

<\/span><\/p>\n

How it works<\/h2>\n

When you create a tag from the template, you have two options.<\/p>\n

1. Single distribution<\/h3>\n

If you choose to create a single<\/strong> distribution, you indicate an integer percent value between 1 and 100 (inclusive). When the tag fires, a randomizer will pull a number in that range, and if the number falls into the range you gave, a cookie named _gtm_group<\/code> will be written with the value \"true\"<\/code>.<\/p>\n

\n

<\/p>\n

\"Single<\/p>\n

<\/a><\/p>\n<\/div>\n

You can use this cookie to sample<\/strong> your visitors, for example, to keep your data collection below quotas or limitations imposed by the platforms you use.<\/p>\n

If the number does not fall into the distribution, the cookie will be set with the value false<\/strong>. This is to make sure the cookie is set just once per browser.<\/p>\n

How to use<\/h4>\n

If you set this tag to fire with the All Pages trigger, then all your users will be assigned to either the true<\/strong> bucket or the false<\/strong> bucket. Then, you can create a First Party Cookie variable for _gtm_group<\/code> like this:<\/p>\n

\n

<\/p>\n

\"First<\/p>\n

<\/a><\/p>\n<\/div>\n

You can check for this cookie value in your triggers to make sure your tags only fire for those included in the group:<\/p>\n

{{First party cookie}}<\/strong> equals true<\/code><\/p>\n

Or, conversely, you can switch the value check to false<\/code> to fire your tags only for those who were \u201csampled out\u201d.<\/p>\n

2. Multi distribution<\/h3>\n

The multi<\/strong> distribution lets you create different groups<\/strong>, where each group has a probability weight of including the user. You add the groups as rows in the table, where the Group value<\/strong> is what the _gtm_group<\/code> cookie will receive as a value, and Distribution<\/strong> is the percentage weight (out of 100) you want to assign to the group.<\/p>\n

\n

<\/p>\n

\"Multi<\/p>\n

<\/a><\/p>\n<\/div>\n

The distributions\u2019 sum should not exceed 100<\/strong>. The groups are processed from top to bottom, so if the sum of distributions is over 100, the groups at the end of the table will not get their distribution probabilities met.<\/p>\n

The sum can<\/strong> be under 100. It just means that there will be a probability distribution that does not set the cookie at all.<\/p>\n

For example, let\u2019s say you have the following items:<\/p>\n\n\n\n\n\n\n\n\n\n
Group value<\/th>\nDistribution<\/th>\n<\/tr>\n<\/thead>\n
control<\/td>\n10<\/td>\n<\/tr>\n
variation1<\/td>\n20<\/td>\n<\/tr>\n
variation2<\/td>\n20<\/td>\n<\/tr>\n
variation3<\/td>\n20<\/td>\n<\/tr>\n
variation4<\/td>\n20<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

When the tag fires, it randomizes an integer between 1 and 100 (inclusive). This number is then checked against the groups, starting from the top, and calculating the distribution as increments until 100 is reached.<\/p>\n

For example, if the random number is 15<\/strong>., it gets included in the group variation1<\/strong>, because that group would include values between 11<\/strong> and 30<\/strong>.<\/p>\n

If the random number is 68<\/strong>, it gets included in the group variation3<\/strong>, because that group would include values between 51<\/strong> and 70<\/strong>.<\/p>\n

If the random number is 93<\/strong>, it doesn\u2019t get included in any group and the cookie is not set.<\/p>\n

How to use<\/h4>\n

Similar to the single distribution, you can create a First Party Cookie<\/strong> and use that to selectively fire your tags depending on which group the user is in. You can also use this to create distributions for A\/B-testing, in case you want to control what type of content to show to users in different groups.<\/p>\n

Cookie settings<\/h3>\n

By expanding the Cookie settings<\/strong> group, you can change details about the cookie that is set.<\/p>\n

\n

<\/p>\n

\"Cookie<\/p>\n

<\/a><\/p>\n<\/div>\n

The default values are:<\/p>\n

Cookie name<\/strong>: _gtm_group<\/code><\/p>\n

Cookie domain<\/strong>: auto<\/code><\/p>\n

Cookie maximum age (in days)<\/strong>: 365<\/code><\/p>\n

Having auto<\/code> in the cookie domain fields means GTM will attempt to write the cookie on the highest domain name in the hierarchy it can. So if the user is browsing sub.domain.co.uk<\/code>, GTM will write the cookie on domain.co.uk<\/code>.<\/p>\n

Note that if you change the cookie name, **you must edit the template permissions<\/a> to allow GTM to read<\/strong> and write<\/strong> the new cookie name.<\/p>\n

\n

<\/p>\n

\"Cookie<\/p>\n

<\/a><\/p>\n<\/div>\n

Summary<\/h2>\n

I hope you find this template useful. It\u2019s not an exact science – the random number distribution isn\u2019t necessarily the most robust thing in the world, and as with anything random, you need enough data to avoid outliers in the distribution.<\/p>\n

But especially for sampling, it should be close enough for comfort.<\/p>\n

Let me know in the comments if you have suggestions for improving the template!<\/p>\n<\/p><\/div>\n\n","protected":false},"excerpt":{"rendered":"

I\u2019ve enjoyed working with custom templates for Google Tag Manager. A lot. So much so that whenever the need to add some custom code to a container emerges, my first thought is how to turn that into a custom template. Google has been forthcoming in introducing new APIs steadily, and I think the variety of […]<\/p>\n","protected":false},"author":1,"featured_media":95384,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[12033],"tags":[834,42977,1531,14495,1791,4196,21854],"dealstore":[],"offerexpiration":[],"class_list":["post-95383","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-analytics","tag-custom","tag-distributor","tag-google","tag-manager","tag-tag","tag-template","tag-user"],"yoast_head":"\nUser Distributor Custom Tag Template For Google Tag Manager - Som2ny Network<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/fivemor.com\/?p=95383\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"User Distributor Custom Tag Template For Google Tag Manager - Som2ny Network\" \/>\n<meta property=\"og:description\" content=\"I\u2019ve enjoyed working with custom templates for Google Tag Manager. A lot. So much so that whenever the need to add some custom code to a container emerges, my first thought is how to turn that into a custom template. Google has been forthcoming in introducing new APIs steadily, and I think the variety of […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/fivemor.com\/?p=95383\" \/>\n<meta property=\"og:site_name\" content=\"Som2ny Network\" \/>\n<meta property=\"article:published_time\" content=\"2025-02-18T10:51:44+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2560\" \/>\n\t<meta property=\"og:image:height\" content=\"1275\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"admin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/fivemor.com\/?p=95383#article\",\"isPartOf\":{\"@id\":\"https:\/\/fivemor.com\/?p=95383\"},\"author\":{\"name\":\"admin\",\"@id\":\"https:\/\/fivemor.com\/#\/schema\/person\/b85e3c3dc0e1daea076524dc8810c371\"},\"headline\":\"User Distributor Custom Tag Template For Google Tag Manager\",\"datePublished\":\"2025-02-18T10:51:44+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/fivemor.com\/?p=95383\"},\"wordCount\":799,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/fivemor.com\/#organization\"},\"image\":{\"@id\":\"https:\/\/fivemor.com\/?p=95383#primaryimage\"},\"thumbnailUrl\":\"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg\",\"keywords\":[\"Custom\",\"Distributor\",\"Google\",\"Manager\",\"TAG\",\"Template\",\"User\"],\"articleSection\":[\"Analytics\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/fivemor.com\/?p=95383#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/fivemor.com\/?p=95383\",\"url\":\"https:\/\/fivemor.com\/?p=95383\",\"name\":\"User Distributor Custom Tag Template For Google Tag Manager - Som2ny Network\",\"isPartOf\":{\"@id\":\"https:\/\/fivemor.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/fivemor.com\/?p=95383#primaryimage\"},\"image\":{\"@id\":\"https:\/\/fivemor.com\/?p=95383#primaryimage\"},\"thumbnailUrl\":\"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg\",\"datePublished\":\"2025-02-18T10:51:44+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/fivemor.com\/?p=95383#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/fivemor.com\/?p=95383\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/fivemor.com\/?p=95383#primaryimage\",\"url\":\"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg\",\"contentUrl\":\"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg\",\"width\":2560,\"height\":1275},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/fivemor.com\/?p=95383#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/fivemor.com\/?bp_activities=1\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"User Distributor Custom Tag Template For Google Tag Manager\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/fivemor.com\/#website\",\"url\":\"https:\/\/fivemor.com\/\",\"name\":\"Som2ny Network\",\"description\":\"Daily Deals\",\"publisher\":{\"@id\":\"https:\/\/fivemor.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/fivemor.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/fivemor.com\/#organization\",\"name\":\"Som2ny Network\",\"url\":\"https:\/\/fivemor.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/fivemor.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/fivemor.com\/wp-content\/uploads\/2026\/07\/4a0953c4-logo-300x86-1.png\",\"contentUrl\":\"https:\/\/fivemor.com\/wp-content\/uploads\/2026\/07\/4a0953c4-logo-300x86-1.png\",\"width\":300,\"height\":86,\"caption\":\"Som2ny Network\"},\"image\":{\"@id\":\"https:\/\/fivemor.com\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/fivemor.com\/#\/schema\/person\/b85e3c3dc0e1daea076524dc8810c371\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/fivemor.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/729ae85bf62b9917e93538db2f2688ca?s=96&r=g&default=https%3A%2F%2Ffivemor.com%2Fwp-content%2Fplugins%2Fbuddypress-first-letter-avatar%2Fimages%2Fdefault%2F96%2Flatin_a.png\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/729ae85bf62b9917e93538db2f2688ca?s=96&r=g&default=https%3A%2F%2Ffivemor.com%2Fwp-content%2Fplugins%2Fbuddypress-first-letter-avatar%2Fimages%2Fdefault%2F96%2Flatin_a.png\",\"caption\":\"admin\"},\"sameAs\":[\"https:\/\/fivemor.com\"],\"url\":\"https:\/\/fivemor.com\/?author=1\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"User Distributor Custom Tag Template For Google Tag Manager - Som2ny Network","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/fivemor.com\/?p=95383","og_locale":"en_US","og_type":"article","og_title":"User Distributor Custom Tag Template For Google Tag Manager - Som2ny Network","og_description":"I\u2019ve enjoyed working with custom templates for Google Tag Manager. A lot. So much so that whenever the need to add some custom code to a container emerges, my first thought is how to turn that into a custom template. Google has been forthcoming in introducing new APIs steadily, and I think the variety of […]","og_url":"https:\/\/fivemor.com\/?p=95383","og_site_name":"Som2ny Network","article_published_time":"2025-02-18T10:51:44+00:00","og_image":[{"width":2560,"height":1275,"url":"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg","type":"image\/jpeg"}],"author":"admin","twitter_card":"summary_large_image","twitter_misc":{"Written by":"admin","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/fivemor.com\/?p=95383#article","isPartOf":{"@id":"https:\/\/fivemor.com\/?p=95383"},"author":{"name":"admin","@id":"https:\/\/fivemor.com\/#\/schema\/person\/b85e3c3dc0e1daea076524dc8810c371"},"headline":"User Distributor Custom Tag Template For Google Tag Manager","datePublished":"2025-02-18T10:51:44+00:00","mainEntityOfPage":{"@id":"https:\/\/fivemor.com\/?p=95383"},"wordCount":799,"commentCount":0,"publisher":{"@id":"https:\/\/fivemor.com\/#organization"},"image":{"@id":"https:\/\/fivemor.com\/?p=95383#primaryimage"},"thumbnailUrl":"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg","keywords":["Custom","Distributor","Google","Manager","TAG","Template","User"],"articleSection":["Analytics"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/fivemor.com\/?p=95383#respond"]}]},{"@type":"WebPage","@id":"https:\/\/fivemor.com\/?p=95383","url":"https:\/\/fivemor.com\/?p=95383","name":"User Distributor Custom Tag Template For Google Tag Manager - Som2ny Network","isPartOf":{"@id":"https:\/\/fivemor.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/fivemor.com\/?p=95383#primaryimage"},"image":{"@id":"https:\/\/fivemor.com\/?p=95383#primaryimage"},"thumbnailUrl":"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg","datePublished":"2025-02-18T10:51:44+00:00","breadcrumb":{"@id":"https:\/\/fivemor.com\/?p=95383#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/fivemor.com\/?p=95383"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/fivemor.com\/?p=95383#primaryimage","url":"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg","contentUrl":"https:\/\/fivemor.com\/wp-content\/uploads\/2025\/02\/1739875905_user-distributor-scaled.jpg","width":2560,"height":1275},{"@type":"BreadcrumbList","@id":"https:\/\/fivemor.com\/?p=95383#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/fivemor.com\/?bp_activities=1"},{"@type":"ListItem","position":2,"name":"User Distributor Custom Tag Template For Google Tag Manager"}]},{"@type":"WebSite","@id":"https:\/\/fivemor.com\/#website","url":"https:\/\/fivemor.com\/","name":"Som2ny Network","description":"Daily Deals","publisher":{"@id":"https:\/\/fivemor.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/fivemor.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/fivemor.com\/#organization","name":"Som2ny Network","url":"https:\/\/fivemor.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/fivemor.com\/#\/schema\/logo\/image\/","url":"https:\/\/fivemor.com\/wp-content\/uploads\/2026\/07\/4a0953c4-logo-300x86-1.png","contentUrl":"https:\/\/fivemor.com\/wp-content\/uploads\/2026\/07\/4a0953c4-logo-300x86-1.png","width":300,"height":86,"caption":"Som2ny Network"},"image":{"@id":"https:\/\/fivemor.com\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/fivemor.com\/#\/schema\/person\/b85e3c3dc0e1daea076524dc8810c371","name":"admin","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/fivemor.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/729ae85bf62b9917e93538db2f2688ca?s=96&r=g&default=https%3A%2F%2Ffivemor.com%2Fwp-content%2Fplugins%2Fbuddypress-first-letter-avatar%2Fimages%2Fdefault%2F96%2Flatin_a.png","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/729ae85bf62b9917e93538db2f2688ca?s=96&r=g&default=https%3A%2F%2Ffivemor.com%2Fwp-content%2Fplugins%2Fbuddypress-first-letter-avatar%2Fimages%2Fdefault%2F96%2Flatin_a.png","caption":"admin"},"sameAs":["https:\/\/fivemor.com"],"url":"https:\/\/fivemor.com\/?author=1"}]}},"_links":{"self":[{"href":"https:\/\/fivemor.com\/index.php?rest_route=\/wp\/v2\/posts\/95383","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=95383"}],"version-history":[{"count":0,"href":"https:\/\/fivemor.com\/index.php?rest_route=\/wp\/v2\/posts\/95383\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=\/wp\/v2\/media\/95384"}],"wp:attachment":[{"href":"https:\/\/fivemor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=95383"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=95383"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=95383"},{"taxonomy":"dealstore","embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fdealstore&post=95383"},{"taxonomy":"offerexpiration","embeddable":true,"href":"https:\/\/fivemor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fofferexpiration&post=95383"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}