You can migrate users who have consented to push notifications on another provider to Piano ESP so that you can continue delivering notifications to users who have previously opted in. To do this follow these steps:
-
Configure push notifications in the Piano dashboard by following these instructions.
-
On your website, replace your previous provider's integration code with the Piano integration code.
-
To mark push list(s) to which your existing customers should get, please click the Edit push list option and enable the Automatically renew subscription switcher (by default the switcher is disabled). This option is available as well when you create a new push list:
For ESP to resubscribe a user from a different provider the subscribed user needs to visit your website once after your website has been integrated with the Piano SDK. To make the process more efficient we recommend the following strategies:
-
Send a newsletter using ESP prompting users to visit your site to access relevant content.
-
You will have about 24 hours to continue to use your old provider's functionality on your website. You can send push notifications to your subscribers using your old provider, and ESP will register them to your new push list.
There is currently no mechanism to automatically migrate push subscriptions from ESP to another push notification provider. The responsibility for implementing such migration lies with the new provider, who needs to be able to import active push subscriptions.
Other migration options
In addition to an unconditional subscribers migration option outlined above, which is the most common case of moving existing push notification users from an old provider to Piano ESP, we have two other ways of migrating specific subscribers subsets.
Both options require certain additional steps to be undertaken in comparison to the generic approach of whole subscribers base migration.
Server-side migration
A pre-requisite to this option would be the possibility/agreement of the old provider to export:
-
A desired list of push subscriptions (possibly previously segmented)
-
A set of security keys used to sign the above-mentioned subscriptions (so-called VAPID keys)
If both counterparts are available for export, then the list of subscriptions along with VAPID keys should be handed over to the Piano Support for import into Piano ESP. In this case, there is no need to roll over existing subscribers through a usual subscribers migration mechanism: all desired subscribers shall be imported at once, into a separate push list.
Client-side conditional migration
IMPORTANT: this option requires a certain amount of custom development by the Piano ESP team and, therefore, requires explicit pre-approval by an Account Manager, on a case-by-case basis, in order to be considered feasible.
In case it is possible to designate each browser session as the one which has to be migrated over to Piano ESP while a visitor is on a website (e.g. client-side), a methodology can be put in place for Piano ESP to later pickup only those designated browser sessions. In this case, the process shall be carried over in several stages.
-
Initially, the client consults with Piano ESP Support on the feasibility and technical requirements of this option.
-
Once technical details are outlined, the client, still working with the old / existing push notifications delivery provider should start marking desired user browser sessions client-side with a pre-agreed mark (a cookie /JS call / etc. > to be agreed on Step 1).
-
The integration should be kept in this state for a certain prolonged period of time (e.g. 1-2 months at minimum) to make sure that all potential subscribers that should be migrated have properly marked browser sessions.
-
Once this period is completed, the integration should be switched over from the old / existing push notifications provider to Piano ESP. From then on, Piano ESP will be picking up and re-importing only those push subscribers whose browser sessions were correspondingly marked during Step 3 above. With time, this method will pick up the majority of the still active marked subscribers into Piano ESP push lists.