Custom Data Fields

Summary

Blue Triangle enables you to collect custom data for each page measurement for real user data, and synthetic data soon to come. In this article, we'll outline the details on these custom data variables and how to configure them.

• What Types of Custom Data Fields are Available
  
  • Custom Categories
  • Custom Variables
  • Custom Numbers
• How to Configure Custom Data Fields

What Types of Custom Data Fields are Available

There are 3 types of custom data fields you can use: Custom Categories, Custom Variables and Custom Numbers.

Custom Categories

Custom Categories are custom text/string data that are collected from the page and aggregated and ultimately appear in the list of filter options. The configuration requires a display name and the JavaScript variable or JavaScript code required to collect the data from the page. You can optionally specify up to 100 valid values where if the value collected on the page does not match any of the valid values, it will fall into an "(other)" bucket. The limitations of custom categories are:

• Up to 5 different custom categories are allowed
• Custom Category variable/code limited to 1024 characters
• Custom Category display name limited to 128 characters
• Custom Category valid value limited to 255 characters

Custom Variables

Custom Variables are similar to custom categories in that they are custom text/string data, but they're not aggregated and do not appear as filter options. Custom Variables are good to use for collecting text/string data on individual page views, but it's data you don't necessarily need to be able to see at a larger, aggregate scale. The configuration for custom variables require a JavaScript variable or code, and a display name. The limitations of custom variables are:

• Up to 10 custom variables are allowed
• Custom Variable code limited to 1024 characters
• Custom Variable display name limited to 128 characters
• Custom Variable value limited to 255 characters

Custom Numbers

Custom Numbers can be used to store numeric data from the web page. These numbers are aggregated and will appear on your trend graphs in the Blue Triangle portal. You should use custom numbers for any data you would like to see trended in Blue Triangle. Similar to Custom Categories and Custom Variables, the configuration requires a JavaScript variable or code which will collect the data from the web page, and a display name. The limitations of custom numbers are:

• Up to 20 custom numbers are allowed
• Custom Number variable/code limited to 1024 characters 
• Custom Number display name limited to 128 characters
• Custom Numbers are limited to 30 digits and 6 decimal places

How to Configure Custom Data Fields

Currently, custom data fields must be configured by the Blue Triangle team. In order to set these up, simply reach out to your account manager or our customer success team at cs@bluetriangle.com and we'll be happy to help.