This feature is in open beta and is in active development. Contact the Kameleoon support team for support with this integration.
Description
The Kameleoon Segment Event Streaming integration allows you to automatically send events to your Segment account whenever visitors are exposed to one of your Kameleoon experiments. This enables enriched analytics in Segment, providing insights on 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 Mixpanel 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
Event delivery timing: Kameleoon server’s dispatched events to Segment with a minimum 30-minute delay.
Prerequisites
To configure this integration, you need the following information:
- Kameleoon SDK must be installed on your server-side project.
- Write Key: Your Segment Write Key. (We recommend creating a new Segment source for Kameleoon events, though an existing key can be used).
- Workspace location: Specify if your Segment workspace is located in the EU. You can find this information in your Segment workspace settings.
Setup
This integration can be activated for Web experiments and Feature Flags Experiments.
For web experiments
Enable the integration from the Integrations page.
Add the integration while finalizing your web experiment.
For Feature experiment
Set up the integration in the feature flag environment in the integrations section. Enable it for each environment where you want it active.
Once the integration is activated and your experiment is live, Kameleoon will begin sending experiment events to Segment whenever a visitor is exposed. These events include key details such as:
- User ID
- Exposure Time
- Kameleoon Experiment ID
- Kameleoon Variation 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 will contain the visitor’s Kameleoon visitor code. If you have set up Kameleoon cross device history reconciliation then the identifier put into the cross device reconciliation custom data will be taken instead of the visitor code.
Please note that any custom data specific to your business, typically included in your Segment events, will not be present in the events sent by Kameleoon from the server. If you need to enrich the payload with data not tracked natively by Kameleoon, you can submit a feature request.
