The Full Stack Developer Guide Developer Hub

Welcome to the Full Stack Developer Guide developer hub. You'll find comprehensive guides and documentation to help you start working with the Full Stack Developer Guide as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

JavaScript (Node)

Quickstart guide for Optimizely Full Stack

Welcome to the quickstart guide for Optimizely's Full Stack JavaScript Node SDK. Follow the steps in the guide below to roll out a feature and start your first experiment.

Steps:

  1. Install the SDK
  2. Instantiate Optimizely in your app
  3. Create a feature flag (with variable) in Optimizely
  4. Implement the feature in your app
  5. Create an event to track in Optimizely
  6. Implement event tracking in your app
  7. Launch the experiment for your feature!

1. Install the SDK

From your project directory in the terminal, run the command below to install Optimizely Full Stack in a Node environment:

npm install --save @optimizely/optimizely-sdk

or with Yarn:

yarn add @optimizely/optimizely-sdk

2. Instantiate Optimizely

Next require the installed npm package and use its ‘createInstance’ method to pass in your SDK key and other preferences.

const optimizelySDK = require('@optimizely/optimizely-sdk');

const optimizelyClientInstance = optimizelySDK.createInstance({
  sdkKey: '<Your_SDK_Key>'
});

optimizelyClientInstance.onReady().then(() => {
  //optimizelyClientInstance has downloaded your Optimizely configuration
  //and is ready to use
});

Remember to replace <Your_SDK_Key> with your own.

To find your SDK Key in your Optimizely project:

  1. Navigate to Settings > Primary Environment
  2. Copy the SDK Key
Click image to enlarge

Click image to enlarge

Note: Notice that each environment has its own SDK key.

3. Create a feature flag

A feature flag lets you control which users are exposed to a new feature in your app. For this quickstart, imagine that you run an online store and you’re rolling out a new ‘discount’ feature that shows different discounts to try to increase sales. Create a feature in Optimizely named ‘discount’ and give it a variable named ‘amount’.

Create a feature flag in your Optimizely project:

  1. Navigate to Features > New Feature.
  2. Name the feature key discount
  3. Click Add Variable
  4. Name the variable amount
  5. Set the variable type to "Integer"
  6. Set the variable default value to 5 (this represents $5)
  7. Skip the rest of the dialog and click Create Feature.

Here's a visual for how to set it up:

Click image to enlarge

Click image to enlarge

4. Implement the feature

Next, use the SDK’s Is Feature Enabled method to determine whether to show or hide the discount feature for a specific user. You can roll out the discount feature to a percentage of traffic and run an experiment to show different discounts to just a portion of users. Once you learn which discount value works best to increase sales, roll out the discount feature to all traffic with the amount set to the optimum value 😀.

const enabled = optimizelyClientInstance.isFeatureEnabled('discount', userId);

Even before you decide which discount amounts to test, you can code logic for exposing them. You can set the different discount values at any time in Optimizely (we’ll set them in the last step). For now, use the Get Feature Variable method to return the discount amount for a specific user.

if (enabled) {  
  const discountAmount = optimizelyClientInstance.getFeatureVariable('discount', 'amount', userId);
  console.log(`${userId} got a discount of $${discountAmount}`);
} else {
  console.log(`${userId} did not get the discount feature`);
}

5. Create an event

In Optimizely, you’ll use event tracking to measure the performance of your experiments. Exposing users to new features influences them to behave in different ways. Tracking the users’ relevant actions is how we capture the impact those features had. This means we need to define which actions we want to track.

Since we’re experimenting with a new discount feature it makes sense to track if the user goes on to make a purchase after they’ve been shown a discount.

Create an event named ‘purchase’ in your Optimizely project:

  1. Navigate to Events > New Event
  2. Set the event key to purchase
  3. Click Create Event
Click image to enlarge

Click image to enlarge

6. Implement event tracking

You need a way to tell Optimizely when a user has made a purchase in your app and map this event in your app code to the specific event you created in Optimizely. Luckily the SDK has a method for that! Simply use the ‘track’ method on the SDK client and pass in the key for the event you created (‘purchase’) and the userId.

//after we’ve confirmed purchase completed
optimizelyClientInstance.track('purchase', userId);

7. Launch the experiment

At this point, you’ve set up almost everything we need to run your Full Stack experiment. You’ve:

  • Set up feature flag (with variable)
  • Implemented dynamic serving of the feature & variable in the app
  • Set up event to track the impact of the feature
  • Implemented tracking of purchase event in the app

The only thing left to set up is the experiment itself! To create an experiment in your Optimizely project:

  1. Navigate to Experiments
  2. Click Create New > Feature Test
  3. In the Feature box, select the discount feature
  4. Click Create Feature Test
Click image to enlarge

Click image to enlarge

Click image to enlarge

Click image to enlarge

By default, Optimizely creates an experiment with two variations: one with the feature on and one with the feature off. Toggling the feature on for both variations will cause Optimizely to show the discounts to all users who are part of the experiment (a single user only ever sees one variation).

  1. Toggle the feature on for both variations
  2. For variation_1 set the discount value to 5
  3. For variation_2 set the discount value to 10
  4. Click Save to save your changes
Click image to enlarge

Click image to enlarge

Next, click on Metrics in the left side-panel and add your new purchase event as a metric for your experiment and save to your experiment.

Click image to enlarge

Click image to enlarge

Click image to enlarge

Click image to enlarge

Now click Run in the top left of the experiment page in your chosen environment and your experiment will start.

Click image to enlarge

Click image to enlarge

Note: To test the different variations of the experiment, you’ll need to pass in unique userIds to the SDK methods. One way to do this is to use a random number generator to pass in random userIds.

Congratulations! You’ve successfully set up and launched your first Optimizely Full Stack experiment. While this example focused on optimizing sales, Optimizely’s experimentation platform can support an open ended set of experimentation use cases.

Review our documentation for more info and to learn more ways to optimize your software using experimentation.

Updated 2 months ago



JavaScript (Node)


Quickstart guide for Optimizely Full Stack

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.