Experiments let you track how users reacted to the different variations. So, you'll need to tell Optimizely which events to track in order to gauge the relative success of your experiment. After Optimizely aggregates enough events to produce meaningful metrics, you'll be able to judge your flag variations on the Results page.
At a high level, you'll take these steps:
- In the Optimizely app, create an event key string. See Create events.
- Copy the sample integration code for the Track Event method that Optimizely generates.
- Use the Track Event method to label the event code you want to track. In order for your conversion event to populate experiment metrics on the Results page, track event code that a user is exposed to if they see a flag variation.
Note: We recommend getting in the habit of tracking interesting events even if they're not behind feature flags, so you can more easily create future experiments.
Now, every time a user triggers the event, Track Event passes a conversion event to Optimizely.
- (Recommended) Filter out third-party bots so they don't skew your experimental results. For more information see Filter out bots.
- Add your events to a flag rule. See Run A/B tests and Run flag deliveries.
Troubleshooting empty results
The Results page only shows events that are tracked after a Decide method has been called for the user who triggered the event. If you do not see results on the Results page, make sure that you are evaluating the feature flag before tracking conversion events.
The example below shows the Track Event method called, including optional user attributes.
// Track a conversion event for the provided user with attributes let user = optimizely.createUserContext(userId: "user123", attributes: ["logged_in":true]) // Track a user event try? user.trackEvent(eventKey: "purchased")
In circumstances where you can't install our SDK (for example, for offline event tracking and other advanced use cases), you can instead use the Event API.
In circumstances where you can install our SDK, you can rest assured that all of our SDK languages have the same audience evaluation and targeting behavior, so you'll see the same output from experiment decisions and tracking as long as you are using the same datafile and user contexts. You can use any of our SDKs to track events, so you can run experiments that span multiple applications, services, or devices.
If you plan to use multiple SDKs for the same project, make sure that all SDKs share the same datafile and users.
For more information, see Multiple languages.
It’s possible to track nonbinary metrics on the Results page, such as revenue or other numeric values. For information on using reserved event tags to track nonbinary metrics, see Tag events.
After you Create events:
- Add events to a flag rule. See Run A/B tests and Run flag deliveries.
- Decide how events displayed on the Results Page as metrics. See Choose metrics.
The Easy Event Tracking functionality included in the Full Stack v3.0 release changes the results of the Optimizely Data Export.
When implementing Full Stack v3.0 SDKs (generally, SDKs released after February 2019), you must also upgrade to the Results Exports functionality to obtain reliable event attribution data. For more information, see the Important note in the product changelog
Updated over 1 year ago