Sign up for early access!
Apply for early access to be among the first to try out Customer.io Data Pipelines. Bear with us: it may take a few weeks for us to approve your request as we're actively working on CDP.
How it works
A destination is the place you want to send your data to, like analytics platforms, CRMs, support tools, advertising platforms, messaging platforms, and more. We reshape data from your sources to fit the shapes expected by your destination, so you can use your source data in any available destination.
Depending on your source, data travels from your source through Customer.io to your destination or directly to your destination.
- Cloud connection: data travels from your source to Customer.io and then to your destination.
- Direct connection: data travels directly from your source to the destination. Direct connection destinations are limited to our Website source and are sometimes called “web” destinations.
Pipelines)) subgraph Destinations d(Your CRM) e(Your analytics
Journeys) end a-->|JS integration|c b-->|Go, Python, or
Node integration|c c-->|Send website and
server-side data|d c-->|Send website source only|e c-->|Send website and
server-side data|f linkStyle 0,3 stroke-width:2px,fill:none,stroke:#AF64FF linkStyle 1 stroke-width:2px,fill:none,stroke:#00ECBB linkStyle 2,4 stroke-width:2px,fill:none,stroke:#0597AD
Set up a Destination
The steps involved in configuring your destination will change based on the specific destination and mode you enable. See an individual destination to learn more about the individual steps, and the information you’ll need, to connect a destination.
- Go to the CDP tab and click Connections.
- Click Add New under Destinations.
- Select the Destination you want.
- Configure your destination and click Continue.
- Select the mappings—the actions that you want to send to the destination. See Subscriptions below for more information.
You can change field mappings
In most cases, you’ll want to use default mappings with your destination. But, if you have a specialized use case and want to change the way we map fields to your destination’s events. See Mapping below for more information.
- (Optional) Select the sources that you want to connect to this destination. You can always connect sources to your destination later. You may not want to map sources to your destination
- Click Enable Destination.
You can check the Actions tab to see data as it comes in. This helps you make sure that your destination is set up correctly.
Your destination’s Actions tab shows recent data sent to the destination. You can find specific actions and look at the data as it’s sent to your destination. You might use this to troubleshoot specific source events.
When you set up a destination, you can check Mappings to change the way we map source data to your destination—or just to better understand what data we’ll send to your destination by default.
Mapping source calls to your destination
Most destinations support Actions. Actions are how we map data from sources to your destination—the “trigger” for each request, and the fields we map to your destination.
In most cases, you’ll want to stick with the defaults. But, you might disable actions that you don’t care about in your destination. Or you might click and select Edit to change the way we map data to an action—this can help you better represent your model data in your destination if our default mappings don’t quite match your use case.
See our actions guide for more information.
API Call tester
On the API Call Tester tab, you can send calls to your destination to make sure that your integration works the way you expect. It may help to run test calls before you connect a source to your destination—so it’s easier to find your tests.
API calls are formatted to fit our source API. This gives you an opportunity to see how a call from your source(s) maps to your destination.
Test calls are populated with test data. Use the dropdown to select the kind of call you want to test.
The destination Overview tab shows action volume and how many actions were completed or failed over a time frame. The overview helps you understand if your integration works as you expect, and can help you spot performance issues—failed actions or high latency.
Connection Modes: Cloud and Direct
In Cloud Mode your source sends data to our servers, which transform and forward data to your downstream destinations. This keeps the size of injected scripts in your source(s) small and load times fast. Most importantly: this mode ensures that we keep a record of data sent to your destination, which can help you audit and troubleshoot issues with your destination.
In Direct Mode, your destination expects to receive data directly from your source—without going through Customer.io’s servers. You might use this mode if your sources need to be loaded directly on a device or in a webpage. Because Direct Mode destinations don’t send data to CDP you won’t see a record of actions sent to your destination.
|Source Type||Cloud Destination||Direct (“Web”) Destination|
|Server (NodeJS, Go, Python)|
|Customer.io Journeys (Default)|
How do I tell which modes are supported by a destination?
Luckily, there are a few ways to do this. If you’re looking at the destination catalog in our docs, you’ll see icons for cloud mode () and direct mode ().
Retries: how we handle outages
If your destination suffers an outage, we’ll retry data to the destination. We retry data up to 10 times:
- The first three retries are after 10 seconds.
- The remaining seven retries are after 100 seconds.