Table of Contents
- Enable the Krux integration in Optimizely
- Create new audiences using the Krux integration
Krux was acquired by Salesforce and renamed to Audience Studio DMP. The documentation will be updated soon to reflect the change. We apologize for any discrepancies. Please reach out to your Customer Service Manager for any assistance.
Integrating Optimizely with the Krux data management platform lets you create targeted audiences in Optimizely based on visitor segments in Krux. From there, you can run targeted experiments and personalization campaigns.
There are two parts to integrating: enabling Krux in Optimizely and creating a Krux audience.
1. Enable Krux in Optimizely
To enable Krux, you need two pieces of information: an API key and your namespace. Your Krux representative can provide both.
The namespace may be missing for certain legacy Krux accounts. The namespace is not essential to the integration, so the integration should still work without the namespace as long as the correct API Key is provided.
The namespace is defined by Krux and usually corresponds with your company name. For example, the namespace for ACME Company might be “acme.” You can find the namespace by looking in local storage on a page where Krux is running.
Optimizely uses the namespace to identify which local storage key to evaluate. For the ACME Company example, the local storage key would be kxacme_segs_partner, but you only need to enter “acme” into the Optimizely integration setup.
When you have the API key and namespace from Krux, here's how to enable the integration:
-
Navigate to Settings > Integrations.
-
Select Krux in the list, and toggle the button to On in the right sidebar.
-
Enter your Krux log-in credentials (username and password), API key and namespace in the Integration Details.
-
Click Save.
Now your project is connected with Krux, and Optimizely can read the visitor segments defined in your Krux account.
The Krux integration uses the Krux visitor segments defined on your website. Each audience in Krux has a unique ID, available in a website cookie. Optimizely reads the unique ID to match a user on each page-view.
2. Create a Krux audience
After you enable the Krux integration, you can create Optimizely Audiences (or add Krux conditions to current Audiences) based on visitor segments in Krux.
-
Navigate to Audiences and click Create New Audience.
-
Enter a name for the new audience in the Name field.
-
In the Conditions list, click the Krux dropdown menu.
-
Click and drag the Audience Segment condition into the space under Audience Conditions.
-
Under Audience Conditions, select the options you want from the dropdown menus.
Here’s an example audience we created:
-
In Krux, check the box to select each visitor segment you want to set up in Optimizely.
Here are the visitor segments set up in our example Krux account—note the Optimizely-specific category:
The dropdown shows only the visitor segments in your Krux account that have a Sub Category of "Optimizely." To expose a Krux segment to Optimizely, edit the Sub Category field to "Optimizely." -
With your audience conditions set, click Save Audience.
Now you'll see your Krux segments in Optimizely.
The integration doesn’t work on first page load for a visitor. The Krux local storage key is not populated in time for the Optimizely snippet to evaluate it on the visitor’s first-page load.