Foursquare LogoFoursquare Developers Logo

The Pilgrim Console's Event Logger is a useful tool that helps provide visibility into device activity while you are working to confirm Pilgrim is properly implemented into your app.

Registering Devices

Before your Pilgrim Event Logger will start tracking activity, you must first register the devices that you'd like to see event logs for. You do this by going to the Event Logs section and clicking the Manage IDs link in the top right corner:

Screenshot showing blank slate of Event Logs section of Pilgrim Console.

To add the new ID to track, you'll be asked to select the ID type:

Screenshot showing Add New ID form on Manage IDs page.

You have three options:

  • Install ID: this is an ID specifically created by Pilgrim for each installation. If your app is uninstalled and reinstalled on this device, the Install ID will change and you'll need to remember to add the new Install ID to continue logging events. An example: 8F8FD055-E2BE-497F-B666-49E4ED69D2A1. In Swift, you can get this by calling: PilgrimManager.shared().installId
  • Ad ID: this is also referred to as the MAID. Apple's Mobile Ad ID is known as the IDFA, or ID for Advertisers. An example: 231A005B-700F-4119-zB1CE-991EAB2B605D. Google’s Mobile Ad ID is known as AAID, or Android Advertising ID. This is different than the Android ID, which was Android’s permanent device ID. An example: c14e7fb1–4476–4b21-ba18–063-c35c0a3b. Note: These IDs are not hardcoded to a mobile device and can be reset or blocked by users. Both Apple and Android users can reset their MAIDs to flush all data. Apple users can also block ad tracking entirely, which resets the MAID to all zeros. For Swift, you can do something like: ASIdentifierManager.shared().advertisingIdentifier.uuidString
  • User ID: Pilgrim gives developers the ability to set Custom User Data. This allows you to then identify that user based on your own predefined ID.

Once you've registered the ID's you want to log events for, you'll see them listed and as they start generating visits or triggering geofences, the events will begin showing up in the logs.

Viewing Events

As your registered devices start triggering event activity, those events will start showing up in the Event Logs:

Screenshot showing Event Logs section with example visits.

To get more information about each individual event, just click the row and you'll see more details:

Screenshot showing detailed event modal in the Event Logs section.

Note: Event Logs only show events for the last 7 days. Past 7 days, events are dropped and no longer accessable.

Next Steps

Now that you are familiar with the Pilgrim Event Logs, here are additional resources that can help you successfully integrate with Pilgrim: