AT Internet Piano Analytics Tag Setup Guide | Client-Side Tags

Piano Analytics is the logical progression to the Analytics Suite 2, a solution that has been continuously developed for over 20 years and endorsed by tens of thousands of customers. With its user-centric, ethical-by-design, and value-driven data model, Piano Analytics synthesizes product & marketing analytics, all while solving the serious data quality issues facing the industry.

Tag Tips

Use mapping to override the standard config values dynamically.

Tag Configuration

Navigate to the Tag Marketplace to add a new tag. Read the Tag Overview article for general instructions on how to add a tag.

When adding the tag, configure the following settings:

Site ID: AT Internet Site ID.
Collection Domain: AT Internet data collection domain.
Collection Path: AT Internet pixel request URL path.
Add Event URL: Automatically adds a page_url property to all events, containing the URL of the current page. (default is set to withoutQS)
Send Event When Optout: Do you want to send events when opted out? (default is true)
Campaign Prefix: Choose with an order of priority the type of campaign to be collected.
Enable UTM Tracking: UTM parameters collected as properties. (default is true)
Queue Name: Use this field to overwrite the default queueName from _pac.

Load Rules

Load the tag on all pages or set conditions for when your tag will load. For more information about load rules, see the Load Rules documentation.

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:

Tag Configuration Parameters

Variable	Description
Site ID (`site`)	[String]
Collection Domain (`collectionDomain`)	[String]
Collection Path (`collectionPath`)	[String]
Add Event URL (`addEventURL`)	[Boolean]
Send Event When Optout (`sendEventWhenOptout`)	[Boolean]
Campaign Prefix (`campaignPrefix`)	[String]
Enable UTM Tracking (`enableUTMTracking`)	[Boolean]
Queue Name (`queueName`)	[String]

Conversion Parameters

Variable	Description
Goal Type (`goal_type`)	[String]

Page Parameters

Variable	Description
Page (`page`)	[String]
Page Chapter 1 (`page_chapter1`)	[String]
Page Chapter 2 (`page_chapter2`)	[String]
Page Chapter 3 (`page_chapter3`)	[String]

Clicks Parameters

Variable	Description
Click (`click`)	[String]
Click Chapter 1 (`click_chapter1`)	[String]
Click Chapter 2 (`click_chapter2`)	[String]
Click Chapter 3 (`click_chapter3`)	[String]

On Site Ads Parameters

Variable	Description
On Site Ad type (required) (`onsitead_type`)	[String]
On Site Ad advertiser (`onsitead_advertiser`)	[String]
On Site Ad campaign (`onsitead_campaign`)	[String]
On Site Ad category (`onsitead_category`)	[String]
On Site Ad creation (`onsitead_creation`)	[String]
On Site Ad detailed placement (`onsitead_detailed_placement`)	[String]
On Site Ad format (`onsitead_format`)	[String]
On Site Ad general placement (`onsitead_general_placement`)	[String]
On Site Ad url (`onsitead_url`)	[String]
On Site Ad variant (`onsitead_variant`)	[String]

Internal Search Engine Parameters

Variable	Description
ISE keyword (`ise_keyword`)	[String]
ISE page (`ise_page`)	[Number]
ISE click rank (`ise_click_rank`)	[Number]

MV Testing Parameters

Variable	Description
MV creation (`mv_creation`)	[String]
MV test (`mv_test`)	[String]
MV wave (`mv_wave`)	[Number]

Product Parameters

Variable	Description
Product ID (`product_id`) (Overrides `_cprod`)	[Array of string]
Product label (`product`) (Overrides `_cprodname`)	[Array of string]
Product variant (`product_variant`)	[String]
Product brand (`product_brand`) (Overrides `_cbrand`)	[Array of string]
Discounted product? (`product_discount`) (Overrides `_cpdisc`)	[Array of boolean]
Price tax included (`product_pricetaxincluded`) (Overrides `_cprice`)	[Array of number]
Price tax free (`product_pricetaxfree`)	[Number]
Currency (ISO 4217) (`product_currency`)	[String]
Product in stock? (`product_stock`)	[Boolean]
Product quantity (`product_quantity`) (Overrides `_cquan`)	[Array of number]
Level 1 category (`product_category1`) (Overrides `_ccat`)	[Array of string]
Level 2 category (`product_category2`) (Overrides `_ccat2`)	[Array of string]
Level 3 category (`product_category3`)	[String]
Level 4 category (`product_category4`)	[String]
Cart created by this product addition? (`product_cartcreation`)	[Boolean]

