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, the following instructions steps should be taken to make sure the invite appears correctly

When using local notifications, a click on the notification calls the appDelegate’s application:didReceiveLocalNotification: selector. In order for a local notification to link to a survey, the client must implement the selector as follows:

- (void)application:(UIApplication *)application 
    didReceiveLocalNotification:(UILocalNotification *)notification {
  NSString *surveyID = [ForeSee surveyIDForLocalNotification:notification];
  [ForeSee showSurveyForSurveyID:surveyID];

You should also put the following snippet somewhere in your code where it would be appropriate to prompt the user to ask if they agree to receive local notifications:

if ([[[UIDevice currentDevice] systemVersion] floatValue] >= 8) {
  [[UIApplication sharedApplication] registerUserNotificationSettings:
    [UIUserNotificationSettings settingsForTypes:
    UIUserNotificationTypeAlert categories:nil]];

If you do not add this into your project, the user will be prompted as they accept the invite.

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, 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.

Other articles in this section:

  1. Trigger Overview
  2. Invite Modes (current article)
  3. Repeat Days
  4. Sampling
  5. Multiple Measures
  6. CPP's
  7. Localization
  8. SDK Events
  9. Page views
  10. Custom Invites