/apptentive-ios

The iOS Apptentive Client. Is your app Apptentive?

Primary LanguageObjective-CBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Apptentive iOS SDK

The Apptentive iOS SDK provides a simple and powerful channel to communicate in-app with your customers.

Use Apptentive features to improve your app's App Store ratings, collect and respond to customer feedback, show surveys at specific points within your app, and more.

Install Guide

Apptentive can be installed manually as an Xcode subproject or via the dependency manager CocoaPods.

The following guides explain the integration process:

Using Apptentive in your App

After integrating the Apptentive SDK into your project, you can begin using Apptentive features in your app.

You should begin by setting your app's API key, then engaging Apptentive events at various places in your app:

#import "Apptentive.h"
...
[Apptentive sharedConnection].APIKey = @"<Your API Key>";
...
[[Apptentive sharedConnection] engage:@"event_name" fromViewController:viewController];

Or, in Swift:

@import Apptentive
...
Apptentive.sharedConnection().APIKey = "<Your API Key>"
...
Apptentive.sharedConnection().engage("event_name", fromViewController: viewController)

Later, on your Apptentive dashboard, you will target these events with Apptentive features such as Message Center, Ratings Prompts, and Surveys.

Please see our iOS integration guide for more on this subject.

API Documentation

Please see our docs site for the Apptentive iOS SDK's API documentation.

Apptentive's API changelog is also updated with each release of the SDK.

Testing Apptentive Features

Please see the Apptentive testing guide for directions on how to test that the Rating Prompt, Surveys, and other Apptentive features have been configured correctly.

Apptentive Demo App

The Apptentive sample application FeedbackDemo is included in this repository along with the SDK.

Use FeedbackDemo to test Apptentive's features before integrating the SDK in your app. Set your API key and app ID in AppDelegate.m, and then add your events to ViewController.m.

Message Center, the Ratings Prompt, Surveys, and other Apptentive interactions can all be tested before integrating Apptentive in your own app.

Contributing

Our client code is completely open source, and we welcome contributions to the Apptentive SDK! If you have an improvement or bug fix, please first read our contribution agreement.

Reporting Issues

If you experience an issue with the Apptentive SDK, please open a GitHub issue.

If the request is urgent, please contact mailto:support@apptentive.com.