Cart Parameters

Variable	Description
Cart ID (`cart_id`) (Overrides `_corder`)	[String]
Cart currency (`cart_currency`) (Overrides `_ccurrency`)	[String]
Turnover tax included (`cart_turnovertaxincluded`)	[Number]
Turnover tax free (`cart_turnovertaxfree`)	[Number]
Cart creation date (timestamp UTC in seconds) (`cart_creation_utc`)	[Number]
Number of products (`cart_quantity`) (Overrides `_ctotal`)	[Number]
Number of distinct products (`cart_nbdistinctproduct`)	[Number]
New unique version identifier associated with the cart (`cart_version`)	[Number]

Transaction Parameters

Variable	Description
Transaction ID (`transaction_id`)	[String]
Promo code list (`transaction_promocode`)	[Array of string]
First purchase of the customer? (`transaction_firstpurchase`)	[Boolean]

Shipping and Payment Parameters

Variable	Description
Shipping type (`shipping_delivery`)	[String]
Shipping cost tax included (`shipping_costtaxincluded`)	[Number]
Shipping cost tax free (`shipping_costtaxfree`)	[Number]
Payment mode (`payment_mode`)	[String]

Users Parameters

Variable	Description
User ID (`userId`)	[String]
User category (`userCategory`)	[String]
Enable storage (`enableStorage`)	[Boolean]

Global Parameters

Variable	Description
Domain of cookie deposit (`cookieDomain`)	[String]
“SameSite” flag in cookies in client-side (`cookieSameSite`)	[String]
“Secure” flag in cookies in client-side cookies (`cookieSecure`)	[Boolean]
Storage value encode (`encodeStorageBase64`)	[Boolean]

Privacy and Storage Parameters

Variable	Description
Privacy mode by default (`privacyDefaultMode`)	[String]
Lifetime Storage Privacy value (`storageLifetimePrivacy`)	[Number]
Lifetime Storage User value (`storageLifetimeUser`)	[Number]
Lifetime Storage Visitor value (`storageLifetimeVisitor`)	[Number]
Relative or fixed cookie lifetime value for visitor (`visitorStorageMode`)	[String]

Visitor Policy Parameters

Variable	Description
Is cookie deposit client side? If `false`, server side (`isVisitorClientSide`)	[Boolean]

Audio Video Parameters

Variable	Description
Session ID of the playback	[String]
Delay between two heartbeat during playback, minimum delay is 5sec. (`heartbeatDuration`)	[Number or Object]
Delay between two heartbeat during buffering, minimum delay is 1sec. (`bufferingHeartbeatDuration`)	[Number or Object]
Session ID, generated by the SDK (`av_session_id`)	[String]
Content ID (`av_content_id`)	[String]
Content Label (`av_content`)	[String]
Content Type (`av_content_type`)	[String]
Content Duration, in milliseconds (`av_content_duration`)	[Number]
Linked Content Label (`av_content_linked`)	[String]
Publication Date, timestamp (`av_publication_date`)	[Number]
Content genre’s (`av_content_genre`)	[Array of String]
Show Label (`av_show`)	[String]
Show Season Label (`av_show_season`)	[String]
Episode ID (`av_episode_id`)	[String]
Episode Label (`av_episode`)	[String]
Channel Label (`av_channel`)	[String]
Author Name (`av_author`)	[String]
Content Version (`av_content_version`)	[String]
Duration range (`av_content_duration_range`)	[String]
Broadcasting Type (`av_broadcasting_type`)	[String]
Broadcaster Name (`av_broadcaster`)	[String]
Ad Type (`av_ad_type`)	[String]
Player Label (`av_player`)	[String]
Player Version (`av_player_version`)	[String]
Player Position (`av_player_position`)	[String]
Auto play mode (`av_auto_mode`)	[Boolean]
Media language (`av_language`)	[String]
Subtitles (`av_subtitles`)	[String]
Launch reason (`av_launch_reason`)	[String]

Events

To map events, refer to Create an Event Mapping.

