Go Back


January 29, 2018

A tag is a snippet of JavaScript code that sends information to a third party. Thanks to Piwik Pro Tag Manager, you don’t need to add tags directly to your website, you just need specify how and when the tag should fire.

Please note that the tag won’t fire without an assigned trigger.

You can learn more about how to add and manage tags in the section below.

  1. Log in to your Piwik Pro Marketing Suite application.
  2. Go to tag manager section – click “Tag manager” link in top bar menu.
  3. Click ‘Tags’ tab on the left.

Add a new tag

Follow the instructions below to add a new tag:

1. Click the “+ New tag” link under the tags list

2. In the ‘Create a tag’ form enter the tag’s name and choose a tag template

You can choose from two types of tags: asynchronous (default) and synchronous.

Asynchronous tags load at the same time as the page’s content. Tags may fire after loading the page’s content. It’s a good practice to use asynchronous tags for tracking tags.

Synchronous tags fire and load first – even before the page loads. The content of a page won’t appear until the tag fires. It’s a good practice to use synchronous tags for A/B tests.

In both sections, you can choose one of tag templates or try to pick an option for “Custom HTML tag”.

If you have chosen “Custom HTML tag” option you need to paste the tag’s snippet code into the “Tag HTML” section. The HTML editor has embedded linter and syntax which helps you to debug your JavaScript code. The HTML editor allows you to use Variables, both basic and custom. Just click one of the variables on the right to insert it into your code.

3. For “Custom HTML tag” you can choose the “Enable document.write” option if the tag needs the “document.write” feature

4. Set tag status

By default, tags are active. It means the tag will be fired after publication (if conditions will be met). You can turn off your tag by changing status to “Inactive”.

Please note publication is required to make your changes live.

Tag status is also displayed on tags list:

  • green dot – tag is active (or will be active after publication)
  • red dot – tag is inactive (or will be inactive after publication)

5. Set Respect your visitor privacy

Mark this checkbox if you want to respect your visitors’ privacy preferences either expressed by:

  • Selecting the Do Not Track option in their web browser
  • Explicitly opting out from being tracked.

6. Do not fire in debug mode

If you don’t want to fire some of your tags in debug mode, just mark this property.

You can check all triggered tags in the ‘Disabled in debug mode’ section.
Please note: the tag will fire for all users who visit the site outside of the debug mode.

7. Add a trigger(s) to a tag.

You can add a trigger to a tag anytime, but it’s a good practice to do it while creating a tag.

8. You can also set tags priority

If you want to fire tags in a specific order. By default, tags are fired in any order.
Please note – the higher on the list, the higher priority. Tags are always fired asynchronously.

To set priority you need to:

  1. Sort tags list by priority
  2. Drag and drop tags to set expected order.
  3. Publish your changes to make it live.

Flight Dates (scheduling)

You can schedule when your tags will be live. There are two options that can be set in parallel:

  • Date range – in what period of time a popup will be live (e.g. display only between 1st till 22nd of November. The popup won’t be fired before 1st and after 22nd of November, even if triggers conditions will be met)
  • Time of day – in what hours during a day popup will be live (e.g. display only between 8am till 8pm. The popup won’t be fired before 8am and after 8pm, even if triggers conditions will be met).

Dates and hours base on your website’s server time.

You can choose timezone (“Timezone” section in “Flight dates” settings) which is a base for setting hours in “Date range” and “Time of day”.

Create a trigger while creating a new tag

When creating or editing a tag, you can also add a trigger(s) to it, and it’s a good practice to do it at this step.

  1. Click on the “+ New trigger” button.
  2. Give your new trigger a name.
  3. Chose trigger’s type and its conditions (more information in the “Triggers” section).Please note that synchronous tags are compatible only with the “Page view” trigger.You are not able to fire synchronous tags with “Click”, ”Sending form”, and “Event”, “Page scroll”, “leave content” and “Time on website” triggers.
  4. Click the “Save” button in trigger edition section.
  5. You can repeat it to add more triggers or save tag settings by clicking on “Save” button.

Choose an existing trigger

Choose this option if you want to use a trigger(s) you have already created in this website.

Click “+ Existing trigger” button and choose triggers from the list and click the “OK” button”.

Click “Save” button on trigger’s form to save your settings.

Please note that synchronous tags are compatible only with the “Page view” trigger.
You are not able to fire synchronous tags with “Click”, ”Sending form”, and “Event” triggers.