GuidesAPI Reference
Submit Documentation FeedbackJoin Developer CommunityLog In

Run flag deliveries

A delivery is a type of rule for a flag that enables you to:

  • 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 more information about what a delivery is, see Flag deliveries.

Configure a Targeted Delivery

📘

For a targeted delivery, ensure you're using the following compatible SDK versions: Swift: 3.3.2 and higher. Agent: 1.1.0 and higher. Go: 1.2.0 and higher. All other SDKs: 2.0.0 and higher.

To configure a targeted delivery:

  1. (Prerequisite). Create and implement a flag for the functionality you intend to deliver. See Create feature flags. Also, handle user IDs. See Handle user IDs.

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

  3. Click the Plus sign (+) and select Targeted Delivery.

Create a targeted deliveryCreate a targeted delivery

Create a targeted delivery

  1. Configure your delivery in the following steps:
Configure a flag deliveryConfigure a flag delivery

Configure a flag delivery

  1. (Optional) In the Configure Rule pane, search and add audiences for your delivery. For more 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. Or, see Create advanced audience combinations for information about creating and passing a custom audience combination with JSON.

  2. Select the percent of audience traffic you want to be exposed to the flag variation.

  3. In the Deliver dropdown, select a flag variation to deliver to the audience(s).

  4. Click Save.

  5. Launch the delivery by toggling the flag on. Note that you can toggle the flag on and off at any point without changing which users were bucketed into the delivery, as long as you don't change the traffic at the same time.

  6. (Optional) You can create multiple deliveries for the same flag if you want to deliver different variations and different traffic allocations to different audiences.

Multiple deliveries for 1 flagMultiple deliveries for 1 flag

Multiple deliveries for 1 flag

  1. (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 feature flag, no further implementation is required for the delivery. Optimizely 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 (remember, a user evaluates against all the rules in a ruleset in order before being bucketed into a given rule's variation). For more information, see Create feature flags.

Deliveries are used for launching features, so no decisions events (aka impressions ) show up on your Results page. To measure the impact of a flag and track metrics on your Results page, create an experiment instead of a targeted delivery.

Before running an experiment and delivery rule for the same flag at the same time, be sure to read Interactions between flag rules,


Did this page help you?