All Collections
How to connect Poool with Piano Analytics - Piano Analytics Tagging (2020 version)
How to connect Poool with Piano Analytics - Piano Analytics Tagging (2020 version)

Here are the details of how the connection works if you use the PA Tagging 2020 version.

Flore Bayle avatar
Written by Flore Bayle
Updated over a week ago

ATI is changing and Poool now allows you to track activities on your analytics tool. In this article, we'll share how to make the connection between your two platforms if you're using the PA Tagging 2020 version.

How to integrate the connector

We provide several configuration lines which must be filed in Poool's configuration in order to make the right connection.

Here are the details:

📌 Poool script - previous version (Poool Legacy)

poool('config', 'ati_auto_tracking_enabled', true);
poool('config', ‘ati_tracking_method’, ‘events’);
poool('config', ‘auto_tracking_spec_v2’, true);

📌 Poool script - new version (to be integrated with Access AND Audit scripts).

As long as you use both Access & Audit scripts, each configuration must be passed in.


access.config('ati_auto_tracking_enabled', true);
access.config(‘ati_tracking_method’, ‘events’);
access.config(‘auto_tracking_spec_v2’, true);


audit.config('ati_auto_tracking_enabled', true);
audit.config(‘ati_tracking_method’, ‘events’);
audit.config(‘auto_tracking_spec_v2’, true);

But what does it all mean? 🤔

ATI is evolving, so we had to adapt as we went along, which explains the use of different elements for the connection.

  • 'ati_auto_tracking_enabled' = enables the connector

  • 'ati_tracking_method' = allows you to send events and use the Self_promotion event

  • 'auto_tracking_spec_V2' = enables a new data structure sent to AT

Enable the 'Events' plugin in Piano Analytics

To make sure that events are sent to Piano Analytics, you must activate the "Events" plugin in your Piano Analytics Dashboard.

Here's how to do it:

  • Go to your setting in the top right hand corner. Choose "Data Collection Portal".

  • Then open the section "Tag Composer" clicking on "Edit configuration".

  • Here you can choose to enable the "Events" plugin.

Once these steps are done, everything is in place to be able to view your widget's performance.

Where can I see my data?

Paywall information is displayed in your Piano board: "Content" tab > "On-site ads" > "Auto-promo campaigns" > "Paywall_poool".

And behind all this, how does it work?

This version of the connector allows you to use the most advanced method of sending events in Piano, the "Self_promotion" event that splits into two event types: impressions and clicks.

Here you will find the following information:

  • onsitead_type : self_promotion

  • onsitead_campaign : paywall_poool

  • onsitead_category : events sent by poool. These correspond to all types of wall display and user actions ( 👉 we give you the detail further down in this article)

  • onsitead_format : scenario

  • onsitead_creation : [widget type] which corresponds to the widget ( 👉 detail described in the rest of this article)

  • onsitead_url : redirection url filled in

  • onasitead_variant : context name / segment name / scenario name / action detail

Which data can I analyze?

As you can see, the data returned will be very complete, and will allow you to have a detailed analysis of Poool's performance.

However, to help you see this data more clearly, we've added some additional explanations below 🤔

Onsitead_category = events sent by poool

In this category, you will find all actions and displays related to Poool walls.

Here is the list of matches:

  • identity_available : visitor of a page containing the poool tag

  • ready : the paywall has been loaded on a page

  • paywall-seen : the paywall has been seen

  • click : click on the CTA, on a secondary action (alternative, login...) or on a custom button

  • register : registration to the newsletter or to the Discovery Pass

  • form-submit : submission of a form

  • consent: consent given

  • answer : answer to a survey

  • error : default paywall triggered

  • outdated-browser : browser error

Onsite_creation = widget type

Here you simply pull up the name of the widget that has been activated in your path.

video : Commercial

newsletter : Newsletter subscription

gift : Free article

subscription : Subscription required

question : Survey

unlock : Automatic unlock

link : URL Discovery

pass : Discovery pass

invisible : Invisible unlocking

Onsitead_variant = route detail

Finally, the icing on the cake 🍰 , you can see all details of the routes which will include the following information:

  • Context name

  • Name of the scenario

  • Detail of the action

💡 It's also in this category that you'll find the detail of clicks (subscribe link click, login click, no_thanks), as well as the ID of your Custom button.

Thanks to all this information, you'll be able to track the performance of Poool's walls and audience engagement metrics in your Piano Analytics Dashboard, allowing you to make the most of our solution!

Did this answer your question?