Attributes

An Attribute is a set of key-value pairs made up of strings, numerics, and booleans that help you and the Sprig to know more information or data about your users as an audience or cohort. 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
CountryCanada, United Kingdom, India, United States, Brazil, Australia, Germany, France
Plan TypeFree, Professional, Standard, Advanced, Enterprise
Feature Cohort StagePaid Alpha, Paid Beta, Paid Production, Free Small, Free Large

Sprig supports categorical, discrete, and ordinal attributes. There can be up to 100 discrete values for any given key. In the example above on Plan Type as the Attribute key, there are 5 distinct Attribute values (Free, Professional, Standard, Advanced, and Enterprise).

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.

⚠️

Warning - 100 Attribute Limit

Avoid placing a data set that is not discrete. Listed below are examples of attributes that are either not discrete or are discrete but typically with ranges of values over 100.

  • Unique IDs
  • Device IDs
  • Timestamps for unique events or interactions

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 UI

Read Only

Read 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:

mParticle

:white-check-mark:

:white-check-mark:

Viewing

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

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 Data Hub > 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 Data Hub > 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 Data Hub > 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 Data Hub > 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 Data Hub > Attributes.