How to connect Batch to Piano Analytics

This guide explains how to enable tracking of Piano Analytics campaigns to track Batch's web and mobile campaigns.

Piano Analytics is an advanced analytics platform that enables you to:

• Collect and leverage high-quality data across your websites and applications

• Use a powerful and flexible platform to improve your performance

• Integrate with a rich ecosystem of partners, including Batch

---

A. Track Web Push notifications

Track web push notification opens in Piano Analytics by adding tracking parameters to your deep links.

1

Use AT or UTM Parameters in Deep Links

AT parameters: Add at_medium and at_campaign parameters directly to your deep links or in the payload. Follow Piano Analytics documentation for formatting and parameter usage.

UTM parameters: Use UTM parameters if you configure Piano Analytics to recognize them. Refer to the Piano Analytics documentation for configuration steps.

2

Add Parameters to Your Deep Link

Append your tracking parameters to the push campaign deep link. For example:

https://mywebsite.com/item?at_medium=batchPush&at_campaign=new_offer

AT parameters must be under 250 characters and must not include special characters. Refer to the Piano Analytics documentation for formatting rules.

After implementation, Piano Analytics will track users who open the notification. The source of their visit will reflect the value of the at_medium parameter.

---

B. Track Push and In-App Messages

Use Batch's Piano Analytics event dispatcher to send campaign data from your mobile app to Piano Analytics.

Event dispatchers are available starting from Batch SDK version 1.19.

1

Install the Piano Analytics Dispatcher

Install the dispatcher for Android or iOS. Refer to the technical documentation to configure the dispatcher in your mobile app (Android / iOS).

The dispatcher extracts AT or UTM parameters from the campaign and sends the data to Piano Analytics.

2

Understand Piano Analytics Traffic Attribution

Piano Analytics uses the first detected campaign per session as the Traffic Source. However, Batch can trigger multiple campaigns during a single session.

To support this behavior, Batch dispatches campaign data to:

• The Marketing Campaign module

• The On-site Ads module

Marketing Campaign module: Only the first campaign detected during a session appears as the official traffic source in the Piano Analytics dashboard. Other campaigns appear as event properties.

View this data in:

• Traffic Sources > Marketing Sources

• Content > Pages

On-site Ads module: This module tracks ad impressions and clicks per campaign. It ensures visibility for all campaigns triggered during a session.

View this data in:

• Content > On-site Ads > Publisher Campaigns

3

Create and Use AT or UTM Parameters

Define your AT or UTM parameters in Piano Analytics. Reuse the parameter created in Section A.1. Associate this parameter with your campaign.

4

Link Your Batch Campaign

Push campaigns: The dispatcher extracts the AT or UTM parameter from:

• The deeplink URL

• The custom payload

If both are present, the dispatcher prioritizes the parameter in the custom payload.

AT parameters must be under 250 characters and must not include special characters. Refer to Piano Analytics documentation for formatting rules.

In-App and Mobile Landing campaigns: The dispatcher extracts the AT or UTM parameter from:

• The deeplink URL

• The Tracking ID field in the campaign settings

After linking, Piano Analytics tracks all events related to your Batch push or In-App campaigns.