Already have an account? Sign in

Segment

Segment feature snapshot

A high-level look at Stitch's Segment (v1) integration, including release status, useful links, and the features supported in Stitch.

Connecting Segment

Connecting your Segment data to Stitch is a three-step process:

1. Add Stitch as a selective integration
2. Add Segment as a Stitch data source
3. Authorizing Stitch to access Segment

Add Stitch as a Selective Integration

All data collected by Segment is sent to us by default, but if individual snippets on your site specify which integrations data should be sent to, then these settings will be overridden.

If you useselective integration snippets, you’ll need to add Stitch to the list of integrations before data will flow to your data warehouse.

Here’s an example of a snippet that sends data to Stitch, Mixpanel, and KISSMetricsonly:

},{integrations:{'All':false,'Stitch':true,// 'true' indicates if the integration receives data'Mixpanel':true,'KISSmetrics':true}});

When you add Stitch to your snippet, make sure you enter Stitchexactly as it appears in the example above.

Add Segment as a Stitch data source

1. Sign into your Stitch account.

2. On the Stitch Dashboard page, click theAdd Integration button.

3. Click theSegment icon.

4. Enter a name for the integration. This is the name that will display on the Stitch Dashboard for the integration; it’ll also be used to create the schema in your destination.

   For example, the name “Stitch Segment” would create a schema calledstitch_segment in the destination.Note: Schema names cannot be changed after you save the integration.

5. ClickEnable With Segment.

Authorize Stitch to Access Segment

Lastly, you’ll be directed to Segment’s website to complete the setup.

1. Enter your Segment credentials and clickLogin.
2. From the dropdown menu, select theSource you want to send data from.Note that Stitch will only ever read your data.
3. ClickSend Data.
4. After the authorization process successfully completes, you’ll be redirected back to Stitch.
5. ClickAll Done.

Replicating Segment Data

Stitch uses what is called adirect integration to integrate with Segment. This is a webhook-based method of sending your Segment data to integrations. Unlike REST or SOAP APIs,webhooks deliver data as it happens in real-time.

In the event that our webhook service experiences downtime, you may notice some lag between an event occurring and the data appearing in your data warehouse.

Segment Schema

Each of Segment’s endpoints contains a set of fields unique to that endpoint along with a set of common fields. Common fields are the same across all of Segment’s endpoints.

Common fields describe user identity, timestamping, device, network, and so on. For a full list of these fields, check out Segment’sCommon Fields Spec.

Included Tables

Stitch's Segment integration includes these tables:

• group
• identify
• page
• screen
• track

Did this article help? If you have questions or feedback, feel free tosubmit a pull request with your suggestions,open an issue on GitHub, orreach out to us.