Skip to main content

Piano

Subsets supports syncing data to Piano using the Update user /publisher/user/update API endpoint.

The following four Custom Fields in Piano ID will be created:

{
'subsets_experiment_id',
'subsets_experiment_added_at',
'subsets_experiment_name',
'subsets_subscriber_churn_risk',
'subsets_experiment_assignment'
}

Setup guide

Provide the following for both your production and sandbox environments.

  1. Share the Application Id and API Token from your Piano dashboard.
  2. Share your base urls (eg. api.piano.io, sandbox.piano.io).
  3. Add the Custom Fields specified in Custom Fields.

Custom Fields

Please add the following custom fields for users (https://docs.piano.io/custom-fields-in-piano-id/#createfields).

Field IdTitleFieldTypeDescription
subsets_experiment_idSubsets Experiment IdtextIndicates the contact is selected to participate in a Subsets retention experiment. The experiment id is provided when creating an experiment in Subsets platform.
subsets_experiment_added_atSubsets datetime for when the subscription was added to the experimentdateIndicates the date and time the contact was selected to participate in a Subsets retention experiment.
subsets_experiment_nameSubsets experiment name.textSubsets descriptive name of experiment.
subsets_subscriber_churn_riskSubsets probability subscriber will churn within 30 days.numberSubsets probability subscriber will churn within 30 days.
subsets_experiment_assignmentSubsets Experiment Treatment or Control assignmenttextIndicates if the subscriber is in the experiments treatment or control group.