Skip to content

apptentive/apptentive-ios

Repository files navigation

Apptentive iOS SDK

Note: This repository hosts Versions 5.3.4 and earlier. Version 6.0 is now available at https://github.com/apptentive/apptentive-kit-ios

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.

See our Quick Start Guide to get up and running as quickly as possible.

For complete information on installing and using Apptentive, please see our iOS integration reference.

Installation

Apptentive can be installed using CocoaPods or Carthage, or manually as an Xcode subproject.

Using Apptentive in your App

To begin, you will have to initialize the Apptentive SDK:

@import Apptentive;
...
ApptentiveConfiguration = [ApptentiveConfiguration configurationWithApptentiveKey:@"<#Your Apptentive App Key#>" apptentiveSignature:@"<#Your Apptentive App Signature#>"];
[Apptentive registerWithConfiguration:configuration];
...
[Apptentive.shared engage:@"event_name", from: viewController];

Or, in Swift:

import Apptentive
...
if let configuration = ApptentiveConfiguration(apptentiveKey: "<#Your Apptentive App Key#>", apptentiveSignature: "<#Your Apptentive App Signature#>") {
	Apptentive.register(with: configuration)
}
...
Apptentive.shared.engage(event: "event_name", from: viewController)

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

API Documentation

Please see our Customer Learning Center 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 Example App

To see an example of how the Apptentive iOS SDK can be integrated with your app, take a look at the iOSExample app in the Example directory in this repository.

The example app shows you how to integrate using CocoaPods, set your Apptentive App Key and Apptentive App Signature, engage events, and integrate with Message Center. See the README.md file in the Example directory for more information.

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:[email protected].