How Do I Switchover From Segment?

The Freshpaint Javascript and Mobile SDKs are 100% compatible with Segment's SDKs. That means you can migrate with only a minimal amount of engineering resources. All your event tracking will automatically be switched over to Freshpaint.

Switching from Segment to Freshpaint takes only two steps:

  1. Setup your destinations in Freshpaint.

  2. Replace the Segment SDKs with the Freshpaint SDKs.

1. Setting up Your Destinations in Freshpaint

For each each destination you have in Segment, setup the corresponding destination in Freshpaint. This can be done in the Freshpaint destinations page. For each destination, copy and paste your credentials into Freshpaint.

You can override your destinations hardcoded into your Segment tracking code. This can be done in the Freshpaint Event Schema, and clicking on the Advanced Settings for a particular event's Destinations.

2. Replacing the Segment SDKs with the Freshpaint SDKs

First remove the Segment SDKs and replace them with the Freshpaint SDKs. For the web SDK, you can find the Freshpaint installation snippet in the Freshpaint sources page.

With that done, you need to point your Segment tracking code to Freshpaint. On web, this can be done by setting the analytics object to the freshpaint object:

window.analytics = freshpaint;

Congrats! You're Done.

After replacing the Segment SDK with the Freshpaint SDK, you've finished the migration process. We promised this would be easy. If you want to run a test to show that everything is working properly, try performing an action that would normally trigger an event in Segment. You should see that event show up in the Freshpaint Liveview and in all your destinations, too.

Last updated