Skip to content

mParticle

Using Plot Projects and mParticle together allows you to segment your users based on the places they visit and add a location-intelligence layer to your marketing campaigns. You can, for example, segment and send push notifications to users whom you have qualified as 'Train Commuters’ based on who visited a train station more than eight times in the last week.

Set up a Listening Campaign in the Plot Projects dashboard

Plot Projects offers a Geo SDK easily connects to the mParticle SDK. Once this is done you can create Listening Campaigns in the Plot Projects dashboard that track visits of your users.

The first step is to create the locations you want to track. This can be a single location like a train station:

mParticle polygon

Or a large set of locations:

mParticle multiple locations

Once your locations are set up, you can create a Plot Projects Listening Campaign defining the Segment you’d like users to be added after visiting the designated location(s).

When creating the campaign, set the field ‘Listening campaign Data’ with the tag value

visited_train_station

mParticle listening campaign

That’s it, you’ve finished setting up the location campaigns! Users can now be automatically added to the corresponding segments in your mParticle dashboard.

Plot Projects Listening Campaigns have many options, including:

  • Trigger on geofences, polygons and/or beacons.
  • Trigger on enter, exit or dwell.
  • Define opening hours per location.
  • Define start and end dates of the campaign.

Integrating in your app

Now that your Listening Campaign is set up, your app can be location-aware and track the events in mParticle. This integration guide is designed for iOS and Android, but also works for other supported platforms of the Plot SDK. After completing the integration guide, if a user enters the station, Plot triggers a mParticle event that will show up in the mParticle dashboard.

Start with the Plot Projects integration guide and the mParticle integration guide. After integrating both libraries, you can track geotrigger events from Plot Projects in mParticle.

To receive geotrigger events from Plot Projects add the plotHandleGeotriggers method to your AppDelegate.m file. In that method you also call the mParticle API in order to send the event.

Add to AppDelegate.m

- (void)plotHandleGeotriggers:(PlotHandleGeotriggers*) geotriggerHandler {
    for (PlotGeotrigger* geotrigger in geotriggerHandler.geotriggers) {
        NSString* data = [geotrigger.userInfo objectForKey:PlotGeotriggerDataKey];
        MPEvent *event = [[MPEvent alloc] initWithName:data type:MPEventTypeLocation];
        NSLog(@"Tracking event with properties:(%@)",data);
    }
    [geotriggerHandler markGeotriggersHandled:geotriggerHandler.geotriggers];
}

The plotHandleGeotriggers method, presented above, sends an event to mParticle using the data field set in the dashboard as key and the current timestamp as value.

What's next

Users are now added automatically to the corresponding segments in the mParticle dashboard. You can now target or create location-based marketing campaigns for these segments.