This article describes how to set up the Piwik PRO tag in your Tag Management account.
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)
- Order ID (
Tag configuration
Go to the tag marketplace to add a new tag. For more information, see About tags.
When 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 orpiwikTrackContentCSS class attached to it.Track All Visible Content Impressions
To track content, it has to have the data-track-content attribute orpiwikTrackContentCSS 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.
- 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
Data mappings
Data mappings send values from data layer variables to the corresponding variables in the vendor tag. For more information, see About data mappings.
The available categories are:
Standard
| Variable | Description |
|---|---|
appId |
|
base_url |
|
tracking_url |
|
category |
|
action |
|
name |
|
value |
|
goal_name |
|
goal_value |
|
title |
|
beat |
|
keyword |
|
searchCount |
|
isAnonymous |
|
CustomUrl |
|
ReferrerUrl |
|
cookieDomain |
|
cookiePath |
|
updateTimingDataOnPageLoadSampling |
|
enableHeartBeatTimer |
|
sendPageView |
|
Content Tracking
| Variable | Description |
|---|---|
trackAllContentImpressions |
|
checkOnScroll |
|
watchInterval |
|
impressionDomNode |
|
domNode |
|
contentInteraction |
|
contentName |
|
contentPiece |
|
contentTarget |
|
Download and Outlink Tracking
| Variable | Description |
|---|---|
link_tracking |
|
domains |
|
outLinkClassName |
|
linkAddress |
|
addDownloadExtensions |
|
setDownloadExtensions |
|
setDownloadClassName |
|
time |
|
setIgnoreClasses |
|
Events
| Variable | Description |
|---|---|
trackEvent |
|
trackGoal |
|
addEcommerceItem |
|
trackEcommerceOrder |
|
trackEcommerceCartUpdate |
|
setEcommerceView |
|
trackAllContentImpressions |
|
trackVisibleContentImpressions |
|
trackContentImpressionsWithinNode |
|
trackContentInteractionNode |
|
trackContentImpression |
|
trackContentInteraction |
|
trackLink |
|
setUserId |
|
resetUserId |
|
setDocumentTitle |
|
trackSiteSearch |
|
setUserIsAnonymous |
|
deanonymizeUser |
|
E-Commerce
| Variable | Description |
|---|---|
order_id |
|
order_total |
|
order_subtotal |
|
order_shipping |
|
order_tax |
|
customer_id |
|
product_id |
|
product_name |
|
product_category |
|
product_quantity |
|
product_unit_price |
|
product_discount |
|
This page was last updated: November 10, 2026