Migrate From mParticle

Looking to combine on Amplitude for both your Analytics and CDP needs?

This document covers the necessary steps to:

1. Migrate your Source and Destination configuration
2. Update SDK implementation to send data to Amplitude
3. Validate the migration is successful

Quickly review the offerings that are available for mParticle and how that stacks up to Amplitude.

Add a source

To add a new source:

1. From Data, click Sources in the Connections section.
2. Click Add Source.
3. Browse or search for the source you want to add.
4. Follow the on-screen prompts.

For detailed instructions, see the documentation for the source you want to add.

Update SDK implementation

Both mParticle and Amplitude SDKs capture first-party data by tracking user interactions. Other than some nuances around syntax, they work similarly. Here is high level mapping of concepts between mParticle & Amplitude.

1var identityRequest = {
2userIdentities: { email: 'updated-email@example.com' }
3}
4mParticle.Identity.modify(identityRequest, identityCallback);

1setUserId('12091906-01011992');
2identify(
3  Identify()
4    .set('email', 'updated-email@example.com')
5);

1mParticle.logEvent('Article Completed',
2    mParticle.EventType.EVENT-TYPE,
3    {
4        'title':'How to Create a Tracking Plan',
5        'course':'Intro to Analytics'}
6);

1track('Article Completed', {
2  title: 'How to Create a Tracking Plan',
3  course: 'Intro to Analytics',
4});

1amplitude.setGroup('Working Group', 'UNIVAC')

1groupIdentify(
2  'Working Group',
3  'UNIVAC' ,
4  new Identify()
5    .set('principles', ['Eckert', 'Mauchly']);
6    .set('site', 'Eckert–Mauchly Computer Corporation');
7    .set('statedGoals', 'Develop the first commercial computer');
8    .set('industry', 'Technology')
9);

1currentUser?.setUserAttribute("top_region", value: "Europe")

1Amplitude.instance().setUserId("abc")
2Amplitude.instance().identify(
3  AMPIdentify()
4    .set("top_region", value: "Europe")
5)

1if let event = MPEvent(name: "Video Watched", type: MPEventType.navigation) {
2event.customAttributes = ["category": "Destination Intro", "title": "Paris"]
3MParticle.sharedInstance().logEvent(event)
4}

1Amplitude.instance().logEvent("Video Watched", withEventProperties: ["category": "Destination Intro", "title": "Paris"] )

1Amplitude.instance().setGroup("orgName", groupName:NSString(string:"xyz"))

1Amplitude.instance().groupIdentifyWithGroupType(
2  "orgName",
3  groupName:NSString(string:"xyz"),
4  groupIdentify:AMPIdentify().set("plan", value: "enterprise")
5)

1IdentityApiRequest modifyRequest = IdentityApiRequest.withEmptyUser()
2    .email("updated-email@example.com")
3    .build()
4 
5MParticle.getInstance().Identity().modify(modifyRequest)

1amplitude.setUserId("abc")
2amplitude.identify(Identify().set("email", "updated-email@example.com"))

1val customAttributes: MutableMap<String, String> = HashMap()
2customAttributes["name"] = "Moto 360"
3val event = MPEvent.Builder("Product Viewed", MParticle.EventType.Navigation)
4            .customAttributes(customAttributes)
5            .build()
6MParticle.getInstance()?.logEvent(event)

1amplitude.track(
2  "Product Viewed",
3  mutableMapOf<String, Any?>("name" to "Moto 360")
4)

1amplitude.setGroup("orgName", "xyz");

1amplitude.groupIdentify("orgName", "xyz", Identify().set("plan", "enterprise"))

For all other SDKs, see the relevant SDK documentation.

Validate events

Data validation is a critical step in the instrumentation process. Amplitude lets validate your event data via Amplitude's debugging tools.

Add a destination

To add a new destination:

1. From Data, click Destinations in the Connections section.
2. Click Add Destination.
3. Browse or search for the destination you want to add.
4. Follow the on-screen prompts.

For detailed instructions, see the documentation for the destination you want to add.

Migration checklist

It's important to validate the migration to make sure there is minimal impact on downstream data consumers.

• Added all sources to Amplitude
• Migrated existing tracking code to Amplitude SDKs
• Validated events are flowing in to Amplitude correctly
• Added all destinations to Amplitude
• Validated data is flowing into destinations correctly
• Validated downstream consumers aren't affected (for example, BI, Mktg, ML, Ops)

Frequently asked questions