How to connect Batch to Piano Composer
This guide explains how to integrate Piano Composer with Batch to enhance your engagement strategy by retargeting users after a Piano experience is displayed on your website.
Overview
Piano Composer is a customer journey orchestration tool that allows you to display experiences on your website based on user behavior, triggers, and conditions. You can use it to drive conversion actions such as account creation, premium content access, or adblocker circumvention.
By connecting Piano Composer to Batch, you can trigger campaigns (e.g., Web Push or Email) after a user has seen a Piano Experience but hasn't completed the expected conversion.
1. Forward Piano Composer Events to Batch
Use Piano's callbacks to forward user interaction data to Batch via Web Tagging.
Open your Piano dashboard and access the Experience you want to track.
In the "Embed Code" section, insert Batch Web Tagging methods into the existing script.
Piano's callbacks will then send the relevant event data to Batch automatically.
You can find a sample integration script here.

2. Use Piano Events in Batch Automations
Once events are forwarded to Batch, you can use them to trigger automations directly in the Batch dashboard.
For example, target users who saw an account creation prompt but did not convert.

3. Use the "Run JS" Action for Custom Triggers
In addition to callbacks, Piano Composer lets you execute JavaScript when an experience is shown.
Use the Run JS action to call Batch methods manually, making it possible to:
Send custom events
Set user attributes
Trigger advanced scenarios for all users targeted by the Experience

Last updated
Was this helpful?