9

Quick Start Guide

This guide contains the minimum steps you’ll need to follow to install and start using the Customer.io SDK in your iOS app.

Prerequisites

Before you start, you’ll need two keys. See Authentication you don’t have them, or don’t know where to find them.

• Your sourceA source is a website or server that you want to capture data from—it’s a source of data! API Key (sometimes referenced as a CDP_API_KEY).
• Your Site IDEquivalent to the user name you’ll use to interface with the Journeys Track API; also used with our JavaScript snippets. You can find your Site ID under Settings > Workspace Settings > API Credentials to initialize the CioMessagingInApp package.

1. Add dependencies in XCode

1. Follow Apple’s instructions to add https://github.com/customerio/customerio-ios.git as a dependency to your project in Xcode and select all the packages.

    Do you use CocoaPods?

   We typically recommend that you install the SDK using Swift Package Manager (SPM). But if your app uses CocoaPods, you can find and install our pods by replacing Cio with CustomerIO/ in our package names—e.g. CustomerIO/DataPipelines.

2. Set the Dependency Rule to Up to Next Major Version. While we encourage you to keep your app up to date with the latest SDK, major versions can include breaking changes or new features that require your attention.

   

   

2. Set up your app

The process changes slightly depending on whether you use Apple’s Push Notification service (APNs) or Google’s Firebase Cloud Messaging (FCM) service.

Click the steps below to highlight relevant code samples.