Optimizely will be sunsetting Full Stack Experimentation on July 29, 2024. See the recommended Feature Experimentation migration timeline and documentation.

Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

FAQ

This topic answers commonly asked questions.

Core concepts

Plans

Performance

Implementation

Integrations and Data

Core Concepts

What can I do with Optimizely Full Stack?

Optimizely Full Stack is feature management and A/B testing for product teams.

  • Feature flags and rollouts help you launch features safely and give you a kill switch if unanticipated issues arise.
  • Feature tests empower you to experiment with feature configurations and iterate on features without deploying code.
  • Optimizely's industry-leading Stats Engine calculates results so you can learn what is working and why.
  • Full Stack A/B tests enable you to run experiments in any application. These require you to deploy code, so they are best used for one-off decisions such as comparing one algorithm against another.

Pair Optimizely's Full Stack and Web products to empower your entire organization, from product to marketing teams to experiment and build an optimized customer experience.

Can I run server-side experiments?

You can experiment anywhere in your technology stack with Optimizely's SDKs. You can run experiments in various languages. If you are interested in testing in a different language, contact Optimizely.

How does Full Stack keep flags and users consistent across servers and different SDKs?

You pass a user ID and feature flag key to Full Stack SDK, and this buckets people into the flag. So, if you are running multiple servers or programming languages with the same feature flag key, the SDK will always give the same response. The SDK always gives the same answer based on the user information you've specified, because we use deterministic bucketing via MurmurHash3 to determine which experiments and variations should be active for a user.

How does datafile management work in Optimizely Full Stack?

The datafile is language-agnostic. You can use the same datafile from the same project across different SDKs and get consistent bucketing. This way, you can activate and track the exact same experiments across different SDKs and get consistent results.

How do Optimizely SDKs handle bot traffic?

Optimizely Full Stack SDKs support bot detection as of version 2.1. Enable bot filtering directly from your account’s project settings. Once the setting is enabled, events sent from web browsers have bot filtering applied automatically. Applying bot filtering to events sent from other environments requires configuration. For more context, read about bot filtering.

Do I have to pass a user ID? What if I want anonymous users?

You have to pass an ID, but it can be any hashed ID you’d like, as long as it is consistent with what you want to toggle. User IDs work best in most cases, but we have also seen customers use session IDs or even request-level IDs for experiments.

Plans

What is the licensing model for paid plans?

You are billed based on a monthly active user (MAU)-based model. For more information, see What are monthly active users.

How can I use Optimizely in my tech stack?

Free feature flagging is free to all users and all companies - feel free to download Rollouts and start using the flags today. You will see the basic Optimziely UI and can run one experiment simultaneously. If you would like to add more seats or MAUs, upgrade to the full functionality of Full Stack.

How is Rollouts different from other Full Stack plans?

Rollouts is the free plan for Full Stack intended for startups and teams looking to get started with feature flags and A/B tests. Rollouts and Rollouts Plus both come with a subset of Full Stack features, including unlimited feature flags and controlled rollouts, and the ability to run one experiment at a time.

Paid Full Stack plans, which remove the one concurrent experiment limit, offer a more robust feature set along with best-in-class support and services for organizations with more stakeholders invested in increasing experiment velocity and feature delivery.

How many collaborators can I add to my account?

In Full Stack, you can invite 20 collaborators. We encourage you to invite the whole team to increase visibility, share results and insights and deepen experimentation across your working group. Optimizely offers permissions by role and additional integrated program management tools, so your team can collaborate more effectively.

Performance

How does Optimizely affect my application speed?

