You can integrate the tracking code on your publication, from the the Settings section > General settings > SEO & Analytics > Add Analytics tracker.

For this tracker you are required to fill in two parameters: "Piano Analytics Property ID" and "Piano Analytics Collect Domain".

Enabling Custom Dimensions in Piano Analytics Reports

Once Piano Analytics is installed on your publication, it will begin recording user interaction events automatically.
To view detailed custom data in your reports, you need to declare the following custom properties in the data model:

  • wp_category
  • wp_action
  • wp_label
  • wp_value

How to Declare the Custom Properties

Navigate to Settings > Data Management > Properties

If the publication has already been used and events were tracked, these properties may already exist in the "Unexpected" tab.

In that case, click on each property and validate it by setting its type (usually String) and scope (Event).

If the properties are not present:

Click the ( + ) button in the bottom-right corner

Create each property manually using the names listed above

Make sure to set:

Type: String

Scope: Event

Using the Properties in Reports

Once the properties are validated:

  • Go to your report or the Explorer
  • Search for the wp_ prefix to find your custom dimensions
  • You can now add them to your report as columns, filters, or breakdowns