Set Up Visit Detection Notifications & Criteria

Manage Venue Filters

Once you've implemented the Pilgrim SDK, you can choose to be notified for all venues or filter for a subset of venues based on categories, chains, and/or a specific venue.

By default, your account is set up to notify you about All Venue Types.

To modify the notifications you receive:

  1. On the Configuration page for the Pilgrim SDK, in the Venue Filters section, select the Customize Venue Types radio button.
  2. To filter by venue category, click on the Filter by Category drop-down and make your selection.
  3. To filter by venue chain, click on the Filter by Chain drop-down and make your selection.
  4. To filter by a specific venue, click on the Filter by Venue drop-down and make your selection.

    Note that if you are filtering by a specific venue, you will need to select the geographical location first.

  5. Click Save to ensure your notification filters are saved.

General Criteria

Minimum Confidence Level

The minimum confidence level that triggers a Pilgrim notification can be set from your Pilgrim console.

Available settings are:

  • None = confidence that an event occurred is <70%
  • Low = confidence that an event occurred is 70%
  • Medium = confidence that an event occurred is 80%
  • High = confidence that an event occurred is 90%

Depending on your use case, it may make sense to use a confidence level that is higher or lower. For testing purposes, we recommend setting the confidence to All. Setting the confidence to All will trigger a pilgrim notification for every stop, even if it's below the Low confidence threshold. While testing you can observe the confidence level of notifications to decide on the level that is most suitable for your app. For reference, the Foursquare app uses a confidence level of Medium or above to send users push notifications.

By default, the Minimum Confidence Level is set at All.

To modify the confidence levels used for your app:

  1. On the Configuration page for the Pilgrim SDK, in the General section, click on the Minimum Confidence Level drop-down.
  2. From the Minimum Confidence Level drop-down, select the confidence level of your choice.
  3. Click Save.

Include Other Events

After 3-7 days of use, the SDK will determine the user’s home and work location. If you would like to see these events, you can enable the Include events for Home stops and Include events for Work stops checkboxes.

If you would like to know when a user leaves a venue, please enable Include departure events.

Enable Include other probable venues if you want to receive an object of nearby venues. Please note that if the minimum confidence level is not met for the nearby venues, then the nearby venue will not be triggered. When using this setting, we recommend setting the Minimum Confidence Level to All.


Did this page help you?