Optimizely Full Stack is a server-side tool that enables lightning-fast experimentation. Instead of adding a JavaScript snippet that each user downloads in their browser (the approach of client-side solutions, including Optimizely Web, the backend does all the work. The experiment code runs before the web page ever loads.

Full Stack SDKs are built so you can split traffic to experiments without making any network requests. Unlike some platforms, which call out to third-party servers for experiment decisions, all decisions are made in-memory using a cached copy of the datafile. The impact on latency is negligible.

In other words, Full Stack is faster because it does not make any blocking API requests to get decisions about which experiment variant to use; the device (your mobile phone or server) running the code makes that decision in under a millisecond. Full Stack will not slow down your end user's experience. However, there are still a few performance considerations to keep in mind as you scale your usage of Full Stack:

  • When and how often to download the datafile that in-memory bucketing uses. Manage this by limiting the file size and download frequency.
  • When and how often to send data about conversion events for tracking. Manage this by batching events and using asynchronous event dispatching (having the app send data out-of-band later).

We are always happy to discuss performance. Contact us if you are interested in seeing performance benchmarks for any of our SDKs.

How long does it take for changes in Full Stack to be reflected in my app? How often do you poll the datafile?

Changes in your app depend on how frequently you refresh, or poll, your datafile. Changes are typically reflected in the datafile within ~60 seconds.

Does Optimizely Full Stack make an API call to serve features to users?

No network requests are required to evaluate feature flags and experiments, so there's no added latency. Fetch the datafile in advance, the SDK only needs access to the datafile contents. Download the datafile out-of-band from serving an individual request from your users.

After the datafile is downloaded, no network requests are needed to serve features to users. However, the SDK will still send network requests to track events. You can control when and how this happens by implementing a custom event dispatcher. For more information on event dispatchers, see the event dispatcher configuration topic for your SDK.

What happens to my app if there is a service interruption?

During an app.optimizely.com interruption, you cannot log into Optimizely to update experiments or make other changes. During a service interruption, your application will remain operational, but feature flags and experiments default to turning "off", so it is a best practice to save a fallback data file and defensively code defaults for feature variables.

Optimizely Full Stack uses a JSON datafile uploaded to a global CDN containing the data needed to deliver and track your applications' flags and experiments. In the rare hypothetical situation that the Optimizely CDN were to go down, the SDK would not be able to load any data on your feature flags or experiments, but it would not prevent your application from running. Instead, when you need to evaluate a feature flag or experiment, the Optimizely Full Stack SDK returns the default values for its APIs. This would be roughly the equivalent of turning off all your feature flags in experiments and leaving the values of feature variables undefined.

It is most important to consider the critical connection between your application and the Optimizely CDN. To prepare for a rare service interruption, you can:

  1. Create a fallback datafile – Save a fallback datafile at a regular interval of your choosing. Save the state of your datafile in a database or local storage of your application. That way if the Optimizely CDN is down, you can still load a slightly outdated datafile and not have to use default values.
  2. Upload the datafile to your own CDN – Upload the datafile from Optimizely Full Stack to your own CDN. That way, if Optimizely's CDN goes down, your application has no direct reliance on Optimizely's infrastructure and can still operate normally.
  3. Code defensively – Write defensive code, especially for variables, as they evaluate to undefined if Optimizely goes down. You should always check if a feature is enabled before evaluating its associated feature variables and provide smart defaults when those variables are undefined.

Additionally, you can view the Optimizely status page.

What is the overhead of requesting a feature or running a feature test?

Optimizely does not have a concept of "requesting features." Optimizely does not make network calls to serve features or experiments to users, so there's zero latency. For more information, see Does Full Stack make an API call to serve features to my users?.

Implementation

Can less technical users work with Optimizely Full Stack?

Full Stack is built for product teams. Developers work with our SDKs, but on many teams, product managers and analysts with less technical expertise configure features and experiments, manage rollouts, and analyze results in Optimizely Full Stack.

Can I use Optimizely SDKs without a connection to the internet?

Yes, you can use Full Stack using a local copy of your datafile and batch up events to send later when your app is back online.

Can I use Optimizely Full Stack if my site is heavily cached on a CDN?

Yes, it is possible to use Full Stack with a heavily cached site. This setup requires appropriate configuration at your CDN provider and some additional implementation in the backend. Contact your Customer Success Manager to discuss options. Read more about content delivery networks.

Do I need to modify my firewall when using Optimizely Full Stack?

You probably will not need to modify your firewall to use Full Stack. If your firewall has egress (outbound traffic) restrictions, you will need to allowlist cdn.optimizely.com and logx.optimizely.com.

What if my stack is service-oriented or uses microservices?

You can use Optimizely as a service or include the Optimizely SDK in every service. For some best practices and special considerations when implementing Full Stack, see Microservices.

Does Full Stack need to connect to the cloud?

Yes. Our SDKs need to be able to download our JSON payload (the "datafile"). The datafile contains all the metadata about your features that the SDK needs to operate (toggle feature flags, apply remote configuration ("feature variables"), and segment users). The SDKs do not need two-way communication with our servers.

It is possible to run the open-source Optimizely Agent as a microservice or to download the datafile from an authenticated endpoint, which minimizes the security risk. Some customers even relay this information to their own CDN for added security and control.

Which languages does Full Stack work with?

We have SDKs for all the major programming languages (including Android, C#, Go, Java, JavaScript (Browser), JavaScript (Node), PHP, Python, React, Ruby, and Swift), a REST API and great blog articles with examples for every programming language. You can also run Optimizely Agent as a microservice (open source and free).

Can Full Stack work in a multi-tenant setup? Can I provision features among clients?

Yes. Some Full Stack users set up a Full Stack environment for each of their customers. That way you can use the same flag key everywhere and deliver progressively.

Other Full Stack users use key-value pairs to create audiences targeting specific customers in order to provision flags.

Do I need to set up my feature in your UI after implementing it?

Yes, you need to log into the Optimizely app and set up the feature flag using exactly the same key. This also makes sure anyone logging into Optimizely knows what flags are where and why (you can label and describe them). You can also use our REST API to change features.

If you prefer, you can also build your own UI, or use it in combination with the Optimizely app. We have a microservice, REST API, and command-line interface you can talk to.

Integrations and Data

How do I access raw events?

With access to Optimizely export features, you can export the raw events from AWS S3.

What integrations does Full Stack offer?

We provide guides for connecting with analytics platforms. For more information, see Set up analytics platforms. For a full list of Optimizely partners, see Partners.

How do I track and manage flags to keep the code clean?

Most customers we speak to use our Jira integration with an internal workflow so that tickets track which feature flags are rolled out to what percent.

What if I want to measure which feature people saw?

You will want to run an experiment (as opposed to simply using a feature flag to deliver an on/off experience). To analyze your experiment results, you have the following options:

  • You can integrate with your existing analytics tool. See Set up analytics platforms for guides for the major analytics platforms (for instance Google Analytics, Segment, or Mixpanel).
  • If you would like to measure which state/feature works best, we suggest using Optimizely product with our Stats Engine.

📘

Note

Looking for more discussion on getting started with feature flags and experimentation? Check out Optimizely's Slack Developer Community to learn from other developers and share.