Skip to content
Login Contact

How to integrate Piano subscriptions

If you use Piano to manage your subscriptions, you can integrate it using the SDK or set it up via the no-code experience. The integration automatically handles five key areas across the conversion and subscription tracking workflow:

  1. Tracks the user journey: anonymous, registered and subscribers
  2. Maps different RIDs to different user journey stages
  3. Tracks new subscriber conversions
  4. Tracks dynamically closed articles
  5. Reconciles users using the Piano user Id
The no-code integration has limited access to Piano subscription details, which may cause some conversion events to be omitted.

This approach is useful for getting started quickly and gaining insights from preliminary data. Once development resources are available, you can take full ownership through tailored SDK implementation for greater control and customization.

Setup

Section titled “Setup”

Configure the Piano integration in the following steps:

  1. Create a new Piano tag experience Piano tag experience creation screen in Marfeel hub|690x449
  2. Map the different Piano RIDs to the user stage journey RID to user journey stage mapping configuration|690x449
  3. If you have different RIDs for different types of subscribers like Print, Print and digital or other combinations, you can map them to custom stage journeys. Map the stages you create to the Piano RIDs using the dropdown: Custom subscriber stage mapping with Piano RID dropdown|690x449
  4. The provided conversion name will be used to track new subscriptions automatically
  5. Publish the experience

Within a few minutes, data will start appearing in real time on the Customer journey faceted filtering.

TIP:
The Marfeel Piano Experience automatically tracks `anonymous` and `registered` users. No RID is needed for those stages.

Where to get the Piano RIDs

Section titled “Where to get the Piano RIDs”

Piano RIDs are located in the Piano UI under Manage > Resources. The RID is the string shown in the screenshot, identified as XXXXXXX.

Piano UI Resources screen showing the RID identifier location|690x449

Troubleshooting

Section titled “Troubleshooting”

The Marfeel SDK must load before the Piano SDK. If Piano initializes first, it fires subscription events before Marfeel can listen for them. This causes conversion data to be lost or inaccurate.

What does the Marfeel Piano integration track automatically?

The integration automatically tracks the user journey (anonymous, registered, and subscribers), maps Piano RIDs to user journey stages, tracks new subscriber conversions, tracks dynamically closed articles, and reconciles users using the Piano user ID.

Where do I find my Piano RIDs?

Piano RIDs are located in the Piano UI under Manage > Resources. The RID is the string identifier shown in the resource list.

Why is my Piano conversion data inaccurate?

The Marfeel SDK must load before the Piano SDK. If Piano initializes first, it fires events before Marfeel can subscribe to them, causing conversion data to be lost or inaccurate.