Spec Overview

The Segment Spec provides guidance on meaningful data to capture, and the best format for it, across all of Segment’s libraries and APIs. If you implement Segment using these formats, it’s simple to translate your data to downstream tools.

Event and Product Limits

Events ingested by Segment are subject to defined Product Limits.

The Segment Spec has three components.

First, it outlines the semantic definition of the customer data Segment captures across all libraries and APIs. There are six API calls in the Spec. They each represent a distinct type of semantic information about a customer. Every call shares the same common fields.

  • APIs
    • Identify: who is the customer?
    • Track: what are they doing?
    • Page: what web page are they on?
    • Screen: what app screen are they on?
    • Group: what account or organization are they part of?
    • Alias: what was their past identity?

Second, it details the event data Segment captures across some cloud sources and destinations.

Third, it shares the events Segment recommends you track for a particular industry based on experience working with thousands of customers. When you respect these specs, Segment maps these events to particular features within end destinations like Google Analytics and Facebook Ads.

This page was last modified: 18 Apr 2024

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account