In this guide, you will learn how to perform A/B testing between store workspaces in CMS Legacy and VTEX IO to confirm which workspace has the highest conversion rate for your store.
Before you start
-
Install the VTEX IO Command-line Interface (CLI). Through the CLI, you can log in to your VTEX account, manage workspaces and develop new apps.
-
Ensure that you already have a Development workspace for your account. Otherwise, create and set up one following Creating a Development workspace in IO for a CMS legacy store guide.
-
Ensure that your Development workspace has the
vtex.edition-store@3.x
Edition app installed. Run thevtex edition get
in your terminal to verify the Edition App version installed on the current account. Otherwise, Open a ticket to the VTEX support team requesting the installation of thevtex.edition-store@3.x
Edition app in the new Development workspace.
Step-by-step
- Using your terminal and the VTEX IO CLI, log into your VTEX account by running the following command:
vtex login {account-name}
Remember to replace the value between the brackets for the VTEX account name you desire. For example:
vtex login account-name
.
- Access the Development workspace that you have created by running:
vtex use {workspace}
Remember to replace the value between the brackets for the Development workspace you desire. For example:
vtex login test
.
-
Run the
vtex use Master
command in your terminal to perform the steps below in the Master workspace. The Master workspace must be set to thevtex.edition-business@0.x
edition app. -
Install the
vtex.colossus-legacy-proxy@@1.8.9-hkignore
app. This is an essential step to avoid that you store in production break.
The app’s version must be
vtex.colossus-legacy-proxy@@1.8.9-hkignore
. If not, the store won’t respond to the request.
- Open a ticket to the VTEX support team requesting the redirection of the production workspace to be rendered in VTEX IO
If the store has a different storefront for mobile, inform this in the ticket to the VTEX support.
- Once the Production workspace is rendering in the VTEX IO, you can enable the A/B test between the workspaces described in the Running native A/B tests step-by-step.
Validating if the A/B test is running
- To ensure that the A/B test is working, make a GET response in the following API:
http://platform.io.vtex.com/{{account}}/_abtest/parameters
The Header must have
VtexIdclientAutCookie
from the account you want to get the information. For example:VtexIdclientAutCookie: {{VtexIdclientAutCookie}}
- The result should be similar to the following:
"master": {
"A": 9000,
"b": 1
},
"wsio": {
"A": 1000,
"b": 1
}
The result means that the master
is with 90% of the traffic and the wsio
is with 10%.
Next Step
After finishing the A/B test and want to migrate your store to IO, open a ticket to the VTEX support team requesting the migration of your Development workspace to the IO.