How to integrate Piano Subscriptions

If you use Piano to manage your subscriptions you can integrate it using our SDK or you can set it up via integration. The integration automatically takes care of:

  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 might have limited access to Piano subscription details, potentially leading to the omission of certain conversion events.

This integration proves helpful for initiating your experience with the tool and gaining insights from preliminary data. Keep in mind that, as your development resources become available, you can further enhance your control and customization by taking ownership through tailored development using the SDK.


You can configure the Piano following the following steps:

  1. Create a new Piano tag experience
  2. Map the different Piano RIDs to the user stage journey
  3. In case you have different RIDs for different types of subscribers like Print, Print and digital or other combinations you can map them out to custom stage journeys. Map the stages you create to the Piano RIDs using the dropdown:
  4. The provided conversion name will be used to track new subscriptions automatically
  5. Publish the experience

Within a few minutes you’ll start seeing data coming through in real time on the Customer journey faceted filtering.

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

Where to get the Piano RIDs

The Piano RIDs can be found on Piano UI > Manage > Resources. The RID is the string on the screenshot identified as XXXXXXX


Make sure that Marfeel SDK loads before the Piano SDK. Due to technical reasons if the Marfeel SDK is not subscribed to events from the Piano SDK when the latter initializes the events will be lost and conversions data won’t be accurate.

1 Like