ForeSee Developer Portal

Everything you need to set up and optimize your ForeSee product. Home of developer documentation, implementation guides, and question/answer forums.

Blueprint

Getting Started

The iOS SDK is again available via CocoaPods!
We had some access issues on May 17th and May 18th which are now resolved.

CocoaPods Installation

Add the following to your Podfile:

pod 'ForeSee'

Visit the CocoaPods website for help getting started with Podfiles.

Manual Installation

If your project does not use CocoaPods, you must manually install the SDK. You can download the latest version from the following page: ForeSee iOS SDK downloads

  1. Add ForeSee.framework to your project.
  2. Add the images in the assets folder to your project.
  3. Add the following frameworks/library to your project (Build Phases -> Link Binary With Libraries):
    • AVFoundation
    • CoreGraphics
    • CoreMedia
    • CoreMotion
    • CoreVideo
    • QuartzCore
    • SystemConfiguration
    • libz
    • UserNotifications
    • Foundation
  4. Add -ObjC to the OTHER_LDFLAGS setting of your project.

Configuration and Instrumentation

Perform these steps after installation:

  1. Follow these instructions to create your foresee_configuration.json file and add it to your project.
  2. Include the SDK using:
    #import <Foresee/Foresee.h>
  3. Start the SDK in your app delegate:
- (BOOL)application:(UIApplication /*)application 
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [ForeSee start];
    // This is an optional call. Normally, it is preferred to perform
    // the eligibility check when the app is launched. But there
    // are reasons to delay the check, e.g., the app has a login
    // screen and the check must wait until users have successfully
    // been authenticated.
    [ForeSee checkIfEligibleForSurvey];
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
  // This checks eligibility when returning from a backgrounded state
  // This should not be present if an invitation is not to 
  // appear on app launch
  [ForeSee checkIfEligibleForSurvey];
}

Depending on how your foresee_configuration.json file is written, an invitation may not display right away. See the Debugging article for information on forcing the invitation to display.

Swift

In Swift apps:

  1. Add the following line to your bridging header:
    #import <Foundation/Foundation.h>
    #import <UIKit/UIKit.h>
    #import <Foresee/Foresee.h>
    
  2. Start the SDK in your AppDelegate

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
     // Override point for customization after application launch.
     ForeSee.start()
    
     // This is an optional call. Normally, it is preferred to perform
     // the eligibility check when the app is launched. But there
     // are reasons to delay the check, e.g., the app has a login
     // screen and the check must wait until users have successfully
     // been authenticated.
     ForeSee.checkIfEligibleForSurvey()
     return true
    }
    

Getting Started