How to install the A/B Testing integration through Azion Marketplace

Mainly, you can use A/B tests to validate certain addresses, interfaces, or even workflows. Tests enable you to experiment with variations and how they work with your users, providing two options to access certain content or complete task.

Getting the integration

To use the A/B Testing integration provided through Azion Marketplace, access Azion Console and go to Marketplace.

On the Marketplace homepage, select the integration’s card.

Once the integration’s page opens, click the Install button, at the bottom-right corner of the page. A successful message appears to confirm your integration is installed.

Configuring the integration

Being an Edge Application function, A/B Testing runs tasks and services on the edge, employing an existing edge application.

Follow the next steps to instantiate the integration.

On the upper-left corner, select Products menu > Edge Application on the BUILD section.
On the listing page of your edge applications, select the one you want to use with the integration.
On the application page, open the Main Settings tab.
Enable the Edge Functions and Application Accelerator switches to activate these modules.
Click the Save button.

A successful message appears informing that the edge application has been updated.

Adding origins

To configure the JSON file, you’ll have to register the origins (websites) you want to redirect your integration. These origins will receive a unique ID called Origin Key.

Still on the page of the application, follow these steps:

Go to the Origins tab.
Click the + Origin button.
Give an easy-to-remember name to this origin.
Select Single Origin for the type of origin.
Choose the protocol you want to use: Enforce HTTP, Enforce HTTPS, or Preserve HTTP/HTTPS to preserve the original protocol.
In Address, pass the URL you want to register for this origin.
Select ${host} for the Host Header option.
You can pass an Origin Path, but this is optional.
Click the Save button.

After you save it, you’ll be able to see the Origin Key generated by Azion Console for the origin you’ve registered. This will be used to fill the originid field on the Arguments box of the function.

Instantiating the integration

Still on the page of the application, follow these steps:

Select the Functions Instances tab.
Click the + Function Instance button.
Choose an easy to remember name for your function.
On the dropdown function menu, select the A/B Testing [Global] function.

This action will load the Arguments tab, where you can add the parameters to execute your application.

The form will load the parameters as below:

{
  "param": {
    "cookie": {
      "name": "azion_abtest",
      "expiration": "Wed, 04 May 2011 10:16:00 GMT",
      "max_age": 600,
      "domain": "localhost",
      "path": "/"
    },
    "a": {
      "cookie_value": "A_TEST",
      "prob": 0.5,
      "addresses_list": "localhost:2006",
      "originid": "uuid1",
      "live_ingest": false,
      "protocol_policy": "http",
      "path": "",
      "cache_key": "test_a",
      "host": "localhost"
    },
    "b": {
      "cookie_value": "B_TEST",
      "prob": 0.5,
      "addresses_list": "localhost:2010",
      "originid": "uuid2",
      "live_ingest": false,
      "protocol_policy": "preserve",
      "path": "",
      "cache_key": "test_b",
      "host": "localhost"
    }
  }
}

Where:

Variable	Description
`name`	The name of the cookie you’ll choose. Give a unique and easy-to-remember name
`expiration`	The expiration date of the cookie
`max_age`	The time, in seconds, for the lifespan of the cookie
`domain`	The domain where you’re running the tests
`path`	The subdomain to the cookie. You can use `/` to set the subdomain to all the domains

On the second section, called a, you can add the parameters to the first test, and then repeat it for the rest of the tests:

Variable	Description
`cookie_value`	A value to identify the cookie for this test variation
`prob`	The probability to send this address to the user. This value should be between `0` and `1`, with `0` being `0%` of chance and `1` being `100%` of chance
`adressess_list`	The address for the `a` test. Example: `www.mytest_ab_of_my_site.com:443`
`originid`	The identification ID for the origin. This will be automatically generated by Azion Console
`live_ingest`	It indicates if the origin is a live streaming. A boolean value should be used here: `true` or `false`
`protocol_policy`	To force `HTTP` or `HTTPS`, or even keep the default value by passing the preserve value
`path`	It indicates the subdomain of the cookie. You can leave it blank, `""`, to indicate that it’s valid for all domains
`cache_key`	A name to identify the cache. It should be unique and you can’t repeat it elsewhere
`host`	The name of the host that the requisition sends

Configuring the Rules Engine

In Rules Engine, you’ll pass the criteria and behavior to run the integration.

Still on the page of the application:

Select the Rules Engine tab.
Click the Default Rule.
- Note that you can’t change or configure the criteria for the Default Rule.
On the Behavior field, choose Run Function and, from the dropdown menu, choose the A/B Testing integration according to the name you gave it.
Add another behavior by clicking on the + Add Behavior button right bellow the first one.
Pass the first behavior: Bypass Cache.
Click again on the + Add Behavior button bellow the second behavior.
Pass the second behavior needed: Forward Cookies.
Click the Save button.

Done. Now you’ll have to wait a few minutes for the edge application to propagate through Azion’s edge nodes.