Skip to content

segment.md

Latest commit

 

History

History
159 lines (116 loc) · 2.96 KB

segment.md

File metadata and controls

159 lines (116 loc) · 2.96 KB

Segment

Customer data platform for collecting, routing, and activating user data.

Capabilities

Integration Available Notes
API ✓ Tracking API, Profile API, Config API
MCP - Not available
CLI - Not available
SDK ✓ analytics.js, iOS, Android, server libraries

Authentication

  • Tracking: Write Key (per source)
  • API: Access Token (OAuth 2.0)
  • Header: Authorization: Bearer {access_token}

Common Agent Operations

Track event

POST https://api.segment.io/v1/track

Authorization: Basic {base64(write_key:)}

{
  "userId": "user_123",
  "event": "signup_completed",
  "properties": {
    "plan": "pro",
    "method": "email"
  }
}

Identify user

POST https://api.segment.io/v1/identify

Authorization: Basic {base64(write_key:)}

{
  "userId": "user_123",
  "traits": {
    "email": "user@example.com",
    "name": "John Doe",
    "plan": "pro"
  }
}

Track page view

POST https://api.segment.io/v1/page

Authorization: Basic {base64(write_key:)}

{
  "userId": "user_123",
  "name": "Pricing",
  "properties": {
    "title": "Pricing - Example",
    "url": "https://example.com/pricing"
  }
}

Batch events

POST https://api.segment.io/v1/batch

Authorization: Basic {base64(write_key:)}

{
  "batch": [
    {"type": "identify", "userId": "user_1", "traits": {"plan": "free"}},
    {"type": "track", "userId": "user_1", "event": "signup"}
  ]
}

Get user profile (Profile API)

GET https://profiles.segment.com/v1/spaces/{space_id}/collections/users/profiles/user_id:{user_id}/traits

Authorization: Basic {base64(access_token:)}

Get user events

GET https://profiles.segment.com/v1/spaces/{space_id}/collections/users/profiles/user_id:{user_id}/events

Authorization: Basic {base64(access_token:)}

JavaScript SDK

// Initialize
analytics.load('WRITE_KEY');

// Identify user
analytics.identify('user_123', {
  email: 'user@example.com',
  plan: 'pro'
});

// Track event
analytics.track('Feature Used', {
  feature_name: 'export'
});

// Page view
analytics.page('Pricing');

Key Concepts

  • Sources - Where data comes from (website, app, server)
  • Destinations - Where data goes (analytics, CRM, ads)
  • Tracking Plan - Schema for events and properties
  • Protocols - Data governance and validation
  • Personas - Unified user profiles
  • Audiences - Computed user segments

Common Destinations

  • Analytics: GA4, Mixpanel, Amplitude
  • CRM: HubSpot, Salesforce
  • Email: Customer.io, Mailchimp
  • Ads: Google Ads, Meta
  • Data Warehouse: BigQuery, Snowflake

When to Use

  • Centralizing event tracking
  • Routing data to multiple tools
  • Maintaining consistent tracking
  • Building unified user profiles
  • Syncing audiences across platforms

Rate Limits

  • 500 requests/second per source
  • Batch up to 500KB or 32KB per event

Relevant Skills

  • analytics
  • emails
  • ads