How to Set Up a Test using our JavaScript API

Intelligems allows you to set up powerful custom tests using its window object API.

Advanced Tests are not enabled by default. To enable advanced test types,please reach out to our support team.

Step 1: Create a new test

Navigate to the "A/B Tests" tab in the menu on the left-hand side of the Intelligems app. Once there, click 'Create New Test' above the experiments table. Select "Content Test" , then "Onsite Edits", then "Create Test".

Step 2: Create your test groups

Create a test group for each group you want to include in the test. Fill in the Test Name and Test Description for the experiment you are creating. This information is all internal - the more detail you include here the better! Tests can be live for several weeks, and your future self will thank you for including the details here.

You can add new groups to include in the test by clicking on the ‘+’ button. Name the groups for the experiment and use the slider to allocate what percentage of traffic will go to each group. Click ‘Continue’ when you are done.

Finally, select whether analytics should by default consider only orders containing certain products you want to test (for example something related to a particular PDP), or orders containing any products in your shop. You can change this later after the test has started by changing the option in your Analytics filters.

Step 3: Set up targeting if needed

Targeting is an optional step. This tool allows you to apply specific conditions to certain site visitors.

There are a few different ways you can do this:

• You can set up currency and country targeting that allows you to limit your test to a single currency and/or a list of specific countries. This feature is defaulted to your store currency for price test.

• You can use UTM parameters to customize your user experience under the Audience option.

• You can filter traffic based on JavaScript Expressions under the Audience option.

• You can filter traffic based on device type (i.e. mobile or desktop) under the Audience option.

• You can filter traffic based off of whether a visitor is new or returning under the Audience option.

• You can prevent users from being targeted by related experiments to reduce undesired interactions under the Mutually Exclusive Tests option.

You can learn more about targeting here!

Step 4: Skip "Onsite Edits" and save your test

No need to set up any "Onsite Edits" in the last step of the set up if you are planning to use our JavaScript API. Go ahead and save the test, and move on to step 5.

Step 5: Get relevant IDs

Custom content tests require you to know the experiment ID and test group IDs so that you can branch your design or logic accordingly. You can get this information by clicking the Show Info button in the more menu:

Step 6: Use the Intelligems window object API to set up your custom test

Now that you have your test group IDs, you can use Intelligems' window object Javascript API to get the current user's test group for the given experiment. Once you know the user's test group, you can branch logic and styling with it. For example, you might set a class or show/hide an element to affect styling, or conditional logic in your own Javascript code to provide a different experience.