SDK Overview

The ForeSee® Mobile SDK ships as two AAR files that contain ForeSee’s mobile product: Trigger. The current version of the SDK supports Android 5.0+.


The Trigger module allows you to define loyalty criteria, which is the number of pages viewed to qualify, and track a user’s progress towards fulfillment. Once the loyalty criteria is met, the user is automatically invited to participate in a satisfaction survey.

Instrumenting Your App

Once you have incorporated the SDK into your app (see the Getting Started article), you are responsible for instrumenting the app. There are two main decisions you need to make:

  1. Defining the loyalty criteria - All configuration is done through the provided foresee_configuration.json file that was added in Step 2 of the Instrumenting your code section of the Getting Started article. Please consult the Configuration article for more information.

  2. Checking if the user has met the loyalty criteria - The Trigger module automatically tracks the user's progress towards fulfilling the loyalty criteria, but you must decide when to check if the user has become eligible for a survey. There is a single API method, ForeSee.checkIfEligibleForSurvey(), that you can call to check the user’s current eligibility status. If the user has fulfilled the loyalty criteria and is in the sampling pool, an invitation is presented. It is recommended to call ForeSee.checkIfEligibleForSurvey() when the app is launched and when the app is resumed.

Other Resources

  • Sample projects: These can be found on Github and provide examples of how to implement the SDK in a number of different scenarios.

  • API docs: These are included in the SDK, but also found here. These documents explain the various functions available within the app and how to use them.