mParticle

mParticle is a mobile data platform. Apps using the mParticle SDK collect data which is then routed to various providers configured on mParticle’s dashboard.

Integration with mParticle allows customers to route data to their analytics providers of choice, and if they are already mParticle customers it can lower the amount of work required to integrate Urban Airship.

With Engage you can start using mParticle to capture tags and events. With Connect you will be able to stream events that are unique back to mParticle.

Integration Options

Engage

The Urban Airship Engage/mParticle integration is straightforward. Simply add the Urban Airship Kit to your app’s dependencies. The kit acts as a bridge between the mParticle and Urban Airship SDKs.

We recommend following the steps provided by mParticle in: Urban Airship Kit Integration.

With the Urban Airship SDK and kit installed in your project, you can use Urban Airship user tags to group users and track behaviors. Map events and event attributes to tags in the mParticle dashboard.

SDK Details

Mapping of mParticle events occurs automatically. The following ecommerce events are mapped to Urban Airship events:

mParticle Event Urban Airship Mapped Name
purchase purchased
add_to_cart added_to_cart
click browsed
add_to_wish_list starred_item

  • To use mParticle’s Lifetime Value feature, you must specify an event name for Urban Airship. Usually these are purchase events or other events you’d like to attribute to the lifetime value of the customer.

  • Product Bags are not supported or passed by mParticle in integrations.

mParticle User Attributes

User attributes get mapped to device class tags. If the user attribute does not contain a value the following Urban Airship tag is set: key If the user attribute contains a value the following format is used to set the tag key-value.

Connect

For the Connect Integration, please contact our product team by sending a message to support@urbanairship.com with the app key you would like to have enabled. Your app key can be found by clicking the Settings (gear icon) then select APIs & Integrations and the Urban Airship API tab.

Our Connect Integration provides additional events that are not available from the device via the kit integration.

One of the key events we receive from Apple and Google are uninstall events. This is the complete list of events that are sent with our Connect integration:

  • CONTROL
  • RICH_DELIVERY
  • RICH_READ
  • RICH_DELETE
  • REGION
  • IN_APP_MESSAGE_DISPLAY
  • IN_APP_MESSAGE_RESOLUTION
  • IN_APP_MESSAGE_EXPIRATION
  • UNINSTALL

See Event Body in our Connect API reference for details.

Learn More

FAQ

What do I do if I already have the Urban Airship SDK in my app and want to add mParticle’s SDK?
In order to send events from mParticle to Urban Airship, either:

  • Reinstall the kit through mParticle for a SDK update and to map the events.
  • Map mParticle events to Urban Airship–specific events, e.g., tags, custom events, etc.

How do I update the Urban Airship SDK when it was originally installed via the mParticle SDK?
You can specify a newer Urban Airship SDK cocoapod for iOS or define a newer gradle dependency for Android. Both cocoapods and gradle resolve to the newest dependency listed. For example, the kit could define 7.0.0, but if the app wants 7.2.0, the kit will be forced to use 7.2.0.

What events are passed from mParticle to Urban Airship? What attributes or properties are sent?
See SDK Details.

In mParticle’s advanced ecommerce events, what events are passed to Urban Airship?
See SDK Details.

What is the best way to associate additional device identifiers?
We suggest setting the named user to an ID such as an email address or user ID that can be used to target a user across multiple channels. We also suggest setting associated IDs, as this can help with integration.

How do location tracking events get passed to Urban Airship?
Location events are not automatically tracked in the co-SDK integration. Follow these steps to enable location tracking for Urban Airship.

Use Cases

  • Target users in Urban Airship via tags and custom events.
  • Reach your customer on multiple channels (email, social, etc.), leveraging mobile user behavior to optimize your marketing messages.
  • Run custom analysis with mobile data via one of mParticle’s data warehouse providers.
  • Leverage other marketing platforms (email, social, etc.) with rich mobile events.
  • Pre-mapped eCommerce events from mParticle to Urban Airship.

Reference