Piwik PRO Tag Setup Guide

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 0.
Heartbeat Timer
- Time, in seconds, between cyclical heartbeat requests.
Track User Anonymously
- Track visitor anonymously (without consent).
Enable Heart Beat Timer
Send Page View
- Page View events are automatically recorded your site. If you don’t want the snippet to send a Page View event, set the this option to false.

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.
`tracking_url`	Analytics Tracker URL.
`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.
`enableHeartBeatTimer`	Enable Heart Beat Timer.
`sendPageView`	Boolean Send Page View

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`.