Segment
Platform Summary
Segment Track/Identify/Common spec contracts.
Scope
Primary execution surface: hybrid.
Developer Source Map
| Source | Reason |
|---|---|
| Segment Common Spec | Transport / Payload Rules; User Data Contracts; shared fields, identity, timestamps |
| Segment HTTP API | Transport / Payload Rules |
| Segment Identify Spec | User Data Contracts; user data, identify payload |
| Segment Track Spec | Event Contracts; events, payload, transport |
RudderStack Cross-Check
RudderStack is used here only as secondary engineering evidence for discovery and cross-check.
| Destination | Type | Link |
|---|---|---|
segment | Discovery lead | source |
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
track | event | hybrid | string | Required | Track call event name string. | Not clearly specified | Not clearly specified | Purchase | Segment Track spec requires event. | Segment Track Spec | Verified | High |
track | properties | hybrid | object | Optional | Event properties object. | Not clearly specified | Not clearly specified | - | Track properties are optional key-value object. | Segment Track Spec | Verified | High |
track | properties.currency | hybrid | string | Optional | Currency code string (ISO 4217 guidance). | Not clearly specified | Not clearly specified | USD | Documented commerce property. | Segment Track Spec | Verified | Medium |
track | properties.revenue | hybrid | number | Optional | Revenue numeric value when present. | Not clearly specified | Not clearly specified | - | Documented commerce property. | Segment Track Spec | Verified | Medium |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
common | anonymousId | hybrid | string | Conditional | Required unless userId is present. | Not clearly specified | Not clearly specified | - | Identity requirement is userId or anonymousId. | Segment Common Spec | Verified | High |
identify | traits | hybrid | object | Optional | User traits object. | Not clearly specified | Not clearly specified | - | Traits are optional identify payload object. | Segment Identify Spec | Verified | High |
identify | userId | hybrid | string | Conditional | Required unless anonymousId is present. | Not clearly specified | Not clearly specified | - | Identity requirement is userId or anonymousId. | Segment Identify Spec | Verified | High |
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
common | messageId | hybrid | string | Optional | Unique message identifier, max 100 chars. | Not clearly specified | Not clearly specified | - | Common field contract. | Segment Common Spec | Verified | Medium |
common | timestamp | hybrid | string | Optional | ISO-8601 timestamp. | Not clearly specified | Not clearly specified | - | Common spec timestamp contract. | Segment Common Spec | Verified | High |
http_api | writeKey | server | string | Required | Write key is required for writeKey-auth requests. | Not clearly specified | Not clearly specified | - | HTTP API authentication contract. | Segment HTTP API | Verified | High |
Candidate / Needs Review Items
No candidate rows currently tracked.
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-31