The availability of features may depend on your plan type. Contact your Customer Success Manager if you have any questions.

Dev guideRecipesAPI Reference
Dev guideAPI ReferenceUser GuideLegal TermsGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev guide

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)

📘

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:

  1. (Prerequisite) Create and implement a flag for the functionality you intend to deliver. Also, decide how to Handle user IDs.

  2. Under Flags, select a flag, then select an environment.

  3. Click Add Rule and select Targeted Delivery.

    Add Targeted Delivery rule
  4. Configure your delivery in the following steps:

    1. Enter a name.

      1. A rule Key will automatically be generated based on what you enter for the Name, but you can edit the key.
    2. (Optional) Search and add audiences for your delivery. For information, see Target 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.

    3. Select the Traffic allocation, which is the percentage of the audience traffic you want to be exposed to the flag variation.

    4. In the Deliver drop-down list, select a flag variation to deliver to the audience.

      Create Targeted Delivery rule
  5. 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 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.

📘

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 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.

🚧

Important

Before running an experiment and delivery rule for the same flag at the same time, you must understand how flag rules interact.