HomeGuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityOptimizely GitHubOptimizely NuGetLog In
Hey! These docs are for version 2.1.0-full-stack, which is no longer officially supported. Click here for the latest version, 1.0!


_Event tags_ are contextual metadata about conversion events that you track.

Use event tags to attach key-value data to events. For example, for a product purchase event, you may want to attach a product SKU, product category, order ID, and purchase amount. Event tags can be strings, integers, floating point numbers, or boolean values.

You can include event tags as an optional argument in [Track](🔗); see the example below.





Event tags are distinct from [user attributes](🔗), which should be reserved for user-level targeting and segmentation. Event tags do not affect audiences or the Optimizely results page and do not need to be registered in the Optimizely app.

Event tags are accessible via [raw data export](🔗) in the `event_features` column. Include any event tags you need to reconcile your conversion event data with your data warehouse.

## Reserved Tag Keys

The table lists the reserved tag keys, which are included in their corresponding fields in the Optimizely event API payload. They're bundled into event tags for your convenience. Use them if you want to benefit from specific reporting features such as revenue metrics or numeric metrics.

Tag keyDescription
**revenue**An integer value that is used to track the revenue metric for your experiments, aggregated across all conversion events. Note that: _ Revenue is recorded in cents; to record a revenue value of $64.32, use `6432`. _ Add any event you want to track revenue for as a metric in your experiment. *Use the overall revenue metric to aggregate multiple metrics tracking separate revenue events. The overall revenue event won't track any revenue unless other metrics in your experiment are tracking an increase or decrease in total revenue; it won't work on its own.
**value**A floating point value that is used to track a custom value for your experiments. Use this to pass the value for numeric metrics.

Include event tags


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.