30

Integrate with Customer.io

How it works

While you can add people to Customer.io manually or upload CSVs, you’ll get the most out of our platform when you integrate data sources and send data to Customer.io programmatically.

You can integrate with either Data Pipelines and Journeys; both provide ways to get people, events, and other data into Customer.io. But we generally suggest that you integrate with Data Pipelines rather than integrating directly with Journeys.

Data Pipelines represents the most flexible integration path: it’s the best way to get data into, and out of, Customer.io. While Journeys offers some integration options, it’s primarily a messaging platform. It’s where you’ll spend most of your time after you’ve integrated with Customer.io.

You can integrate all your data sourcesA source is a website or server that you want to capture data from—it’s a source of data! with Customer.io—your website, mobile apps, and databases.

Data sources and destinations

Customer.io integrations consist of sourcesA source is a website or server that you want to capture data from—it’s a source of data! and destinationsA destination is a place that you want to send data from one or more sources to. You can use your own workspace as a destination; send data to another service; or send data to your data warehouse.. A source is where your data comes from, and a destination is where your data goes!

Most of your integration effort involves setting up sources to send data into Customer.io—your website, mobile apps, and so on. In most cases, you’ll incorporate our SDKs to get data into Customer.io You’ll use functions like identify to add people, track to capture the events people perform, and so on.

If you want to send data to other services outside of Customer.io, you can set up destinations. Within each destination, you can set up actionsThe source event and data that triggers an API call to your destination. For example, an incoming identify event from your sources adds or updates a person in our Customer.io Journeys destination. that determine what kinds of data you want to send to that destination.

Your people are your data

In Customer.io—and in most marketing stacks—your “data” typically refers to people who use your services, the things you know about them (their attributes), and the events they perform. You’ll use this data to trigger and personalize messages, so you send the right messages to the right people at the right times.

When you identifyThe Customer.io operation that adds or updates a person. When you identify a person, Customer.io either adds a person if they don’t exist in your workspace, or updates them if they do. Before you identify someone (by their email address or an ID), you can track them anonymously. a person, you’ll capture their attributesA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages. Attributes are analogous to traits in Data Pipelines.—things like their name, email address, and more.

You’ll also track the events people perform. Events make it easy to respond to people’s behaviors in your app or on your website. For example, you can thank people for filling out a form, remind them to complete a purchase, or suggest additional content when they watch a video.

Plan your integration

Different kinds of data use different functions across the system. Knowing what data you want to capture can help you understand what calls you’ll need to make and when. For example, when you want to record attributes, you’ll use an identify call.

As you integrate with Customer.io, think about the data that you want to store:

• The identifierThe attributes you use to add, modify, and target people. Each unique identifier value represents an individual person in your workspace. values you want to use for people and the attributesA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages. Attributes are analogous to traits in Data Pipelines. you want to capture about them. you’ll add/update people with identify calls.
• The events you want to record: you’ll record events with track calls.
• The groups and relationships you want to maintain: you’ll record objects and relationships with group calls.

You can store all kinds of data in Customer.io. But be careful when handling certain kinds of data. In general, you should not send us sensitive personal information like bank account information, credit card numbers, personal health information and so on.

Integrate with Customer.io

You’ll integrate with Customer.io through Data Pipelines. You’ll set up sources, like your website, to send data to destinations—like our Journeys platform, your analytics platform, or your backend database. Almost all the work you’ll do is in setting up your sources. Then you can set up and customize the data you forward to destinations.

Add a JavaScript Source

In most cases, we suggest that you start with your web source using our client-side JavaScript library, because it not only acts as a data source but it also lets you send in-app messages to your audience. We’ll reference this library in our examples. But we also offer server-side SDKs in other languages and other sources.

1. Go to the Data Pipelines tab. On the Connections page under Sources, click Add New.
2. Select a source and then click Add Source.

   

   
3. Enter a Name for the source, and click Submit. You should give your source a name that helps you identify not only the source medium (“JavaScript” in this case), but helps you identify the resource you’re capturing data from—like “company website” or “community forums.”

   

   
4. Under Installation Instructions, you’ll find relevant code that you need to add to your website. Using our JavaScript source as an example, you’ll paste the code snippet in your website’s <head> tag.

