Trigger - Invite Modes
As touched on earlier, Trigger supports three invitation modes:
Exit Invite (New!)
In this mode, the invite appears as a local notification that appears after the app is exited. If the user accepts the invitation, they are taken to a survey page.
Exit Survey (previously ‘Local’)
In this mode, when the user accepts the survey invitation a local system notification is queued. Once the user exits the app, they see a local system notification informing them that they can take a survey.
For Exit Invite and Exit Survey modes, an icon to be displayed in the notification bar is also required.
The SDK looks for an icon named
ic_notification.png (defaults to the
res/drawable directory). However, the name of the icon to be used can be customized by setting the ‘notificationIcon’ property in the JSON configuration file.
Contact (previously ‘On-Exit’)
This invitation mode asks the user for an email address or a mobile number. After submitting the information to the ForeSee servers, the invitation is dismissed and the user is sent back into the app. No survey presents in this mode. Instead, after a period of time, the user is sent an email or an SMS text message with a link to the survey.
This invitation mode is normally a two-step process, but the second step can be skipped if correct contact details are supplied to the SDK using the
ForeSee.setContactDetails() method. The format for these contact details should be email@example.com, 555-123-1234 or 5551231234.
The client’s surveys must be configured on the ForeSee servers for this option to work properly.
Contact invitation mode may be enabled in the configuration file, but a survey link won’t be delivered unless properly configured remotely as well.
In-Session (previously ‘Immediate’)
This is the default invite mode. When Trigger is configured for this mode, the survey is displayed at the point where the user accepts the invitation. The survey is displayed in a WebView. It is automatically dismissed when the survey is completed or the user abandons the survey by pressing the Back button.