Variable	Description
`page.display`	page.display
`click.action`	click.action
`click.navigation`	click.navigation
`click.download`	click.download
`click.exit`	click.exit
`publisher.impression`	publisher.impression
`publisher.click`	publisher.click
`self_promotion.impression`	self_promotion.impression
`self_promotion.click`	self_promotion.click
`internal_search_result.display`	internal_search_result.display
`internal_search_result.click`	internal_search_result.click
`mv_test.display`	mv_test.display
`product.display`	product.display
`product.page_display`	product.page_display
`product.add_to_cart`	product.add_to_cart
`product.remove_from_cart`	product.remove_from_cart
`product.awaiting_payment`	product.awaiting_payment
`product.purchased`	product.purchased
`cart.creation`	cart.creation
`cart.display`	cart.display
`cart.update`	cart.update
`cart.delivery`	cart.delivery
`cart.payment`	cart.payment
`cart.awaiting_payment`	cart.awaiting_payment
`transaction.confirmation`	transaction.confirmation
`setUser`	setUser
`getUser`	getUser
`deleteUser`	deleteUser
`getSessionID`	getSessionID
`av.play`	av.play
`av.buffer.start`	av.buffer.start
`av.buffer.heartbeat`	av.buffer.heartbeat
`av.start`	av.start
`av.heartbeat`	av.heartbeat
`av.pause`	av.pause
`av.rebuffer.start`	av.rebuffer.start
`av.rebuffer.heartbeat`	av.rebuffer.heartbeat
`av.resume`	av.resume
`av.stop`	av.stop
`av.seek.start`	av.seek.start
`av.forward`	av.forward
`av.backward`	av.backward
`av.ad.click`	av.ad.click
`av.ad.skip`	av.ad.skip
`av.error`	av.error
`av.display`	av.display
`av.close`	av.close
`av.volume`	av.volume
`av.subtitle.on`	av.subtitle.on
`av.subtitle.off`	av.subtitle.off
`av.fullscreen.on`	av.fullscreen.on
`av.fullscreen.off`	av.fullscreen.off
`av.quality`	av.quality
`av.speed`	av.speed
`av.share`	av.share
Custom	custom

Event-specific Parameters

To map events, refer to Create an Event Mapping.

Variable	Description
`page.display`	page.display
`click.action`	click.action
`click.navigation`	click.navigation
`click.download`	click.download
`click.exit`	click.exit
`publisher.impression`	publisher.impression
`publisher.click`	publisher.click
`self_promotion.impression`	self_promotion.impression
`self_promotion.click`	self_promotion.click
`internal_search_result.display`	internal_search_result.display
`internal_search_result.click`	internal_search_result.click
`mv_test.display`	mv_test.display
`product.display`	product.display
`product.page_display`	product.page_display
`product.add_to_cart`	product.add_to_cart
`product.remove_from_cart`	product.remove_from_cart
`product.awaiting_payment`	product.awaiting_payment
`product.purchased`	product.purchased
`cart.creation`	cart.creation
`cart.display`	cart.display
`cart.update`	cart.update
`cart.delivery`	cart.delivery
`cart.payment`	cart.payment
`cart.awaiting_payment`	cart.awaiting_payment
`transaction.confirmation`	transaction.confirmation
`setUser`	setUser
`getUser`	getUser
`deleteUser`	deleteUser
`getSessionID`	getSessionID
`av.play`	av.play
`av.buffer.start`	av.buffer.start
`av.buffer.heartbeat`	av.buffer.heartbeat
`av.start`	av.start
`av.heartbeat`	av.heartbeat
`av.pause`	av.pause
`av.rebuffer.start`	av.rebuffer.start
`av.rebuffer.heartbeat`	av.rebuffer.heartbeat
`av.resume`	av.resume
`av.stop`	av.stop
`av.seek.start`	av.seek.start
`av.forward`	av.forward
`av.backward`	av.backward
`av.ad.click`	av.ad.click
`av.ad.skip`	av.ad.skip
`av.error`	av.error
`av.display`	av.display
`av.close`	av.close
`av.volume`	av.volume
`av.subtitle.on`	av.subtitle.on
`av.subtitle.off`	av.subtitle.off
`av.fullscreen.on`	av.fullscreen.on
`av.fullscreen.off`	av.fullscreen.off
`av.quality`	av.quality
`av.speed`	av.speed
`av.share`	av.share
Custom	custom