One of the cool things about Enhanced Ecommerce<\/a> deployments in Google Tag Manager<\/a> is that you can use a Custom JavaScript variable<\/a> to generate the necessary data.<\/p>\n There are many reasons to do so, with the biggest one being the flexibility it offers for manipulating the However, there\u2019s also the chance that you don\u2019t have access to a <\/p>\n <\/a><\/p>\n<\/div>\n To help with some of the pains of manipulating the \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 The template allows you to generate an Enhanced Ecommerce object from scratch. You can, of course, use Google Tag Manager variables to populate parts of the Any variable created with this template will then return a syntactically valid <\/p>\n <\/a><\/p>\n<\/div>\n Now, when this tag fires, it will pull in the <\/p>\n <\/a><\/p>\n<\/div>\n To download the template, save the following file with the Enhanced Ecommerce Object Builder.tpl<\/a><\/p>\n Then, use the instructions found here<\/a> to import the template into your container.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n First, you need to create a new User-defined Variable<\/strong> using the template. So head on over to Variables<\/strong>, click New<\/strong>, and choose the Enhanced Ecommerce Object Builder<\/strong> when prompted for the variable type.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n An important thing to note is that all the text fields in the template accept Google Tag Manager variables<\/strong>. So if you want to populate some fields dynamically, you can.<\/p>\n The first selection you need to make is Type<\/strong>. The options are:<\/p>\n Promotion View<\/p>\n<\/li>\n Promotion Click<\/p>\n<\/li>\n Impression View<\/p>\n<\/li>\n Impression Click<\/p>\n<\/li>\n Product Detail View<\/p>\n<\/li>\n Add To Cart<\/p>\n<\/li>\n Remove From Cart<\/p>\n<\/li>\n Checkout<\/p>\n<\/li>\n Checkout Option<\/p>\n<\/li>\n Purchase<\/p>\n<\/li>\n Refund<\/p>\n<\/li>\n<\/ul>\n If these choices look odd or unfamiliar, I urge you to read about them in my Enhanced Ecommerce guide<\/a>.<\/p>\n In case you selected Promotion View<\/strong>, Promotion Click<\/strong>, or Impression View<\/strong>, the Action Data<\/strong> and Product Data<\/strong> groups will disappear, as those three Enhanced Ecommerce data types do not support the sending of action and product data.<\/p>\n If you want to set a local currency<\/a> for the hit, you can set it by toggling the Set Currency Code<\/strong> checkbox and typing the currency code into the field that appears.<\/p>\n Action Data<\/strong> is only available if you selected an Enhanced Ecommerce action as the tag type. This rules out Promotion Views<\/strong>, Promotion Clicks<\/strong> and Impression Views<\/strong>, which have their own settings in the template.<\/p>\n Under Action Data<\/strong>, you\u2019ll see some options, depending on which type you selected.<\/p>\n If you selected Checkout<\/strong> or Checkout Option<\/strong>, you\u2019ll see the fields for checkout step and option:<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n If you selected Purchase<\/strong> or Refund<\/strong>, you\u2019ll see the fields for a transaction:<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Regardless of which action you selected, you will always see the field where you can add the Product List:<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Product Data<\/strong> is only available if you selected an Enhanced Ecommerce action as the tag type. This rules out Promotion Views<\/strong>, Promotion Clicks<\/strong> and Impression Views<\/strong>, which have their own settings in the template.<\/p>\n The Product Data group is split into three options. First, you have the products themselves. Second, you have the possibility to add Product-scoped Custom Dimensions. Finally, you can optionally add Product-scoped Custom Metrics.<\/p>\n Products<\/strong> are added by clicking the Add Product<\/strong> button. This opens an overlay where you can configure individual product settings.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n You can add as many products as you wish, keeping in mind that there\u2019s an 8192 byte<\/a> limit to the payload size of Google Analytics hits.<\/p>\n Note also that not all the fields are necessary for all the action types.<\/p>\n Product-scoped Custom Dimensions<\/strong> are added by enabling Product-scoped Custom Dimensions by checking the relevant checkbox, and then inserting new rows into the table that appears.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Add the index number of the Custom Dimensions to the Index<\/strong> column, and the value of the Custom Dimension to the Value<\/strong> column.<\/p>\n In the Apply to SKUs<\/strong> field, you add the product IDs\/SKUs to which the custom dimension should apply. If you want the dimension to apply to all the fields in the hit, leave the Apply to SKUs<\/strong> field blank.<\/p>\n As you can see from the screenshot above, you can add multiple rows with the same index as long as the Apply to SKUs<\/strong> field does not overlap. Otherwise, only the last value for any given index is sent to Google Analytics.<\/p>\n Note also that you can add more than one SKU to the field. You can do this by separating the values with a comma: Yes, this is a rather convoluted way to add custom dimensions to the products, but unfortunately there\u2019s no way to have a table of dynamic size (or really of any kind) as one of the fields in the Add Products<\/strong> table.<\/p>\n The same process outlined above applies to Product-scoped Custom Metrics<\/strong>, too.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n You can add Impressions<\/strong> to any Enhanced Ecommerce hit, regardless of hit type.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Adding impression views and any Product-scoped Custom Dimensions and\/or Metrics related to them follows the exact same process as the one for regular products, so check out the previous chapter for a refresher. The main difference is that You can add Promotion Views<\/strong> to any Enhanced Ecommerce hit, apart from Promotion Click<\/strong>.<\/p>\n <\/p>\n <\/a><\/p>\n<\/div>\n Promotion views are added simply by clicking the Add Promotion<\/strong> button, and then inputting values for ID<\/strong>, Name<\/strong>, Creative<\/strong>, and Position<\/strong>.<\/p>\n You can add Promotion Clicks<\/strong> if you\u2019ve selected Promotion Click<\/strong> as the action type.<\/p>\n The clicked promotions are added exactly the same way as you would add viewed promotions, so see the previous chapter for reference.<\/p>\n Once you\u2019ve created the variable and added it to a tag (see the chapter titled Purpose<\/a> for a refresher on how to do that), you\u2019ll need to test it works.<\/p>\n The easiest way to test is by using a browser extension like GTM\/GA Debug<\/a> or dataLayer Inspector+<\/a>. If everything works, you should see all the data added to the hit generated by the tag whose ecommerce settings you modified.<\/p>\ndataLayer<\/code> object in case quick changes are required on the site, and it would take too long to wait for a new release of the site JavaScript.<\/p>\ndataLayer<\/code> implementation of Enhanced Ecommerce at all<\/em>. This is not a very enjoyable situation, as you\u2019ll have to rely on things like DOM scraping to populate the necessary values.<\/p>\n![\"Enhanced](\"https:\/\/www.simoahava.com\/images\/2019\/06\/eec-object-builder.jpg#ZgotmplZ\")
<\/p>\necommerce<\/code> object in dataLayer<\/code> and<\/strong> for generating an entire Enhanced Ecommerce implementation from scratch without<\/em> dataLayer<\/code>, I want to introduce a new custom template<\/a> of mine: the Enhanced Ecommerce Object Builder<\/strong> variable template.<\/p>\n
\n X<\/span><\/p>\n
\n The Simmer Newsletter<\/strong>\n <\/p>\nPurpose<\/h2>\n
ecommerce<\/code> object from dataLayer<\/code> in the template itself (see in the screenshot above how the Currency Code<\/strong> field is populated with a variable).<\/p>\necommerce<\/code> object as its return value, which means that you\u2019ll need to have a tag that has the Enable Enhanced Ecommerce Features<\/strong> setting toggled on, and the respective variable selected from the list:<\/p>\n![\"Enhanced](\"https:\/\/www.simoahava.com\/images\/2019\/06\/enhanced-ecommerce-settings.jpg#ZgotmplZ\")
<\/p>\necommerce<\/code> object generated by the variable (and the template code), and as a result, populate the hit to GA with the correct Enhanced Ecommerce parameters.<\/p>\n![\"Enhanced](\"https:\/\/www.simoahava.com\/images\/2019\/06\/eec-parameters.jpg#ZgotmplZ\")
<\/p>\nDownload and import template<\/h2>\n
.tpl<\/code> extension somewhere in your computer:<\/p>\n![\"Template](\"https:\/\/www.simoahava.com\/images\/2019\/06\/template-import-menu.jpg#ZgotmplZ\")
<\/p>\nHow to use the template<\/h2>\n
![\"New](\"https:\/\/www.simoahava.com\/images\/2019\/06\/new-variable.jpg#ZgotmplZ\")
<\/p>\nEnhanced Ecommerce data type<\/h3>\n
\n
Currency Code<\/h3>\n
Action Data<\/h3>\n
![\"Checkout](\"https:\/\/www.simoahava.com\/images\/2019\/06\/checkout-options.jpg#ZgotmplZ\")
<\/p>\n![\"Purchase](\"https:\/\/www.simoahava.com\/images\/2019\/06\/purchase-fields.jpg#ZgotmplZ\")
<\/p>\n![\"Product](\"https:\/\/www.simoahava.com\/images\/2019\/06\/product-list.jpg#ZgotmplZ\")
<\/p>\nProduct Data<\/h3>\n
![\"Add](\"https:\/\/www.simoahava.com\/images\/2019\/07\/add-product-dialog.jpg#ZgotmplZ\")
<\/p>\n![\"Product-scoped](\"https:\/\/www.simoahava.com\/images\/2019\/07\/product-scoped-dims.jpg#ZgotmplZ\")
<\/p>\nshirts123,shirts1234<\/code>.<\/p>\n![\"Product-scoped](\"https:\/\/www.simoahava.com\/images\/2019\/07\/product-scoped-mets.jpg#ZgotmplZ\")
<\/p>\nImpressions Viewed<\/h3>\n
![\"Impressions](\"https:\/\/www.simoahava.com\/images\/2019\/07\/impression-views.jpg#ZgotmplZ\")
<\/p>\nlist<\/code> is one of the fields you need to add to the impression data, so that the impression can be assigned to a specific product list.<\/p>\nPromotions Viewed<\/h3>\n
![\"Promotions](\"https:\/\/www.simoahava.com\/images\/2019\/07\/promotion-viewed.jpg#ZgotmplZ\")
<\/p>\nPromotions Clicked<\/h3>\n
Testing everything<\/h2>\n
![\"GTM\/GA](\"https:\/\/www.simoahava.com\/images\/2019\/07\/gtm-ga-debug.jpg#ZgotmplZ\")
<\/p>\n