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.

Installing

Maven is the easiest way to install the module. Add the following to your bundle:

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

Pre-built JARs are also available for download. See Installing a module for help.

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>
#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))