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 Airship.

With Airship messaging you can use mParticle to capture tags and events. With Real-Time Data Streaming you can send unique events back to mParticle.

Integration

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

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

With the Airship SDK and kit installed in your project, you can use 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 Airship events:

mParticle EventAirship Mapped Name
purchasepurchased
add_to_cartadded_to_cart
clickbrowsed
add_to_wish_liststarred_item
  • To use mParticle's Lifetime Value feature, you must specify an event name for 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 Airship tag is set: key If the user attribute contains a value the following format is used to set the tag key-value.

mParticle Setup

  1. Log in to mParticle.
  2. Add Airship and create the token. Follow mParticle's configuration steps. You will paste the token in the next step.

Airship Setup

  1. Open your project from the dashboard, then click Settings and select Real-Time Data Streaming.

  2. Under the Integrations heading, click mParticle.

  3. Configure a new mParticle integration:
    • Enter a user-friendly name and description.
    • Paste the Token from the mParticle setup steps above.
    • Choose one or more event type:

      • Control
      • Rich Read, Delivery, and Delete Events
      • In-App Message Expiration, Resolution, and Display Events
      • Region
      • Uninstalls
  4. Click the Save button.

FAQ

What do I do if I already have the Airship SDK in my app and want to add mParticle's SDK?
In order to send events from mParticle to Airship, either:
  • Reinstall the kit through mParticle for a SDK update and to map the events.
  • Map mParticle events to Airship--specific events, e.g., tags, custom events, etc.
How do I update the Airship SDK when it was originally installed via the mParticle SDK?
You can specify a newer 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 Airship? What attributes or properties are sent?
See: SDK Details.
In mParticle's advanced ecommerce events, what events are passed to 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 Airship?
Location events are not automatically tracked in the co-SDK integration. See: Intro to Automation: Location Triggers.

Use Cases

  • Target users in 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 Airship.

Reference