Integrate Optimizely with Lotame DMP

  • Updated
This topic describes how to:
  • Enable the Lotame integration in Optimizely
  • Create new audiences using the Lotame integration

The Lotame integration makes it easy to target audiences defined in Lotame DMP via Optimizely audience conditions. Once you’ve configured the integration, you’ll be able to run targeted experiments and personalization campaigns using your existing Lotame audiences.

To use the Lotame integration, you will need:

  • A valid Lotame subscription

  • An eligible Optimizely plan

  • A Lotame username and password

  • Your organization’s Lotame client ID (please contact your Lotame administrator if you aren’t sure what this is)

How the integration works

  • When you open the Optimizely audience builder, Optimizely sends a request to the Lotame Audience Search API for a list of all audience names which have been assigned a targeting code. Once this list is received from the Lotame REST API, you can use them to create Optimizely audience conditions.

  • When a visitor is active on a page containing an Optimizely snippet where the Lotame integration is enabled, the snippet requests a list of the visitor’s qualified audiences from the Lotame Audience Extraction API. The snippet uses this information to determine which Optimizely audience(s) the visitor qualifies for.

Note that you must be logged in to your Lotame account in order to access the linked documentation above.

Set up the integration in Lotame

Any Lotame audiences you’d like to target via Optimizely must first be assigned targeting codes. The process Lotame uses to set targeting codes is documented here. Here’s how to do it from within the Lotame interface:

  1. From the Audiences > My Audiences screen, select the More » drop-down next to the audience you would like to export, and click Export.


  1. On the Export Beacons screen, select Audience Extraction API.

  2. Specify your audience’s targeting code and click Set Targeting Code. Note: do not use spaces in targeting codes. You can, however, use underscores (_).


Set up the integration in Optimizely

  1. Log in to Optimizely and navigate to the Integrations dashboard.

  2. Select Lotame and toggle the setting to On.

  3. Enter your Lotame username and password. Optimizely encrypts this information and uses it to connect to Lotame and retrieve available audiences on your behalf.

  4. Next, enter your Lotame Client ID. Optimizely uses this information to retrieve information about visitors’ membership in Lotame audiences.

  5. Click Save.


Create an audience using the Lotame integration

Now you can create Optimizely audiences using Lotame audiences as conditions. Here’s how:

  1. Open the Audience Builder and navigate to Overview > Audiences > Create New Audience...
  2. Enter a name for the audience.
  3. Expand Lotame and drag the Lotame Audience condition to the left.
  4. Select the audience you want to target from the dropdown menu.
  5. Click Save.


Now you can use the audience to target experiments and personalization campaigns.

You can target multiple Lotame audiences within a single Lotame audience by combining the existing segments with and, or, and not. For example, “Segment A” and not “Segment B”.