Disclaimer: This website requires Please enable JavaScript in your browser settings for the best experience.

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

Dev guideRecipesAPI ReferenceChangelogDiscussions
Dev guideAPI ReferenceRecipesChangelogUser GuideGitHubDev 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.

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.

📘

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.