Run flag deliveries (targeted delivery)
How to run a flag delivery, also known as a targeted delivery in Optimizely Feature Experimentation.
A targeted delivery is a type of rule for a flag that lets you:
- Control who sees your flag.
- Gradually increase or roll out the flag to more users.
- Roll back the flag if you encounter bugs or other problems.
For information, see Flag deliveries.
Configure a targeted delivery (flag delivery)
NoteFor a targeted delivery, ensure you are using the following compatible SDK versions:
- Swift – v3.3.2 and higher.
- Agent – v1.1.0 and higher.
- Go – v1.2.0 and higher.
- Flutter – v1.0.0-beta or higher.
- All other SDKs – v2.0.0 and higher.
With the Feature Experimentation UI
See Run flag deliveries (targeted delivery) in Feature Experimentation in the user documentation.
With the REST API
Use the Update the Ruleset for a Flag in an Environment endpoint to add a new rule with type
set to targeted_delivery
.
Run the targeted delivery (flag delivery)
Start your new targeted delivery rule and flag (if it is not already running).
With the Feature Experimentation UI
See Run flag deliveries (targeted delivery) in Feature Experimentation in the user documentation.
With the REST API
First, enable the flag by using the Enable the Ruleset for a Flag in an Environment endpoint. Then, launch your targeted delivery by enabling the rule by using the Update the Ruleset for a Flag in an Environment endpoint and setting the enabled
path to true
.
Implement the delivery
After you implement your flag, no further implementation is required for the delivery. Optimizely Feature Experimentation uses the decide
call you created when you implemented the feature flag to decide if a user qualifies for the delivery rule or not and which variation they receive.
NoteA user evaluates against all the rules in a ruleset in order before being bucketed into a given rule's variation. See interactions between flag rules.
Deliveries are used to launch features, so no decisions events show up on the results page. To measure the impact of a flag and track metrics on your results page, create an experiment, such as an A/B test, instead of a targeted delivery.
ImportantBefore running an experiment and delivery rule for the same flag at the same time, you must understand how flag rules interact.
Updated 2 days ago