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.

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.

• Cloud Sources and Destinations
  • Email
  • Live Chat
  • A/B Testing

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.

• Industry Specs
  • Mobile
  • E-Commerce
  • Video
  • B2B SaaS
  • AI Copilot