Piano Analytics (Pull)

Piano Analytics & AB Tasty

Piano Analytics is a part of the Piano Suite, a comprehensive software package designed to help businesses optimize their digital experience. Piano Analytics is specifically designed to help companies measure their content performance and understand user behavior across platforms. With its real-time data visualization, granular reporting, and advanced segmentation capabilities, Piano Analytics has become a popular choice for media organizations.

The Piano Analytics allows you to receive the audiences collected in Piano Analytics and to use them to create audiences within AB Tasty. Thus, the Piano Analytics integration process is taking place on both interfaces. 

An audience in Piano Analytics is any subset of users based on a particular criterion defined by you. For further information on how to use audiences, please refer to the Piano Analytics documentation

Integration

Requirements

To make sure the integration runs without any problem, you must have Piano Analytics integrated into your website.

On the console (on the browser), you can check with the following commands: 

window.pianoAnalytics 

Creating an AB tasty property 

  1. Go to your data Management interface.

  1. Create a new property
  • Display name: you can enter what you want, but we suggest “ABTastyId” 
  • Description: enter the description you want (for example: Pull Integration Piano <> AB tasty)
  • Property key: abtasty_visitor_id (you must enter this exact key). If you change it, the connection between Piano and AB tasty won’t work anymore
  • Categories: choose “User”
  • Configuration
    • Status: choose “Validated”
    • Type: choose “String”
  • Scope: choose “Visit”

Enabling the integration on Piano Analytics 

To enable integration on Piano, follow the steps below inside the Piano Analytics app:

  1. Go to your Profile > API keys. Enter a name and a description. 

  1. Once the API key is generated, you have one Access Key and one secret key. Please copy both, you will need them later. 
  2. Go back to your piano Analytics dashboard. Inside the URL, you have one field “site” with a value. Example: 

Please copy the value of “site”. For example, here the value is: 636937

An integration API key is a unique key that allows a third-party tool to communicate with your specific AB Tasty account i.e., send data to your account.

Enabling the integration on AB Tasty 

To enable the integration on AB Tasty, follow the steps below:

  1. Access Integrations > Integration Hub > Pull.
  2. Search for and select Piano Analytics.
  3. Click Setup connector.
  4. Give a name to your connector so you can easily retrieve it.

  1. API Key: paste the API key using the following format (official documentation here)

accessKey_secretKey

  1. Site Id: paste the siteID you have copied earlier

Piano Analytics is now set up. No other action is required here. This will allow AB Tasty to display the audiences that will be sent by Piano Analytics.

Configuration

Once you have activated and configured an integration, you can retrieve your segment traits in the segment builder (available when you create a new segment). 

Audiences or traits generated by your integrations are all to be found under the criteria group EXTERNAL DATA.  
For each integration, you will have a corresponding item that you can drag and drop to use.  
For global information on how to build a targeting segment, please refer to our targeting guide.

For an audience to be available in the segment builder it must not be empty, meaning that we have to identify at least one user belonging to that audience. Once a user is identified, the audience will appear in the segment builder.

Was this article helpful?

/