Importing a CSV File

The CSV Import features support:

  • Bulk uploading of user attributes - useful when targeting study respondents.
  • Bulk list uploads for email studies.
  • Bulk uploading of People for creating Manual Groups.

Prerequisites

The CSV file must have a column that corresponds to the User ID field that can be seen on a visitor's page in the people tab. If you do not add a User ID, a random number will be generated for the User ID. In addition, if using the CSV upload to create a cohort for an email study, you must include a column that corresponds to the email field that can be seen on a visitor's page in the people tab.

For Email Studies, you will also need a categorical variable in one of the columns (it is list_name in the example below) to specify which emails to send the study to.

ℹ️

Info

Sprig only supports 100 unique values for each attribute key.

Steps to import user attributes into Sprig:

  1. In the Navigation Pane, click Connect. Under Upload a Spreadsheet, click Upload File.
  2. Optionally, click Download sample CSV to download a file showing an example of the file format required by Sprig.

user_id

email

list_name

Country

Plan

970340

[email protected]

Email Campaign 1

Canada

1

971933

[email protected]

Email Campaign 1

Canada

2

251486

[email protected]

Email Campaign 1

United States

15

429211

[email protected]

Email Campaign 2

United States

20

346380

[email protected]

Email Campaign 2

United States

1

Example CSV File

ℹ️

Info

If you used the example CSV file to start with, don't forget to change the column headers to match your attribute labels.

  1. Once you have created your CSV, drag the file to the target or click Browse files.
  2. After you have selected the file to upload, you will be asked to choose which columns should be mapped to user_id and email.
  3. Then click Continue to Upload. If you want to add the user to a group, select Add people to Group after uploading. For more details on uploading a CSV file to a group click here.

ℹ️

Info

When respondents' User IDs are the same as existing User IDs, new data will be added to that visitor's page in the people tab. Existing attribute values will be overwritten.

If the respondent's User ID is unique (it does not match an existing User ID), a new visitor will be created. Email is not classified as a unique identifier; multiple visitors can share the same email attribute.

Click Refresh Refresh to check on the status of the upload

  1. When it has been completed, Click People to confirm that the new users have been uploaded.
  2. Click the Browser Reload button (this causes the attributes to be loaded into the Sprig UI).