Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideProduct feedbackGitHubNuGetDev CommunitySubmit a ticketLog In

Integrate Lotame DMP

Integrate Optimizely Web Experimentation with Lotame DMP to target audiences defined in Lotame DMP via Optimizely Web Experimentation audience conditions.

Integrating Optimizely Web Experimentation with Lotame DMP lets you run targeted experiments and personalization campaigns using your existing Lotame audiences.


  • A valid Lotame subscription.
  • A Lotame access key and access token.
  • Your organization’s Lotame client ID (contact your Lotame administrator if you are unsure 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 want to target via Optimizely Web Experimentation must first be assigned targeting codes. See the Lotame documentation. Here is how to do it from within the Lotame interface:

  1. From the Audiences > My Audiences screen, select the More » drop-down list 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 Web Experimentation

  1. Log in to Optimizely Web Experimentation and go to the Integrations dashboard.
  2. Select Lotame and toggle the setting to On.
  3. Enter your Lotame access key and access token. 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 Web Experimentation 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”.