Run flag deliveries (targeted delivery)
- 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 deliveriesFlag deliveries.
Configure a targeted delivery (flag delivery)
Note
For 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.
To configure a targeted delivery:
- (Prerequisite) Create and implement a flagCreate and implement a flag for the functionality you intend to deliver. Also, decide how to Handle user IDsHandle user IDs.
- Under Flags, select a flag, then select an environment.
- Click Add Rule and select Targeted Delivery.
- Configure your delivery by completing the following steps:
- Enter a name.
- A rule Key is automatically generated based on what you enter for the Name, but you can edit the key.
- (Optional) Search and add audiences for your delivery. For information, see Target audiencesTarget audiences. Audiences evaluate in the order in which you drag and drop them. You can choose whether to match each user on any or all of the audience conditions.
- Select the Traffic allocation, which is the percentage of the audience traffic you want to be exposed to the flag variation.
- In the Deliver drop-down list, select a flag variation to deliver to the audience.
- Click Save.
Run the targeted delivery (flag delivery)
Click Run on the rule to start the targeted delivery. If the ruleset (flag) is not running, click Run on it.
Note
You can toggle the flag on and off at any point without changing which users were bucketed into the delivery, as long as you do not modify the traffic at the same time.
(Optional) You can create multiple deliveries for the same flag if you want to deliver different variations and traffic allocations to different audiences.
(Optional) For each environment, you can configure different rules. Repeat the previous steps for other environments you want to configure.
Implement the delivery
After you implement your flag, no further implementation is required for the delivery. Optimizely Feature Experimentation uses the `decide call`decide call you created when you implemented the feature flagimplemented the feature flag to decide if a user qualifies for the delivery rule or not and which variation they receive.
Note
A user evaluates against all the rules in a ruleset in order before being bucketed into a given rule's variation. See interactions between flag rulesinteractions between flag rules.
Deliveries are used to launch features, so no decisions eventsdecisions events show up on the results pageresults page. To measure the impact of a flag and track metrics on your results page, create an experiment, such as an A/B testA/B test, instead of a targeted delivery.
Important
Before running an experiment and delivery rule for the same flag at the same time, you must understand how flag rules interactflag rules interact.