Mobile App Sources

Updated

Unlike most other sources, our mobile sources aren’t just a way to pass data from one platform to another. They support push notifications and in-app messages from Customer.io Journeys!

How mobile SDKs work

When you integrate our mobile SDK into your app, you’ll gain support for mobile messages and the ability to send your app data to downstream destinations like your analytics platform, your marketing automation suite (Customer.io Journeys), and so on.

We currently have SDKs for iOS (Swift), Android, React Native, and Flutter.

flowchart LR a(Your app)-->|Audience activity|b((Data Pipelines)) c-->|Send messages
to your audience|a b-.->d(Your analytics platform) b-.->e(Your CRM) b-->c(Customer.io Journeys)

Minimum versions

Our SDKs became “integration sources” in fairly recent releases. If you’re on a release older than the ones listed below, you’ll need to upgrade to take advantage of all our integration features—like support for anonymous activity.

PlatformMinimum “source” version
iOS (Swift)3
Android4
React Native4
Flutter2
ExpoComing soon!
an image showing an Android Track API source and an iOS native source both connected to data pipelines.

Create a mobile source

To support our mobile SDKs, you’ll first need to create your sourceA source is a website or server that you want to capture data from—it’s a source of data!, providing you with API credentials you’ll use to initialize the SDK and communicate with Customer.io.

By default, your iOS source isn’t connected to anything; you have to tell us where you want to send your mobile data. As a part of this process, you’ll connect your mobile source to your Journeys workspace—Customer.io as both source and destination. You must connect your source to your Journeys destination to take advantage of push and in-app messaging features.

  1. In the Data Pipelines tab, click Sources.
  2. Click Add Source and pick a Mobile source.
  3. Enter a Name your source, like My iOS App.
  4. We’ll present you with credentials that you’ll use to initialize the SDK. Copy them and keep them handy.
  5. Click Complete Setup to finish setting up your source. But you’re not done yet!
    Set your name, get your CDP API Key, and click Complete Setup
    Set your name, get your CDP API Key, and click Complete Setup
  6. Select your Journeys workspace on the right-side of the Connections page.
    select the Journeys destination you want to connect your iOS source to
    select the Journeys destination you want to connect your iOS source to
  7. Click Add source and select the source you set up in previous steps. This tells Customer.io to send data from your app to your Customer.io workspace.
    connect your iOS source to your journeys workspace
    connect your iOS source to your journeys workspace

The connections page shows your source connected to your Journeys workspace. Hover over a source or destination to see its active connections. While we connect your source to your Journeys workspace by default, you can connect your source to other destinations so you can use your data wherever it benefits you—like your analytics platform, a CRM, and so on.

Now you’re ready to integrate the SDK into your app! See our SDK developer documentation for help with the integration process.

the connections page, showing an ios source connected to a journeys destination
the connections page, showing an ios source connected to a journeys destination
Copied to clipboard!
  Contents
Is this page helpful?