Segment Event Streaming

Automatically stream Kameleoon experiment exposure events to Segment from the server side to enrich user behavior analytics and route data to downstream tools.

This feature is in open beta and active development. Contact the Kameleoon support team for support with this integration.

The Kameleoon Segment Event Streaming integration allows you to automatically send events to your Segment account whenever one of your Kameleoon experiments exposes visitors. This integration enables enriched analytics in Segment, providing insights into experiment exposure to help you better understand user behavior and engagement.

This integration uses Kameleoon’s event dispatcher to send server-side events to your Segment account in batches using the /batch endpoint of the Segment HTTP API.

Key benefits

• Precise behavior insights: The integration sends specific events to third-party tools for visitors exposed to web experiments and feature flags on SDK-based projects, such as apps. This detailed tracking enables a clearer view of how different variations impact user actions. For example, you can observe which variation drives more clicks, conversions, or other desired outcomes, helping you determine the most effective approach.
• Real-time decision-making: The integration provides data in real time, enabling on-the-fly decision-making. Armed with up-to-date insights into ongoing experiments, you can swiftly adjust strategies if a variation isn’t performing as expected.
• Effortless setup: Enable third-party integrations directly from the Kameleoon app with no need for custom code or SDK changes.

Considerations

Kameleoon’s server dispatches events to Segment with a minimum 30-minute delay.

To configure this integration, you need the following:

• Kameleoon SDK: Install the Kameleoon SDK on your server-side project.
• Write Key: Your Segment Write Key (create a new Segment source for Kameleoon events, though you can use an existing key).
• Workspace location: Specify if your Segment workspace is in the EU. You can find this information in your Segment workspace settings.

Setup

You can activate this integration for Web and Feature experiments.

For web experiments

1. Click Admin > Integrations.
2. Click the download icon on the right of Segment’s card.
3. Select the projects on which you want to configure Segment and click Validate.
4. Add Segment in the Integrations tab of the finalization flow.

For feature experiments

1. Edit a feature flag or create a new one.
2. Under Reporting, click Integrations.
3. Toggle Segment on in all desired environments.

Once you activate the integration and your experiment is live, Kameleoon sends experiment events to Segment whenever your experiment exposes a visitor. These events include key details such as:

• User ID
• Exposure time
• Kameleoon experiment ID
• Kameleoon variant ID

Event payload example

Kameleoon sends events to Segment in the following format:

{
"userId": "xf54dd2thdd5",
"event": "[Company] Experiment",
"properties": 
{ 
"experimentId": 12345,
"variationId": 15685 
},
"timestamp": 1730194985000
}

By default, userId contains the visitor’s Kameleoon visitor code. If you set up Kameleoon cross-device reconciliation, Kameleoon uses the identifier put into the cross-device reconciliation custom data instead of the visitor code.

Kameleoon doesn’t include any custom data specific to your organization in the events it sends from the server, even if that data typically appears in your Segment events.