Appcues iOS SDK allows you to integrate Appcues experiences into your native iOS and iPadOS apps.
The SDK is a Swift library for sending user properties and events to the Appcues API and retrieving and rendering Appcues content based on those properties and events.
- Appcues iOS SDK
Add the Appcues iOS SDK package to your app. There are several supported installation options. A tutorial video is also available for reference, showing an installation using Swift Package Manager.
Appcues supports integration with Segment's analytics-swift library. To install with Segment, you'll use the Segment Appcues plugin.
Add the Swift package as a dependency to your project in Xcode:
- In Xcode, open your project and navigate to File β Add Packagesβ¦
- Enter the package URL
https://github.com/appcues/appcues-ios-sdk
- For Dependency Rule, select Up to Next Major Version
- Click Add Package
Alternatively, if your project has a Package.swift
file, you can add Appcues iOS SDK to your dependencies:
dependencies: [
.package(url: "https://github.com/appcues/appcues-ios-sdk", from: "3.0.0"),
]
- Add the pod to your Podfile
pod 'Appcues'
- In Terminal, run
pod install
An XCFramework is attached with each release.
- Download
AppcuesKit.xcframework.zip
attached to the latest release and unzip. - In Xcode, open your project and navigate to File β Add Files to "<Project>"β¦
- Find the XCFramework in the file navigator and select it
- Ensure the option to "Copy items if needed" is checked and that your app's target is selected
- Click Add
- Select your project in the Project navigator, select your app target and then the General tab. Under Frameworks, Libraries, and Embedded Content, set AppcuesKit.xcframework to Embed & Sign
After installing the package, you can reference Appcues iOS SDK by importing the package with import AppcuesKit
.
An instance of the Appcues iOS SDK should be initialized when your app launches. A lifecycle method such as application(_:didFinishLaunchingWithOptions:)
would be a common location:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
let appcuesConfig = Appcues.Config(
accountID: <#APPCUES_ACCOUNT_ID#>,
applicationID: <#APPCUES_APPLICATION_ID#>)
appcues = Appcues(config: appcuesConfig)
}
Initializing the SDK requires you to provide two values, an Appcues account ID, and an Appcues mobile application ID. These values can be obtained from your Appcues settings. Refer to the help documentation on Registering your mobile app in Studio for more information.
During installation, follow the steps outlined in Configuring the Appcues URL Scheme. This is necessary for the complete Appcues builder experience, supporting experience preview, screen capture and debugging. Refer to the Debug Guide for details about using the Appcues debugger.
During installation, follow the steps outlined in Configuring Push Notifications.
In order to target content to the right users at the right time, you need to identify users and send Appcues data about them. A user is identified with a unique ID.
identify(userID:)
After identifying a user, you can optionally associate that user with group.
group(groupID:)
Events are the βactionsβ your users take in your application, which can be anything from clicking a certain button to viewing a specific screen. Once youβve installed and initialized the Appcues iOS SDK, you can start tracking screens and events using the following methods:
track(name:)
screen(title:)
Anchored tooltips use element targeting to point directly at specific views in your application. For more information about how to configure your application's views for element targeting, refer to the Anchored Tooltips Guide.
Add AppcuesFrameView
instances in your application layouts to support embedded experience content, with a non-modal presentation. For more information about how to configure your application layouts to use frame views, refer to the guide on Configuring an Appcues Frame.
Implement AppcuesCustomComponentViewController
instances and register them with Appcues to take advantage of building your own components and using them in experiences. For more information refer to the guide on Configuring an AppcuesCustomComponentView
Refer to the full Getting Started Guide for more details.
SDK Documentation is available at https://appcues.github.io/appcues-ios-sdk/documentation/appcueskit and full Appcues documentation is available at https://docs.appcues.com/
The Examples
directory in repository contains full example iOS apps demonstrating different methods of installation and providing references for usage of the Appcues API.
See the contributing guide to learn how to get set up for development and how to contribute to the project.
This project is licensed under the MIT License. See LICENSE for more information.