Documentation Center

English

简体中文

English

简体中文

Tracking Custom Attributes ​

While there is plenty of data that Aimtell tracks for you automatically, custom attributes allow you to additionally track other data that you can use for advanced personalization in your notifications, as well as for segmentation.

Note: Before you begin, read up on what data Aimtell automatically tracks for all users, as well as what data we automatically track for Shopify users .

What is a Custom Attribute? ​

A custom attribute is any data point you choose to track on a particular user or Subscriber ID. This data point can be absolutely anything. This is a wonderful way to track data that can be utilized in two distinct ways- for segmentation purposes and for personalization within push notifications.

Custom Attribute Examples ​

Here is a list of some example custom attributes, but do not let this limit you, as there are endless possibilities for what you can track. They really are Custom attributes! Let these examples serve as inspiration for what is possible:

  • First name
  • Last name
  • Email
  • Username
  • Total clicks
  • Last login date
  • Subscription plan
  • Referral status
  • Billing platform
  • Billing date
  • Length of time as a customer
  • Registration date
  • Last email open date
  • Trial days remaining
  • Time spent on site
  • Order count
  • Total spent
  • Gender
  • Age
  • Subscription URL

It is worth noting that custom attribute values are limited to 250 characters. Any characters above this limit will be truncated.

How to Track Custom Attributes ​

Custom attributes can be added with our Javascript API or the REST API.

Option #1 - Javascript API ​

You may add a custom attribute the current subscriber at any point by calling the _at.track javascript function. Below is an example.

html
<script>
_at.track("attribute", {"age" : "35", "name":"david"})
</script>

To add the custom attributes via a REST call check out our documentation at our API Documentation here .

Verifying Attributes Are Tracking ​

To confirm that you correctly set up a custom attribute, we recommend checking your logs. To do so, head to Logs > Custom Attributes. If what you set up is not there it was either not set up correctly, or the attribute has not been tracked yet.

Using Custom Attributes ​

Once you are tracking custom attributes, you can begin using them for segmentation and within push notifications. For more information on using custom attributes within segmentation, feel free to read our documentation on Using Custom Attributes in Segmentation . For more information on using custom attributes within notifications, read our documentation on Using Custom Attributes in Notifications .

Importing Custom Attributes ​

Do you have data that you have already tracked elsewhere (such as in a CRM or with another web push provider)? You can import it into Aimtell to use for your notifications and segmentation. Read our Importing Custom Attributes documentation for details on how to import this data.