Piwik PRO Tag Setup Guide

[#1]

This article describes how to set up the Piwik PRO tag in your Tealium iQ Tag Management account.

In this article:

Table of Contents Placeholder

Tag Tips

• The Track E-commerce Order Event fires when an Order ID is present.
• Use mapping to:
  • Dynamically override the standard configuration values
  • Setup event triggers
  • Set Custom Dimensions
  • Override the E-Commerce extension values
• Supports these E-Commerce extension parameters:
  • Order ID (_corder )
  • Order Total (_ctotal )
  • Sub Total (_csubtotal )
  • Shipping Amount (_cship )
  • Tax Amount (_ctax )
  • Cart or Order Type (_ctype )
  • Customer ID (_ccustid )
  • List of Product IDs (_cprod )
  • List of Names (_cprodname )
  • List of Categories (_ccat )
  • List of Quantities (_cquan )
  • List of Prices (_cprice )
  • List of Discounts (_cpdisc )

Tag Configuration

First, go to Tealium's tag marketplace and add the Piwik PRO tag (Learn more about how to add a tag).

After adding the tag, configure the following settings:

• App ID
  • PPAS application identifier (previously website ID, site ID or idSite).
• Base URL
  • PPAS instance URL without trailing slash.
  • Include // at the beginning.
  • Example: //example.com
• Enable Download & Outlink tracking
  • Tracking all content impressions within a page
    To track content, it has to have the data-track-content attribute or piwikTrackContent CSS class attached to it.
  • Track All Visible Content Impressions
    To track content, it has to have the data-track-content attribute or piwikTrackContent CSS class attached to it.
• Check Impressions On Scroll
  • Check new visible content impressions on the scroll event.
  • It will not detect content blocks placed in a scrollable element.
• Visible Content Watch Interval
  • Interval, in milliseconds, between checking for new visible content.
  • Periodic checks can be disabled for performance reasons by setting zero (0).
• Heartbeat Timer
  • Time, in seconds, between cyclical heartbeat requests.
• Track User Anonymously
  • Track visitor anonymously (without consent).

Data Mappings

Mapping is the process of sending data from a data layer variable to the corresponding destination variable of the vendor tag. For instructions on how to map a variable to a tag destination, see Data Mappings.

The available categories are:

Standard

Variable	Description
appId	App ID.
base_url	PPAS Instance Address.
category	Event Category.
action	Event Action.
name	Event Name.
value	Event Value.
goal_name	Goal Name.
goal_value	Goal Value.
title	Custom Page Name/Document Title.
beat	Time Between Heartbeat Requests.
keyword	Keyword
searchCount	Search Count
isAnonymous	Boolean Enable Anonymous Tracking.
CustomUrl	Custom URL
ReferrerUrl	Referrer URL.
cookieDomain	Cookie Domain.
cookiePath	Cookie Path.
updateTimingDataOnPageLoadSampling	Update Timing Data On Page Load Sampling.

Content Tracking

Variable	Description
trackAllContentImpressions	Boolean Track All Content Impressions.
checkOnScroll	Boolean Impression Check On Scroll.
watchInterval	Impression WatchInterval.
impressionDomNode	Impression Dom Node.
domNode	Interaction Dom Node.
contentInteraction	Content Interaction Name.
contentName	Content Name.
contentPiece	Content Piece.
contentTarget	Content Target.

Download and Outlink Tracking

Variable	Description
link_tracking	Boolean Enable Link Tracking.
domains	Array Ignore Alias Domains.
outLinkClassName	Outlink Class Name.
linkAddress	Link Address.
addDownloadExtensions	Array Add Download Extensions.
setDownloadExtensions	Array Replace Default Extensions.
setDownloadClassName	Set Download ClassName.
time	Link Tracking Delay.
setIgnoreClasses	Array Disable Outlink Tracking Classes.

Events

Variable	Description
trackEvent	Trigger Custom Event.
trackGoal	Track Goal Conversion.
addEcommerceItem	Add Ecommerce Item.
trackEcommerceOrder	Track Ecommerce Order.
trackEcommerceCartUpdate	Update Cart.
setEcommerceView	Track Product / Category View.
trackAllContentImpressions	Tracking all content impressions within a page.
trackVisibleContentImpressions	Tracking all visible content impressions.
trackContentImpressionsWithinNode	Tracking only content impressions for specific page part.
trackContentInteractionNode	Track interactions manually with auto detection.
trackContentImpression	Track impression manually.
trackContentInteraction	Track user interaction manually.
trackLink	Force Tracking download using JS function.
setUserId	Set UserId.
resetUserId	Reset UserId.
setDocumentTitle	Set Custom Page Name.
trackSiteSearch	Tracking Site Search.
setUserIsAnonymous	Track User Anonymously.
deanonymizeUser	Disable tracking user anonymously (after visitor consent).

E-Commerce

Variable	Description
order_id	Order ID Overrides _corder.
order_total	Order Total Overrides _ctotal.
order_subtotal	Sub Total Overrides _csubtotal.
order_shipping	Shipping Amount Overrides _cship.
order_tax	Tax Amount Overrides _ctax.
customer_id	Customer ID Overrides _ccustid .
product_id	Array List of Product IDs. Overrides _cprod.
product_name	Array List of Names. Overrides _cprodname.
product_category	Array List of Categories Overrides _ccat.
product_quantity	Array List of Quantities. Overrides _cquan.
product_unit_price	Array List of Prices. Overrides _cprice.
product_discount	Array List of Discounts. Overrides _cpdisc.