Migrate from another service

Our JavaScript snippet works similarly to other platforms, but you may need to do a bit of work to move from another service to Customer.io.

Migrating from Segment

Our calls are nearly identical to Segment’s. We use the same analytics variable and method names, so you won’t have to replace any code. Simply replace your Segment script with the Data Pipelines script, and you’re all set.

However, Segment supports a wider range of destinations than we do. Before you make the switch, check that we support your destinations and the 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 you expect before you move from Segment to Data Pipelines.

Migrating from Customer.io’s JavaScript snippet

Customer.io has two JavaScript libraries—one specifically for Journeys and one for Data Pipelines.

The Data Pipelines JavaScript library makes your website a source for both Customer.io journeys and other destinations. The Journeys JavaScript library only sends data to your Customer.io workspace; it does not send calls through Data Pipelines or directly to other destinations.

To migrate from the Journeys snippet to Data Pipelines, you’ll need to:

  • Add the Data Pipelines JavaScript source to your website.
  • Update requests to use analytics rather than _cio and update the structure of your identify calls. Most other requests are the same.

But, even if you implement Data Pipelines, you might still keep the Journeys library on your website to take advantage of features like In-App Messaging. If you’re using both snippets, you’ll want to:

  • Update calls to use the Data Pipelines JavaScript library. The format of calls from the Data Pipelines library are slightly different from the Journeys library.
  • Disable automatic page tracking (set data-auto-track-page to false) in the Journeys JavaScript library. This prevents you from sending duplicate page calls on every page—once from the Data Pipelines JavaScript library and again from the Journeys JavaScript snippet.

Differences between Data Pipelines and Journeys identify calls

With Journeys, a person’s id was a part of their other attributes. When you use the Data Pipelines library, the id is its own argument, separate from a person’s attributes.

analytics.identify('12091906-01011992', {
  name: 'cool person',
});

analytics.identify({
  id: '12091906-01011992',
  name: 'cool person',
});

Migrating from Rudderstack

Our calls are nearly identical to Rudderstack’s. However, their calls are attached to rudderanalytics and ours use analytics. You won’t have to replace your calls, but you should change instances of rudderanalytics to analytics after you replace your Rudderstack JavaScript with the Data Pipelines script.

Keep in mind that Rudderstack supports a wider range of destinations than we do. Before you make the switch, check that we support your destinations and the 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 you expect before you move from Rudderstack to Data Pipelines.

Copied to clipboard!
  Contents
Is this page helpful?