Attributes

An Attribute is a set of key-value pairs made up of strings, numerics, and booleans that help you get the most out of Sprig. Specifically _Attributes _provide more context about the user in order to gain a better understanding of who they are when they come to your application. Listed below are examples of attributes as a set of key-value pairs.

Attribute KeyAttribute Value
LanguageSpanish, English, Hindi, Arabic, Bengali, Portuguese, Russian, Chinese
Temperature23.3, 22.1, 19.0, 28.2, -9.1
DayMonday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
Plan TypeFree, Professional, Standard, Advanced, Enterprise

Sprig supports categorical, discrete, continuous and ordinal attributes. There is no limit to the number of discrete values for any given key.

Attributes cannot be deleted unless the entirety of the data for a given visitor is also deleted. This means that you must be careful when considering an update to the key-value pairs of a given Attribute. As an alternative to deleting, you may consider creating a new Attribute instead of trying to update the original Attribute.

Purpose of Attributes

Attributes can be used to refine the target users and also filter the response data.

FilteringAttributes, like Events, can be used in a study to target and help refine the cohort of users you wish to study. Unlike Events, Attributes cannot fire or trigger a Study; they can only Filter.
Study ResponseAttributes can also be used as filters to drill into the study response data (once responses are collected and if at least one of the Respondents had (a) value(s) set for a given Attribute when the study was delivered the responses contain the Attribute’s values)

Managing Attributes

Installation and Setup

Filtering - further target a cohort of users on a given study.Response "More Filters" - refine or view responses to the study.
Sprig UIRead OnlyRead Only
Web SDK:white-check-mark::white-check-mark:
Mobile SDK:white-check-mark::white-check-mark:

Integrations and Connections

Sprig supports the following methods to import Attributes.

Filtering - further target a cohort of users on a given study.Response "More Filters" - refine or view responses to the study.
Sprig SDK:white-check-mark::white-check-mark:
CSV Import:white-check-mark::white-check-mark:
Google Tag Manager:white-check-mark::white-check-mark:
Segment:white-check-mark::white-check-mark:
Public API:white-check-mark::white-check-mark:

Viewing

To view the Attributes being sent to Sprig, click Attributes in the Navigation Pane.

The Name of the attribute is shown in the first column. This label may be generated by the attribute source; it is known as the Key. You can override the Key with a more descriptive Display Name. To change from a Key to a Display Name label:

  1. Click the Attribute in question.
  2. Click Configure.
  3. Uncheck Use Key as display name.
  4. Type in the Display Name.
  5. Optionally, update the Description field.
  6. Click Save Changes.

You can filter which Attributes from which Sources to display and whether to display Active or Archived Attributes. To filter Sources, click "All Sources" and check or uncheck the sources that you want to display. To filter the attribute operational state, toggle between Active Attributes or Archived Attributes.

Inspecting and Diagnosing

  1. In the Navigation Pane, click Attributes.
  2. To learn more about how often the attribute is updating, in the Usage column, hold the pointer over diagnostics diagnostics in Usage.
  3. If the diagnostics is grey diagnostics, your attribute has not updated from your source in the last week.
  4. If the diagnostics is green diagnostics, your attribute has been updated within the last week.

📘

Info

Attributes uploaded from a CSV file will not update the Usage column.

Archiving and Unarchiving

Archiving an attribute stops the Attribute from updating or being tracked by Sprig.

  1. In the Navigation Pane, click Attributes
  2. Make sure the filter is Active Attributes.
  3. Click the check box next to the Attribute and click Archive.

Similarly, you can Unarchive an archived attribute to start tracking an attribute again.

  1. In the Navigation Pane, click Attributes
  2. Make sure the filter is Archived Attributes.
  3. Click the check box next to the Attribute and click Unarchive.

Manually Uploading Attributes

  1. In the Navigation Pane, click Attributes
  2. Click Upload CSV. More details on the file format and steps can be found here.
  3. Once the Attributes have been uploaded, you can view them under Attributes.