Disclaimer: This website requires JavaScript to function properly. Some features may not work as expected. Please enable JavaScript in your browser settings for the best experience.

Optimizely will be sunsetting Full Stack Experimentation on July 29, 2024. See the recommended Feature Experimentation migration timeline and documentation.

Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Track notification listener

This topic describes the TRACK notification listener, which lets you implement additional functionality or system tracking on top of your instrumented Optimizely Track API calls.

Description

The TRACK notification listener lets you implement additional functionality or system tracking on top of your instrumented Optimizely Track API calls. The Track method triggers this notification listener. Because Optimizely SDKs queue and batch events, there can be a delay between when the Track method captures an event, and when the event is actually sent to Optimizely as part of a batch. For more precise alignment with event batches, see the LOGEVENT notification listener.

Parameters

The following tables show the information provided to the listener when it is triggered:

fieldtypedescription
event keyStringThe event key as you defined it in the Optimizely app.
user idStringThe user ID.
attributesMapA map of custom key-value string pairs specifying attributes for the user that are used for audience targeting. Non-string values are only supported in the 3.0 SDK and above.
event tagsMapA map of custom key-value pairs specifying tags for the tracked event. For more information see Tag events.
eventEventThe event object has the following fields: id, key, experiment ids.

Examples

For example code, see the notification listener topic in your SDK language.