Embed the most sophisticated contextual awareness engine into your app, engaging users with personalized geo-aware content and providing businesses with a deeper understanding of their customers.
Select the Pilgrim SDK by Foursquare integration from the directory and add the Feed integration. The Pilgrim Feed is an “act as” feed, which means it acts like an input from your iOS or Android app and is forwarded to partners as such. If you want to use the feed for both iOS and Android, you will need to create two configurations. When you select an ‘act as’ platform and name the configuration, you will receive an API key and secret. Save these for the next step.
In order to set up the Foursquare Pilgrim SDK integration, you must first have a Pilgrim enabled developer account with Foursquare. To get your account enabled, reach out to Foursquare here.
If you are already using the Foursquare Pilgrim SDK, head to your Pilgrim Console to enable the mParticle integration. If you know your Client ID, you can get to your Pilgrim Console directly at
From the Pilgrim Console, scroll down to the mParticle section and enter your iOS and/or Android credentials you saved from your mParticle setup.
Once you’ve entered your credentials, scroll down to the MMA Field Selection selection to choose which fields you want to send to mParticle and click the Save changes button at the bottom of the page. After a user’s next visit with Pilgrim SDK, these settings will go into effect and you will see
departure events in mParticle.
All fields are optional and configurable.
Pilgrim sends two custom events to mParticle:
departure, sent when a user arrives at or departs a venue. The following data points can be forwarded with each event.
Note that Pilgrim does not send an
accuracy attribute with location. In mParticle, this value defaults to
0 meters. In other words, location data is assumed to be perfectly accurate.
These attributes align with Foursquare’s “Visits” data.