DeX Documentation

Everything you need to get started and master digital experimentation.

About Direct Experiment (DeX)

Direct Experiment (DeX) is an A/B testing tool designed primarily for websites. It enables users to perform A/B tests with multiple variations for specific pages and targeted audiences. Our platform provides real-time analytics reports at both the activity and experience levels, giving you a clear overview of what is working and what is not. This allows you to easily switch activities on/off or deploy specific winning features to your production environment.

How to Setup

Follow these steps to get started with Direct Experiment:

  1. You need to sign up at https://directexperiment.com/signup.html.
  2. Reset your password.
  3. Login at https://directexperiment.com/login.html.
  4. You will be redirected to the Activity Panel.
  5. Go to Create Activity. Choose either A/B or DT (MVT). Add your domain and the specific page where you want to run the test.
  6. Before you can run a test, you need to point your domain to Direct Experiment. This will provide you with a unique script.
  7. Copy that script and paste it on your website wherever you want to run Direct Experiment.

Start an A/B Test Campaign

A/B testing, also known as split testing, involves creating two or more versions of the same page to test the performance of specific changes. It's a widely used method for digital marketers, product owners, and developers to validate features before they are deployed to production. DeX helps you easily create and deploy tests in minutes, reducing effort and time.

Once activated, the changes you created will begin to render on the page for your targeted audience within a few minutes.

  1. Click the Create Activity button and select the A/B test option.
  2. Enter the page URL where you want to make changes. You will be directed to the A/B test edit page where you can create multiple experiences (variations).
  3. Next, you will be redirected to the audience distribution page. Here, you can modify the distribution ratio for each experience.
  4. Add an activity description, schedule the test (if needed), and define a goal to measure its performance. Direct Experiment currently supports element click and specific page view as success metrics.
  5. Once all configurations are complete, click on the activity option to go to the Activities page. Find your activity and click to activate it. You can later deactivate or delete the test as needed.
  6. To view detailed analytics for your individual activity, click on the Report column in the activity list. The report provides total impressions, clicks, user count, geo-location, and device/OS data.

Start an MVT (DT - Direct Test) Campaign

Direct Test (DT), also known as Multi-variation Test (MVT), allows you to create multiple experiences and allocate audiences to each. You can run a campaign on a small sample or a large dataset. DeX provides default audiences, but you can also allocate a custom audience for each experience. In essence, it acts as a group of experiences, with each experience containing a group of changes.

  1. Click the Create Activity button and select the DT test option.
  2. Add your experiences and name the activity.
  3. Since it's a DT test, traffic distribution is not needed in this step. Click Next.
  4. You will be redirected to the goal page where you must add a description, schedule (if required), and define goal metrics before saving.
  5. You can view, activate, deactivate, and edit your DT activity from the main Activities page. To edit, simply click on the activity name.

How to Setup Audience

Direct Experiment supports both Custom Audience and Default Audience. A custom audience is a user-defined audience where you create segments and upload a CSV file of users. You must also define how this data is referenced at the client end (e.g., via localStorage or sessionStorage).

To set up a custom audience, follow these two steps:

  1. Create a segment and name it. Refresh the page to see your new segment in the table. Now, configure the segment by uploading your CSV file. Ensure the first column is customerid and the subsequent columns contain data like customer name or other relevant information. We recommend you do not add any sensitive data like phone numbers or financial information.
  2. The second part is integration. You must define how Direct Experiment will map the data you uploaded in the backend. You can use sessionStorage, localStorage, or Cookies. You need to ensure your data flows into this storage, and then connect your segment to it.

Once you publish it, you are ready to use this audience in the audience manager when creating an activity.

How to Setup Page Delivery Rules

To control where an activity's experiences are visible, you can set up page delivery rules. This is useful for scenarios where you want a change to only appear on pages where the URL contains a specific string, is an exact match, or does not contain a certain value.

You can access the page delivery rule options by clicking the settings icon on your activity. You can define rules using URL matching with logic expressions like is, is not, contains, and doesn't contain. You can also combine multiple rules using AND and OR logical operators to configure complex activities.

How to Allocate Audience

To allocate a specific audience to an experience, click the three dots on the active experience and select the Change Audience option. Here you can choose which audience to target. We provide predefined audiences based on OS and Device. For geo-based audiences, you need to set them up separately under DeX Control.

After selecting your audience, save your changes and publish. The changes will now be reflected for the selected audience. You can add more complex logic around your selected audience by clicking the people icon under the active experience to access the audience profile. For example, you can configure an activity to be shown to visitors from a specific city using a desktop device.

How to Setup City-Level Activity

To add custom cities for targeting, use our platform called DXControl at https://directexperiment.com/DXcontrol/defaultaudience.html. Simply add your audience name and provide a comma-separated list of cities. Once saved, our backend validates your cities, and they will then become available in the Audience Manager. You are then ready to use this new geo-based audience for your activities.

Support

We value our clients and are committed to resolving your queries quickly. You can raise a support ticket by clicking on your profile. We will connect with you and resolve your query as soon as possible. Alternatively, you can contact our customer care at 9532990822 or email us at support@directexperiment.com.