Data Out: Segment

Learn how to configure Vitally to send data back to Segment for distribution to your other destinations.

This article is about pushing Vitally's data back to Segment. If you are instead wanting to import your Segment data into Vitally, you'll want to head here.

Data Out: Segment - How Data Gets Pushed Out

Vitally pushes data to Segment via the group API. Each time we detect that an Account should be pushed to Segment (using the logic detailed below), we'll send a group call for every User in the Account. We will not send identify calls for those Users, just groups associating their id with the Customer's groupId and the traits defined here.

Data Out: Segment - Setting Up Vitally as a Source

  1. Create a new source in Segment

So that you can isolate the data sent from Vitally from your other sources, we recommend creating a new source for Vitally in Segment using the HTTP API template. That way, you can decide which destinations you want to receive data from Vitally.

  1. Add the write key to your Segment config

To access the Segment integration in Vitally,

  1. Navigate to your Settings (βš™οΈ) by selecting your Account Logo on the top left

  2. Under Data Management select Integrations (or get there via Quick Jump CMD+J).

  3. Find and select Segment

  4. Select Vitally -> Segment and Enable Segment push

  5. Add the write key for the Vitally source

  6. Select for which Users we should send a group call

  7. Select Submit Changes

  8. Now go back to Segment and connect the Vitally source to a new destination to get your data flowing!

  1. Define your group traits

Once you've setup Vitally as a Segment source, you then just need to define which Vitally account fields you want to send back to Segment as group traits. Updates to traits that are synced from Segment into Vitally will also automatically push to Segment.

  1. Go back to the Vitally Segment configuration page (steps 1-3 above)

  2. Define a mapping of Vitally account fields to named group traits.

  3. For each mapping defined, we'll add a new trait to the data we push back to Segment.


Q: Does Vitally's Segment integration work in "device" or "cloud" mode? A: We are a Segment destination, there should be no impact to your app if you already have Segment integrated to your app. To clarify further, we’re a β€œcloud” destination, so Segment does not load any of our code.

Last updated