Single-page A/B Test

Umbraco Engage provides the option to set up A/B testing on individual pages. This article covers how and when to use this type of test.

The Single-Page test allows an editor to start an A/B test without a single line of code.

When you select the Single-Page test type you can create two or more variants.

Set up test
Set up test

The first variant is always the original content and the published page. Variant B is the first variant that can be created and with the button 'Add a variant' more alternatives can be added. More variants mean that a test should run for longer to become reliable.

Split view editing

The variant can be given a name and if you click on Edit you will open up the split view editor:

Split view editing
Split view editing

On the left side, the original content is shown (Original) and the variant is shown on the right. In this side-by-side editing mode, you can edit the content for your variant.

Setting up the Document Type for split-view editing

Some properties are inactive (visually indicated because they are greyed out). Which properties you can edit is specified in the setup of the properties of your Document Type.

Specifying when segmentation is allowed can be done per property using the Allow segmentation value.

Property settings
Property settings

In the overview of the Document Type, you will see if properties can be segmented as they will have the Vary by segments label:

Vary by segment label
Vary by segment label

Add CSS or JavaScript

Sometimes you cannot adjust a specific property because it was not configured when Umbraco was set up. In those cases, you can use the CSS/JavaScript field to add a code-snippet to make these adjustments. The best way is to do it via property editing in the split view edit mode. You do not have to write any CSS or JavaScript code.

To do this click CSS/JavaScript in the A/B Testing editor bar:

Add CSS/JavaScript tab
Add CSS/JavaScript tab

This will give the editor a popup where CSS and JavaScript can be entered:

CSS/JavaScript popup
CSS/JavaScript popup

These lines of code will automatically be inserted at the bottom of the page.

Use the Save & preview button to make sure all works as expected. This can also be done via the "Save & preview" option in the editor bar.

Once the variant is set up, finish the A/B Test via the Back to A/B test button in the editor bar.

Finish setting up A/B test
Finish setting up A/B test

Finish the steps in the Settings up the A/B test article to verify and start your A/B Test.

Content rendering

Because of the unique implementation of Umbraco Engage, the content will automatically be updated for this variant.

The algorithm will determine which variant of the propety needs to be rendered.

Last updated