Use JavaScript in a web experiment
To make a web experiment to go-live on your organization's site, you must specify in the JavaScript editor where in the Document Object Model (DOM) you want the offer or content to display. This is how you determine where the HTML will be inserted and rendered on your organization's website.
The JavaScript editor lets you run client-side JavaScript in your variant.
Most variants also must pass server-side guest data to your organization's website, for example, the guest's first name, location, loyalty number, and so on. To facilitate this, you must configure the API response to include the dynamic data so that when the variant executes, the data is requested from the server and then passed to the variant.
You can use JavaScript to access nested values by index from the API response. For example, you might want to display Offers in an experiment that are returned from a Decision Model. Because the offer is a value that is nested in an array, you must use the array.index
or array.{index}
syntax.
The experiment can call server-side data such as guest attributes, and use it in the CSJS. This can include a full history of the guest as well as a continuous stream of real-time session data.
To use JavaScript in a web experiment:
-
In the Experiment variants tile, click the Edit icon next to the variant you want to configure.
-
In the code editor, on the JavaScript tab, enter any JavaScript that you want to use in the web experiment.
-
To insert dynamic data into JavaScript, on the Data tab, in the Data Selector search box, enter a guest's email address to search. This enables you to access data model attributes and paths.
TipIf there is a guest whose data you often use when configuring or testing code, click the star icon to bookmark the guest so you no longer have to search for them.
-
To include dynamic guest data, under the Guest data model tree, click
and click Copy Path as JavaScript.
-
To include dynamic data from the decision model response, expand the Decision Model Response tree, click
and click Copy Path as JavaScript.
-
To include dynamic data from the experiment response, expand the Experience Response tree, click
and click Copy Path as JavaScript.
-
On the JavaScript tab, paste the data and click Save.
-
Click
to close the code editor.
You must also include the dynamic data when you compose the API request. This ensures that when the experiment executes, the server requests the dynamic data and passes it to the variant.