Simple A/B WordPress Plugin – Getting Started Guide

 

Introduction

The Simple A/B WordPress Plugin allows you to easily integrate Captchify's A/B testing platform into your WordPress site. This guide will help you get started with installing, configuring, and using the plugin to run experiments on your WordPress pages.

Features:

  • Run A/B tests on your site pages
  • Analyze results in real time
  • Easy integration with Captchify’s platform

Prerequisites

Installation and Setup

  • 1

    Download the Plugin

    Download the latest version of the plugin below as a zip file.
  • 2

    Install the Plugin in WordPress

    1. Login to your WordPress Admin Dashboard.
    2. Navigate to Plugins -> Add New.
    3. Click on Upload Plugin at the top of the page.
    4. Choose the zip file downloaded from GitHub.
    5. Click Install Now.
    Screenshot 2024 10 06 174908
  • 3

    Activate The Plugin

    1. Go to Installed Plugins.
    2. Activate: Captchify Simple A/B.
    Screenshot 2024 10 06 175206
  • 4

    Sign up For Captchify

    1. Login or Create a Captchify Account
    2. If you see "Failed to fetch account data." Refresh a couple times as the initial setup takes some time
    3. Wait until you see this page.
    Screenshot 2024 10 06 205048
  • 5

    Choose a Billing Plan

    1. Click on view our pricing plans.
    2. Choose the free plan for now.
    Screenshot 2024 10 06 205223
  • 6

    Enter your Billing Email

    1. Enter an email for your billing profile it can be the same or different then the email you signed up for.
    Screenshot 2024 10 06 205248
  • 7

    Wait for Completed Billing Setup

    1. Your Billing Status will change in a couple minutes as our system processes your subscription. You will know when the setup is complete if you account page on the Portal looks like the image
    Screenshot 2024 10 06 212805
  • 8

    Go to the Simple A/B Portal and Generate an API Key

    1. Go to the Portal
    2. Go to API Keys
    3. Click add Application
    4. Type in a name and click submit
    Screenshot 2024 10 06 180605
  • 9

    Add API Key to your Wordpress Site

    1. Login to your WordPress Admin Dashboard.
    2. Navigate to Settings -> Captchify Simple A/B.
    3. Copy and paste the API Key in the portal to the API Key field and save settings
    Screenshot 2024 10 06 181015
  • 10

    Create your First Experiment

    1. Go to the Portal and Click Experiments
    2. Select your Application and click Add Experiment
    3. Add a Prefix in this case we chose demo
    4. Add a description
    5. click submit
    6. After your create the experiment click on its name to navigate to the setup
    Screenshot 2024 10 06 181729
  • 11

    Add Dimensions

    1. After Navigating to our experiment lets add Dimensions. More info about segmentation and dimensions can be found here. In short, its how you want to segment your users on your site.
    2. Lets keep it simple, click Add Dimension and select Global and All devices for now and click Save Dimension
    Screenshot 2024 10 06 182257
  • 12

    Add Treatments

    1. Now lets add a second treatment. This is what you will use to determine what to show to a segment and in what proportion. Note: Control is already populated by default.
    2. Click on Add Treatment and write a description. In my case I work demo. and click Save Treatment.
    Screenshot 2024 10 06 183217
  • 13

    Add your Dimension to a Stage

    1. Now that we have treatments and dimensions lets do to the Prod tab which is meant to represents production.
    2. Click on Add Dimension and select GLO-all (this is the identifier string for Global - All). Click Add Dimension.
    Screenshot 2024 10 06 183604
  • 14

    Allocate your Treatments

    1. This is the step where we will set the ratio that a treatment is shown to this specific segment. Check off the box next to Global - All to select it.
    2. Click Set Allocations.
    3. Type 100 in the C box and click Apply Allocations.
    4. This now set Global - All to show C 100% of the time in production, but we are not finished yet!
    Screenshot 2024 10 06 184048
  • 15

    Set your Exposure

    1. Now, we need to configure the exposure for the dimension. This allows you to allocate 50% to C and 50% to T1, while limiting the experiment to only 10% of your user base. In our case we are going to set it to 100% for simplicity.
    2. Click Set Expsoure.
    3. Drag the dongle or type 100 to set it to 100%
    4. Click Apply Exposure
    5. Now Global - All will determine treatment allocations for all your user base.
    Screenshot 2024 10 06 184757
  • 16

    Enable your Experiment

    1. We now have Global - All configured to show 100% of treatment C to 100% of our populace. Thought there is one extra step to do before it will work. We have toggle the Enable switch. This switch is there so you can quickly turn off an experiment.
    2. Click Enabled.
    Screenshot 2024 10 06 185116
  • 17

    Set up your short code

    1. Congratulations, we are now ready to integrate this experiment into your WordPress site.
    2. In this demo we will create a button that will simulate a check with a revenue amount. C will give 100 dollars and T1 will give use 200 dollars.
    3. Copy the below code, note you should type it out out as it is formatted for display and is non functional if you copy it. [simpleab_test experiment_id="<your-experiment-id>" stage="Prod"]

      <button data-simpleab-metric="revenue" data-simpleab-aggregation="sum" data-simpleab-value="100" data-simpleab-events="click,focus"> Click Me - C! </button>

      ||

      <button data-simpleab-metric="revenue" data-simpleab-aggregation="sum" data-simpleab-value="200" data-simpleab-events="click,focus"> Click Me - T1! </button>

      [/simpleab_test]
    4. In this demo we created a dummy post with the above short code block
    Screenshot 2024 10 06 190700
  • 18

    Click the Control Button a Bunch

    1. Lets collect some data, click the control button a bunch to submit metrics for the experiment.
    Screenshot 2024 10 06 191123
  • 19

    Change the allocation to T1

    1. Go Back to your experiment and set the allocation to 100% T1.
    Screenshot 2024 10 06 191412
  • 20

    Reload the Demo Page and Click the T1 Button

    1. Lets collect some data, click the T1 button a bunch to submit metrics for the experiment.
    Screenshot 2024 10 06 191607
  • 21

    Reviewing The Experiment Results

    1. We will start seeing real time results from our metric results as soon as we get enough data.
    2. Lets Review the metric results by going to the Results Tab
    3. Choose the Metric Name, Stage and Dimension from the drop downs
    4. Choose if you want to have the probability calculation be for maximizing the results or minimizing the metric
    5. Select the Date Range to analyze for and click Get Results
    6. This table presents the results of an A/B test with two treatments, C (Control) and T1 (Treatment 1). Here’s what each column represents:
      • Treatment: Identifies the group or variant in the experiment. "C" is typically the control group (baseline), while "T1" is the treatment group being tested against the control.
      • Probability To Be Best: Indicates the likelihood that each treatment is the most effective. In this case, Treatment T1 has a 100% probability of being the best, suggesting it performs better than the control across the observed data. The control (C) has a 0% probability, indicating it is not the best performer.
      • Relative Difference: Shows the percentage difference in effectiveness between the treatment and control. Treatment T1 has a 38.96% relative improvement over the control group. This value represents the extent of T1’s performance gain compared to C.
      • Credible Interval: Provides a range within which the true mean effect of each treatment is likely to fall. For the control (C), this interval is [122.98, 167.13], meaning there is high confidence that the true mean for C falls within this range. T1 has a single value of 201.57, which indicates a very tight credible interval with high certainty.
      • Mean: The average observed outcome for each treatment. For the control (C), the mean is 145.0567, while for T1, it is 201.5743. These values suggest that on average, T1 performs substantially better than C.
      In summary, Treatment T1 is highly likely to outperform the control with a significant positive impact, as indicated by the relative difference and probability to be best.
    Screenshot 2024 10 06 204734