Setting up your workspace
You can find Waaila here.
To log in, you need a Google account. If you plan to use mainly Google Analytics as the source of your data, it is recommended to log in with the account where you have the access to Google Analytics. However, you will have an option to add an additional account with the access later.
Waaila location tabs
In Waaila there are three main locations separated into tabs: My Depots, My Templates and Template Gallery. Under the tab My Depots you can work with data sources and manipulate and run tests. In the My Templates you can store existing tests for further use. The most helpful tests you can then share with other users in Template Gallery where you can also find tests shared by other users. All areas are described more in detail in separate sections.
Using depots and datasets
When you open Waaila, you see your workspace under the tab My Depots. If you log in for the first time, it is currently empty and you are asked to create a depot.
In Waaila, a workspace is divided into depots and each depot may contain several datasets. Datasets in Waaila consist of a collection of tests and a connection to a particular source of data, such as a particular view in Google Analytics or a specific account at Piano Analytics (formerly AT Internet). There can be multiple datasets connected to the same source of data, each with a particular purpose. A Waaila depot is a basically a list of one or more datasets. You can use separate depots if you have data from several websites or for testing and alerting but if you don't need multiple depots, you can have all your datasets within one depot.
To create a depot, select the button "Create a new depot", choose a name for it and optionally write a description of the purpose of this depot. You can change both the name and the description later.
When you have a depot, you can either create an empty dataset or create a dataset from an existing collection of tests.
Creating dataset from a test collection in My Templates
If you do not have any test collection in My Templates, go first to the Template Gallery, select a collection, click on the button "Use template" and continue to step 1.
If you have the required collection in My Templates, select the collection and click "Use template".
-
The datasource provider is specified already (it is fixed for an existing test collection as tests are tailored for specific data structure)
-
Select an existing depot where the dataset should be located or create a new one by selecting the option "Create a new depot"
-
Next, select the option to "Create a new dataset" (tests can also be added from a template to an existing dataset in this step if you already have some existing datasets)
-
Select an authentication method for given datasource provider
for Google Analytics data:
- Select the provider account - if you are using your main account with which you logged in to Waaila, it is offered in the selection field; if you need to connect a new account, follow authentication below the field
for Piano Analytics (formerly AT Internet) data:
- Keep the API Key authentication selected
- Select an existing account or choose to connect a new account
- When connecting a new account using API Key, you need to enter a combination of an access key and a secret key from your Piano Analytics profile:
- go to the Piano Analytics Explorer
- click on user icon in upper right corner
- select See profile
- from the displayed tabs select API Keys
- click on the button to create a new API key
- insert appropriate name and description (e.g. "Waaila access") and select the button Create a new API key
- copy the access key and secret key displayed and save them to save location
- return to Waaila
- under New Account input the access key into the Key field
- input the secret key into the Value field
-
Select specific data
for Google Analytics data:
- From listed data sources, select an account, property and view that you want to use for testing
for Piano Analytics (formerly AT Internet) data:
- This parameter can be changed by the configuration inside individual tests
- Enter one or more dataset codes (id of the space) that the connected account has access to
- The code can be found at AT Internet Data Query in generated links as the content of the space parameter
- click on the "Send to ..." button
- select "Copy the API body (POST)"
- search out the "space" parameter in the JSON query
-
Set a custom name or leave the existing name
-
Optionally add a description
-
Confirm the configuration by clicking "Save"
Creating a dataset without tests
To create a new dataset with no pre-specified tests, go to an existing depot and select the button "Add dataset".
-
Select a datasource provider
-
Select an authentication method for given datasource provider
for Google Analytics data:
- Select the provider account - if you are using your main account with which you logged in to Waaila, it is offered in the selection field; if you need to connect a new account, follow authentication below the field
for Piano Analytics (formerly AT Internet) data:
- Keep the API Key authentication selected
- Select an existing account or choose to connect a new account
- When connecting a new account using API Key, you need to enter a combination of an access key and a secret key from your Piano Analytics profile:
- go to the Piano Analytics Explorer
- click on user icon in upper right corner
- select See profile
- from the displayed tabs select API Keys
- click on the button to create a new API key
- insert appropriate name and description (e.g. "Waaila access") and select the button Create a new API key
- copy the access key and secret key displayed and save them to save location
- return to Waaila
- under New Account input the access key into the Key field
- input the secret key into the Value field
-
Select specific data
for Google Analytics data:
- From listed data sources, select an account, property and view that you want to use for testing
for Piano Analytics (formerly AT Internet) data:
- This parameter can be changed by the configuration inside individual tests
- Enter one or more dataset codes (id of the space) that the connected account has access to
- The code can be found at AT Internet Data Query in generated links as the content of the space parameter
- click on the "Send to ..." button
- select "Copy the API body (POST)"
- search out the "space" parameter in the JSON query
-
Set a custom name or leave the existing name
-
Optionally add a description
-
Confirm the configuration by clicking "Save"