Send custom traits (attributes) to Rapidr

Rapidr allows you to create and track customized traits (attributes) associated with your users and their accounts based on criteria specific to your business. This information can be utilized to filter and segment your customers.

We refer to this custom field and attribute all throughout Rapidr as a "trait" that can be linked to a user or account.

What’s a data attribute?

A data attribute tracks facts about your customers — like the plan someone is on, or when they signed up — as opposed to an event, which tracks recurring customer actions.

Here's an example: Let's say your product is a fitness app that allows users to track their daily exercise routines. With Rapidr, you could track data related to a user's workout frequency, their preferred exercise types, and their fitness goals. Then, if you want to filter feedback by users who have done more than X workouts, you could set up a segment of users with "workouts more than X."

The most common data attributes set up on Rapidr are about customer development, such as:

Price plan
Value of purchases
Number of teammates added
Number of important actions performed
Date subscription ends
Account type

How do I create custom data attributes?

To create a new attribute in Rapidr, go to Company Settings > User Data > User traits "+ Add trait" or Account traits "+ Add trait".

Note on User & Account traits: Whenever you need to store information about a user, utilize User traits. On the other hand, if you're keeping track of information about the user's account (also known as company or organization), make use of Account traits.

Then, give your new trait name in the Key field, select the type of data it will store:

Click Create and the attribute will be added to your attributes list. It won't be populated for any of your customers yet, you'll need to send it to Rapidr via the JavaScript snippet.

Double check that your keys always have a JSON-valid value that is a string (text), number (or decimal), or boolean (true or false). That means using double quotes around text strings and sending NULL to cater for cases when no value exists for a user. You can also send us dates formatted in ISO 8601.

Please note: We will only recognize and retain the traits you've created in Rapidr. Everything else will be disregarded.

Here is a sample identify call using Rapidr SDK. For further details on integration, please refer to our developer documentation.

Rapidr('identify', {
  host: "subdomain.rapidr.io",
  id: 123,
  secureHash: 'bd16eae883a0a39f7c...bbd5b',
  name: 'John Smith',
  email: 'some-user@example.com',
  traits: {
    /*** USER TRAITS ***/<br>    plan: 'premium',
    last_signed_in_at: '2018-01-01T00:00:00.000Z',
    has_done_onboarding: false,
    onboarding_steps_completed: 3,<br>    /*** USER TRAITS ***/<br>
    /*** ACCOUNT TRAITS ***/
    accounts: [{
       // Unique identifier of the account from your platform (required)
      id: 8569,
      // Name of the account
      name: 'Acme, Co.',
      // Custom fields
      revenue: 589.99,
      life_time_value: 1179.98,
      plan: 'business-plus',
      number_of_seats: 120,
      account_manager: 'John Smith',
    }]
    /*** ACCOUNT TRAITS ***/
  }
});