Introduction
Brand Marketers transitioning from other platforms to MoEngage want to migrate their historical user-device data to the MoEngage platform to start leveraging the platform's capabilities to the fullest extent without any delay. As part of the transition process, the end-users of the brand need to upgrade to the new version of the brand-app which is integrated with MoEngage SDK. This typically involves a delay as the entire user-base of the brand slowly moves to the new version.
This article provides you with information on various methods that can assist you in seamlessly migrating the historical data of your users and their devices to MoEngage using server-to-server APIs. These methods simplify your migration journey, making it more convenient.
Use Cases
For a brand/business with a substantial user base, it takes time for all users to transition to the upgraded app version, delaying reaping the benefits of the platform. However, for users who have already installed the updated app version that includes the MoEngage SDK, it begins tracking their data immediately.
This gives rise to some scenarios, as mentioned below, and this article provides the solution for each scenario:
Scenario 1:
Users who have not upgraded to the latest app version integrated with MoEngage SDK cannot receive push notifications triggered from MoEngage platform.
Solution: Migrate User Device Information Using Track Device API
Because a substantial user-base have not yet upgraded to the latest app version, MoEngage SDK cannot yet track their user-device properties and events. Instead of waiting for the entire user base to update their apps to the version which is integrated with the MoEngage SDK, you can use the Track Device API to ingest user-device data attributes already available to you into MoEngage. Track Device API or Bulk Import API helps you to create/update devices of existing users or create user and their corresponding devices respectively.
Using Track device API, you can seamlessly migrate the already available device information with you, such as Push ID, GAID/ IDFV and platform information into MoEngage. MoEngage validates and accepts unique values of Push ID, GAID/IDFV and platform of every device attached to the user.
Once above device information is ingested successfully into MoEngage, you can trigger Push campaigns from the MoEngage platform.
info |
Information This method of Push notification delivery by migrating device attributes using Device API and sending push campaigns from the MoEngage platform is applicable only to Android devices. iOS devices still requires MoEngage SDK to deliver and render Push notification. Although Push notifications will be delivered for Android devices, corresponding campaign stats such as Push notification clicked will not be tracked as these events are tracked by MoEngage SDK which may not be integrated with the app version used by end-users during migration. |
Scenario 2:
Nudge users to upgrade to the latest app version integrated with MoEngage SDK by effectively targeting them.
Solution: Migrate User Device Information Using Bulk Import API
As a marketer, you can create users and their devices using the Bulk Import API of MoEngage. You can then assign a custom user attribute with a corresponding value to indicate users who should be notified about the app version upgrade.
For example, consider the custom user attribute bulk_migration and its value to be set to true for the users who have not upgraded to the latest app version. You can use this custom user attribute to create a segment, as explained below:
Create a Segment
Perform the following steps to create a segment that contains the users who have not performed the app upgrade:
- On the left navigation menu in the MoEngage dashboard, click Segment > Create segment.
- Click Filter users by, and then click the User property tab.
- In the Select attribute list, select the custom user attribute you created to mark the migrated users. In this use case, the custom user attribute is bulk_migration set to true.
- Perform the remaining steps to create the segment. For more information, refer to Create Segments.
After creating the segment, you can send campaigns to target the users in this segment and nudge them to upgrade to the latest app version integrated with MoEngage SDK.