Implement Real-Time Audiences for Feature Experimentation for server-side SDKs

After creating an audience with Real-Time Audiences for Feature ExperimentationReal-Time Audiences for Feature Experimentation and assigning it to a flag ruleflag rule, you can integrate the audience in your server-side code.

If you are not familiar with targeted deliveries and experiments in Feature Experimentation, it is recommended you follow the QuickstartQuickstart guide for your specific SDK first before following this document.

The first step is to install and initialize the Feature Experimentation SDK in your application. When initializing the SDK, you must enable the Optimizely Data Platform (ODP) audiences and the ODPManager. See the Customize configurationCustomize configuration section for information on ODPManager customization options.

Refer to the following documentation for your SDK:

C#

Java

JavaScript – SDK versions 6.0.0 and later.

JavaScript (Node) – SDK versions 5.3.5 and earlier.

Go

Python

Ruby

Optimizely AgentOptimizely Agent

After you have installed and initialized the Optimizely client, you need to create an OptimizelyUserContext object with your Feature Experimentation userID and additional attributes. The OptimizelyUserContext object lets you make flag decisions and track events for a user context that you have already created using the createUserContext method.

Call fetchQualifiedSegments() and then isQualifiedFor() on the OptimizelyUserContext object to first fetch the ODP audiences for the specific userID or any time you need to check if the user context is qualified for a given ODP real-time audience. Refer to your chosen SDK's documentation on OptimizelyUserContext for details and code samples:

You can use the standard Decide methodsDecide methods enriched with Real-Time Audiences for Feature ExperimentationReal-Time Audiences for Feature Experimentation to return flag decisions for a user. The flag decision includes the status if the flag is enabled or disabled and the flag variation. When an ODP-type audience condition is required for the decision, the SDK can look up the ODP audiences in the current user context saved when fetchQualifiedSegments() is called. Refer to your specific SDK's documentation on calling these methods:

C#

Go

Java

JavaScript – SDK versions 6.0.0 and later.

JavaScript (Node) – SDK versions 5.3.5 and earlier.

Python

Ruby

Optimizely Agent

You can call sendOdpEvent() on the OptimizelyClient to send arbitrary event data to ODP. Refer to your preferred SDK to learn more:

You must implement the ODPManager parameter when you initialize the SDK for the Real-Time Audiences integration to work. You can customize the ODPManager or override the entire ODPManager with a custom one. Each Feature Experimentation SDK implements its own way of supporting it. Refer to your desired SDK to learn more.