Skip to main content

Audience

Use an audience to create a slice of your population that you can use in rules.

The audience is the set of users or other units that are eligible for a rule.

Inclusion Criteria​

The audience is a set of filters that describe the conditions for inclusion. The filters must match the values in the evaluation context that clients use when resolving flags. For example, if you add country is Sweden as an inclusion criterion, you must include country in the evaluation context. The value for country in the evaluation context must match Sweden to be part of the audience.

Filters can vary in complexity. They can, for example, exactly match a user ID, or be more elaborate and match users in a certain country that are using a specific browser with a specific version. You select how multiple criteria should logically work together by choosing the operator to be AND or OR.

You can add multiple criteria to a group. With groups, you can create arbitrarily complex inclusion criteria by adjusting the logical operator used between and within groups.

Add an Inclusion Criterion​

To add a criterion, follow these steps.

  1. Go to where you want to add the criterion in the Confidence Flags plugin in Portal. This can be in an already created rule or a new flag rule.
  2. Click + Add attribute criterion in the Inclusion Criteria part of the Audience section.
  3. Type in the name of the criterion, and select its type.
  4. Select the appropriate operator by clicking it to unfold the dropdown list.

If the field has been seen by Confidence Flags before, it is auto-completed and the type is populated for you. The operators available to choose from is dependent on the type of the field. For example, if the field is a string, the operator is one of: is (equals), is not (not equals), in (one of many) or not in (not one of many).

Allocation​

The allocation is the percentage of the targeted audience (after the inclusion criteria) that you want to allocate. You set the allocation as a percentage of the total audience size. For example, if the audience size is potentially 2,000, a 50% allocation allocates 1,000 users.

Randomization​

Confidence Flags uses randomization to assign variants to users. To randomize, Confidence Flags needs to know which field in the evaluation context it should take the value from. If you do not specify a randomization field, Confidence Flags uses the value from the targeting_key field in the evaluation context. If the field is not present in the evaluation context, the rule doesn't match and users are not assigned an variant by the rule.

The randomization field is often an identifier that has a value that is unique for each user. For example, if you have a field called user_id in the evaluation context, you can use that field for randomization.

note

The field in the evaluation context that you use for randomization must be a string.