Segment

​

Integration Setup

1. Enable the Integration
   • Contact your Rockerbox representative to enable the Segment integration
   • Provide your Segment workspace details
   • Obtain the necessary credentials
2. Configure Segment Source
   • Set up a new Source in Segment
   • Enable the Rockerbox destination
   • Configure the mapping settings

​

Event Mapping

​

1. Standard Events

• Track purchase events
• Monitor user signups
• Capture add-to-cart actions
• Record checkout initiations

​

2. Custom Events

• Map custom events to Rockerbox format
• Configure event properties
• Set up user identification

​

Data Requirements

​

Required Fields

• userId or anonymousId for user tracking
• event name for conversion type
• properties object containing:
  • order_id for purchases
  • revenue for transaction value
  • products for item details

​

Optional Fields

• customer_type (new vs. repeat)
• currency code
• order_type (one-time vs. subscription)

​

Benefits

1. Server-Side Tracking
   • Reliable data collection
   • Reduced client-side load
   • Better data consistency
2. Real-Time Data
   • Immediate conversion tracking
   • Live event streaming
   • Quick attribution updates
3. Data Quality
   • Standardized event structure
   • Consistent user identification
   • Reliable tracking across devices

​

Best Practices

1. Event Implementation
   • Use consistent event naming
   • Include all required fields
   • Test events before going live
2. Data Validation
   • Monitor event delivery
   • Verify field mapping
   • Check for data accuracy
3. Maintenance
   • Regular integration health checks
   • Update mappings as needed
   • Monitor for tracking gaps