You’re now ready to start sending calls to Customer.io. But we also recommend that you incorporate in-app messaging support so you can send relevant messages to your website visitors.

Add in-app messaging support

If you want to support in-app messaging, you’ll need to add a couple of lines to the JavaScript snippet.

1. Go to Settings > Workspace Settings and click Get Started next to In-App.

2. Click Enable in-app.

3. Return to your Workspace Settings and go to API and Webhook Credentials.

4. Copy the Site ID for the set of credentials that you want to send your in-app messages from. If you don’t have a set of credentials, click Create Tracking API Key.

   

   

5. Paste the Site ID into your JavaScript snippet or SDK configuration.

    !function(){var analytics=window.analytics=window.analytics||[];if(!analytics.initialize)if(analytics.invoked)window.console&&console.error&&console.error("Snippet included twice.");else{analytics.invoked=!0;analytics.methods=["trackSubmit","trackClick","trackLink","trackForm","pageview","identify","reset","group","track","ready","alias","debug","page","once","off","on","addSourceMiddleware","addIntegrationMiddleware","setAnonymousId","addDestinationMiddleware"];analytics.factory=function(e){return function(){var t=Array.prototype.slice.call(arguments);t.unshift(e);analytics.push(t);return analytics}};for(var e=0;e<analytics.methods.length;e++){var key=analytics.methods[e];analytics[key]=analytics.factory(key)}analytics.load=function(key,e){var t=document.createElement("script");t.type="text/javascript";t.async=!0;t.src="https://cdp.customer.io/v1/analytics-js/snippet/" + key + "/analytics.min.js";var n=document.getElementsByTagName("script")[0];n.parentNode.insertBefore(t,n);analytics._writeKey=key;analytics._loadOptions=e};analytics.SNIPPET_VERSION="4.15.3";
    analytics.load(
        "YOUR_API_KEY",
        { 
            "integrations": {
                "Customer.io In-App Plugin": { 
                    siteId: "YOUR_SITE_ID"
                }
            }
        }
    );
    analytics.page();
    }}();
    
   

Now you’re ready to send in-app messages to your website visitors!

Add Destinations

Destinations are the places you want to send, and act on, data. Sending source data to all the places where it’s useful to you eliminates “data gaps” in your stack.

Check out our destination catalog to see all the destinations we support. If you don’t find one you need, let us know!

1. Go to the Data Pipelines tab and click Connections.
2. Click Add New under Destinations.
3. Select the Destination you want.

   

   
4. (Optional) Select the sources that you want to connect to this destination. You can always connect sources to your destination later.

   

   
5. Configure your destination and click Continue. We’ve provided an example of the Customer.io Journeys destination, but yours may contain different fields based on the destination you pick.

   

   
6. Click Enable Destination.

Now your destination is set up and will start accepting data from your sources. If you want to tailor the data that your sources send to destinations, go to your destination’s actionsThe source event and data that triggers an API call to your destination. For example, an incoming identify event from your sources adds or updates a person in our Customer.io Journeys destination. tab. See Actions for more information.

Integrate your mobile app(s)

While you can write your own integration with our APIs, we strongly suggest that you integrate your mobile apps using our SDKs.

At a basic level, you must use our SDKs if you intend to send in-app messages. Beyond that, they’re already set up to help you identify people, track events, and receive push notifications, making it easy to get set up with Customer.io without writing all your own code from scratch.

When you integrate mobile apps, you’ll need to enable push and in-app messaging in your workspace. You’ll also need to set up push notifications with your push provider. See our Push Notifications documentation for more information.

Other ways to integrate

Beyond the data sources we laid out here, you can also integrate directly from a database or other sources in Data Pipelines.

Database and Reverse ETL integrations

We offer a number of reverse ETL integrations that help you send data from your database into Customer.io. If you already aggregate your data in a database or data warehouse, you can use a reverse ETL integration to keep your Customer.io workspace up to date with your latest data.

Capture message responses from Journeys

To better integrate with all your products, you can send metadata about your messages from Journeys to other services—whether people open them, click them, and so on. This kind of integration treats information from Journeys as a data source, so you can forward behavioral data from Customer.io to other services.