Setting up the Piano Integration
Updated over a week ago

🛠 This article explains how to set up the Piano Analytics integration with Botify. Piano Analytics was formerly AT Analytics.

Overview

Website analytics, one of the core data sets that powers Botify’s unified data, helps to ensure your SEO efforts are contributing as expected: increase traffic to your website, drive more on-site conversions, and grow your digital revenue. By integrating Piano metrics with Botify, including visit data, bounce rates, conversion, and revenue data, you can quickly diagnose traffic and conversion issues, gain more relevant insights, and understand the business impact of organic search. This integration makes getting visits and conversion data from Piano into Botify easy. Configuring data feeds is unnecessary, saving you time and resources. The seamless data sync lets you analyze your search performance and make data-driven decisions quickly and effectively. It's also easier to prove the ROI of organic search on your business.

Configuring the Integration

The configuration for the Piano integration with Botify is done entirely within your Piano account; no configuration is required within Botify. To configure the integration, complete the following steps, referring to the linked Piano documentation:

  1. Log into your Piano account.

  2. Obtain your Piano Space ID for the configuration through one of the following methods:

    • Through Data Query.

    • Through the Data Collection Portal interface (has limited access rights).

  3. Select the Piano metrics you want to have available in Botify. Please refer to the API Conversion Metrics section below.

  4. Send an email to your regional Support email address with the following information:

    • Full API key, also known as accesskey_secretkey (Step 1)

    • List of sites IDs (Step 2)

    • Start date from when to get the data

    • Piano property name to use for the URL field (default is event_url)

    • The link to your Botify project

The Support Team will notify you when the configuration is complete.

API Conversion Metrics

With the Piano integration, Botify can retrieve any of your metrics or conversion data from Piano. The following are metrics you may want to consider using in Botify:

Visits

  • m_visits

  • m_page_views

  • m_time_spent

  • m_bounces

Conversion

  • m_conv1_uv

  • m_conv1_iv

  • m_v_sales_per_uv

  • m_v_sales_per_iv


FAQs

Can I use my Piano account for all my projects?

Yes, the Piano integration can be connected to several of your properties. Please submit a separate request for each property with the specific Piano Site ID. Expect more time to run the full synchronization.

How frequently is Piano data refreshed?

Piano data is refreshed daily.

How much historical Piano data can I retrieve?

Once the synchronization is complete, we retrieve the previous month of data.

Can I modify my conversion metrics visible in Botify?

Once your connector is activated, you can modify your conversion data used in the Botify platform. Please reach out to Support to request these changes.

Can I retrieve the URL winners/losers?

After the synchronization begins, it will take 2 months before the winners and losers appear on organic revenue.


Contact Support

If you need any assistance with setting up the Piano integration, please contact Support using the email address for your region:

Did this answer your question?