{"id":8155,"date":"2025-06-12T14:05:06","date_gmt":"2025-06-12T14:05:06","guid":{"rendered":"https:\/\/docs.campaignsuite.nl\/?post_type=docs&#038;p=8155"},"modified":"2025-06-12T14:05:07","modified_gmt":"2025-06-12T14:05:07","slug":"preparing-installation-in-gtm","status":"publish","type":"docs","link":"https:\/\/docs.campaignsuite.nl\/en\/docs\/preparing-installation-in-gtm\/","title":{"rendered":"Preparing installation in GTM"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">This guide explains how to define variables and triggers, and how to set up events to track form interactions. These settings enable you to dynamically send user actions and data changes from your forms to GA4 for accurate measurement and analysis.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">1. Define Variables<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">What are variables in GTM?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Variables in GTM allow you to extract values (e.g., donation_amount, email_opt_in) from the dataLayer or page elements. These values can then be passed as parameters in events (such as those sent to GA4).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Steps to create data layer variables in GTM:<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Go to <strong>Variables<\/strong> tab in GTM.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"607\" src=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-1024x607.png\" alt=\"\" class=\"wp-image-8136\" srcset=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-1024x607.png 1024w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-300x178.png 300w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-768x455.png 768w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-1536x910.png 1536w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-2048x1213.png 2048w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-1-370x220.png 370w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Click New \u2192 Name the variable.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"728\" src=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-2-1024x728.png\" alt=\"\" class=\"wp-image-8138\" srcset=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-2-1024x728.png 1024w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-2-300x213.png 300w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-2-768x546.png 768w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-2-1536x1092.png 1536w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-2-2048x1455.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Choose Variable Type: Data Layer Variable<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In the Data Layer Variable Name field, enter the exact key name:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Example: <code>donation_amount<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Then save variable.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">2. Setup Event Triggers<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Steps to create trigger in GTM:<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"744\" src=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-3-1024x744.png\" alt=\"\" class=\"wp-image-8142\" srcset=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-3-1024x744.png 1024w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-3-300x218.png 300w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-3-768x558.png 768w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-3-1536x1116.png 1536w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-3-2048x1487.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to GTM \u2192 <strong>Triggers<\/strong> \u2192 Click <strong>New<\/strong>,\n<ul class=\"wp-block-list\">\n<li><strong>Name<\/strong> your trigger clearly, like <code>Trigger \u2013 Form Submitted (form_submitted123)<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Choose Trigger Type\n<ul class=\"wp-block-list\">\n<li><strong>Trigger Type<\/strong>: <code>Custom Event<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Configure Custom Event Trigger\n<ul class=\"wp-block-list\">\n<li><strong>Event Name<\/strong>  &#8211; <code>form_submitted_1234<\/code> <em>(write your event name)<\/em><\/li>\n\n\n\n<li><strong>This trigger fires on:<\/strong> <code>All Custom Events<\/code> <em>(or select \u201cSome\u201d to add conditions)<\/em><\/li>\n\n\n\n<li>If you want to <strong>limit<\/strong> when it fires, choose:<\/li>\n\n\n\n<li><strong>Some Custom Events<\/strong><\/li>\n\n\n\n<li>Condition example:<\/li>\n\n\n\n<li><code>formId<\/code> <strong>equals<\/strong> <code>123<\/code><\/li>\n\n\n\n<li>OR any other Data Layer variable you\u2019re checking<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Save it.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">3. Create Event<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Steps to create GA4 event tag in GTM:<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"718\" src=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-4-1024x718.png\" alt=\"\" class=\"wp-image-8145\" srcset=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-4-1024x718.png 1024w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-4-300x210.png 300w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-4-768x538.png 768w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-4-1536x1077.png 1536w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-4-2048x1436.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to GTM \u2192 Tags \u2192 Click <strong>New<\/strong><\/li>\n\n\n\n<li>Name your tag clearly<\/li>\n\n\n\n<li>Set  tag Type: <strong>Google Analytics: GA4 Event<\/strong> \n<ul class=\"wp-block-list\">\n<li>Configuration Tag: Choose your existing <strong>GA4 Configuration Tag<\/strong><\/li>\n\n\n\n<li><em>(It has your <code>G-XXXXXXXXXX<\/code> Measurement ID)<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Configure Event Name\n<ul class=\"wp-block-list\">\n<li><strong>Event Name<\/strong>:<\/li>\n\n\n\n<li>Example: <code>form_submitted<\/code><\/li>\n\n\n\n<li><em>(This is what you\u2019ll see in GA4 later)<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Add Event <strong>Variables<\/strong>\n<ul class=\"wp-block-list\">\n<li>Make sure you&#8217;ve already created these <strong>Data Layer Variables<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>You can now attach your trigger to your GA4 Event Tag.<\/li>\n\n\n\n<li>Save it<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">4. Publish changes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Steps to publish changes in GTM:<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"328\" src=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-5-1024x328.png\" alt=\"\" class=\"wp-image-8148\" srcset=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-5-1024x328.png 1024w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-5-300x96.png 300w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-5-768x246.png 768w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-5-1536x491.png 1536w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-5-2048x655.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"769\" src=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-6-1024x769.png\" alt=\"\" class=\"wp-image-8150\" srcset=\"https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-6-1024x769.png 1024w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-6-300x225.png 300w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-6-768x577.png 768w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-6-1536x1154.png 1536w, https:\/\/docs.campaignsuite.nl\/wp-content\/uploads\/2025\/06\/image-6-2048x1539.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open Your Container in GTM<\/li>\n\n\n\n<li>Select your account and container.<\/li>\n\n\n\n<li>Check for Unsaved Changes\n<ul class=\"wp-block-list\">\n<li>At the top, you\u2019ll see:<\/li>\n\n\n\n<li><strong>Workspace Changes<\/strong> indicator.<\/li>\n\n\n\n<li>This means you have unpublished tags, triggers, or variables.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Click <strong>Submit<\/strong> (Top Right)\n<ul class=\"wp-block-list\">\n<li>A new panel will open to <strong>publish your container<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Configure Version Details\n<ul class=\"wp-block-list\">\n<li><strong>Version Name<\/strong>: (Optional but recommended)<br>Example: <code>GA4 Event Tracking for Form Submissions<\/code><\/li>\n\n\n\n<li><strong>Version Description<\/strong>: (Optional)<br>Example: <code>Added tag to send form_submitted_1234 event to GA4 with custom parameters.<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Click <strong>Publish<\/strong>\n<ul class=\"wp-block-list\">\n<li>GTM will create a new container version and deploy your changes.<\/li>\n\n\n\n<li>This makes your tag, trigger, and variable changes <strong>live<\/strong> on your site.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Check Published Versions\n<ul class=\"wp-block-list\">\n<li>Go to: <strong>Admin &gt; Versions<\/strong> to view or roll back previous versions if needed.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Confirm It Works:\n<ul class=\"wp-block-list\">\n<li>Use <strong>Preview mode<\/strong> to test your tags before publishing.<\/li>\n\n\n\n<li>Use <strong>GA4 DebugView<\/strong> and <strong>Realtime Reports<\/strong> to verify the events and parameters arrive correctly.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>This guide explains how to define variables and triggers, and how to set up events to track form interactions. These settings enable you to dynamically send user actions and data changes from your forms to GA4 for accurate measurement and analysis. 1. Define Variables What are variables in GTM? Variables in GTM allow you to [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-8155","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/docs\/8155","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/comments?post=8155"}],"version-history":[{"count":1,"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/docs\/8155\/revisions"}],"predecessor-version":[{"id":8156,"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/docs\/8155\/revisions\/8156"}],"wp:attachment":[{"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/media?parent=8155"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.campaignsuite.nl\/en\/wp-json\/wp\/v2\/doc_tag?post=8155"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}