Migrate from another service

Updated

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.

If you still use Segment, use our Journeys Web SDK

Our Data Pipelines JavaScript snippet uses the same analytics variable and method names as Segment so you can use our snippet without changing your existing Segment calls. However, if you still use Segment, you should use our Journeys Web SDK to send data to Customer.io.

The Journeys Web SDK uses a different variable than Segment, which prevents conflicts with Segment’s calls and ensures that your data is sent to Customer.io as expected.

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.

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?