Magnolia 5.7 reached extended end of life on May 31, 2022. Support for this branch is limited, see End-of-life policy. Please note that to cover the extra maintenance effort, this EEoL period is a paid extension in the life of the branch. Customers who opt for the extended maintenance will need a new license key to run future versions of Magnolia 5.7. If you have any questions or to subscribe to the extended maintenance, please get in touch with your local contact at Magnolia.

EditionEE Std, Cloud
License
MLA
IssuesMGNLTAGS
Maven sitemarketingtags
Latest version

Marketing tags are snippets of code that you insert on Web pages. Tags typically collect analytics information such as how many visitors view the page and how long they stay. Tags can also integrate third-party content such as social media on your site or insert ad campaigns. You can use tags to learn more about visitors or provide content.

A tag is typically a piece of JavaScript code. When a page loads, the JavaScript code runs and collects usage information about the page and the visitor. The tag then reports this information to the service that provided the tag. The service stores and analyses the information. If the service provides an analytics dashboard you can display it in the Marketing Tags app.

Since many of these tags require cookies to work, you can also link tags to cookies defined in the Cookies app. By linking tags to cookies, you can make sure the tags used on your website comply with data privacy rules. 

Installing

Maven is the easiest way to install the module. Add the following to your bundle. The parent POM of your webapp project should set the latest version of the module automatically. Should you need to use a specific module version, you can define it using the <version/> in the dependency.

<dependency>
  <groupId>info.magnolia.marketingtags</groupId>
  <artifactId>magnolia-marketing-tags</artifactId>
</dependency>

Configuration

Apps

Marketing Tags app allows editors to insert tags such as JavaScript code snippets for analytics engines into Web pages.

Inserting tags in the Community Edition

The Marketing Tags module is an Enterprise Edition module. If you work with the Community Edition you can include code snippets on your pages as resource files.

  1. Include the code snippet as a resource file in your project.

    /<magnolia.resources.dir>/<my-module>/webresources/js/gtag.js
    <!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-1234567-2"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-1234567-2');
</script>

  2. Use the Freemarker include directive in your template script, as if you were referencing another script.

    home.ftl
    <head>
   [#include “/my-module/webresources/js/gtag.js"]
</head>