yusuf-a/wootricsdk-ios

Wootric iOS SDK to show NPS, CSAT and CES surveys

Requirements

• iOS 8.0+

Demos

• View the iOS demo video with referral prompt here.
• View the iOS demo with App Store rating prompt here.

Installation

Using CocoaPods

The easiest way to get Wootric into your iOS project is to use CocoaPods.

1. You can install CocoaPods using

   $ gem install cocoapods

2. Create a file in your Xcode project called Podfile and add the following line:

   pod "WootricSDK", "~> 0.19.1"

3. In your Xcode project directory run the following command:

   $ pod install

4. CocoaPods should download and install the Wootric SDK, and create a new Xcode .xcworkspace file. Close your Xcode project and open the new .xcworkspace file.

Manually

If you want to, you can download the SDK and add it to your project without using any dependency manager. Note: Make sure you are using the latest version of Xcode and targeting iOS 8.0 or higher.

1. Download & unzip the Wootric SDK

2. In your Xcode project, go to General and drop the WootricSDK.framework on Embedded Binaries

Make sure the "Copy items if needed" checkbox is checked.

Initializing Wootric

WootricSDK task is to present a fully functional survey view with just a few lines of code.

1. Import the SDK's header:

   #import <WootricSDK/WootricSDK.h>

2. Configure the SDK with your account token

   [Wootric configureWithAccountToken:<YOUR_TOKEN>];

   You can find the account token in your Wootric's account settings

3. To display the survey (if user is eligible - this check is built in the method) use:

   [Wootric showSurveyInViewController:<YOUR_VIEW_CONTROLLER>];

And that's it! You're good to go and start receiving customer's feedback from your iOS app.

For more information on class methods, please refer to Wootric's docs.

Example

// Import Wootric
@import WootricSDK;

// Inside your view controller's viewDidLoad method

[Wootric configureWithAccountToken:YOUR_ACCOUNT_TOKEN];
[Wootric setEndUserEmail:@"[email protected]"];
[Wootric setEndUserCreatedAt:@1234567890];
// Use only for testing
[Wootric forceSurvey:YES];
// show survey
[Wootric showSurveyInViewController:self];

License

The WootricSDK is released under the MIT license. See LICENSE for details.

Contribute

If you want to contribute, report a bug or request a feature, please see CONTRIBUTING for details.