Attributes and Events Page

Prev Next

Suggested reading: Event vs. Attribute

You can see the default and custom attributes and events on the Attributes and Events page. You can use this page if you want to:

  • Insert a custom attribute or event using any Insider API.
  • Understand the trend of data (attributes and events) ingestion on a daily/weekly/monthly basis, along with their sources.
  • Map user data to a custom attribute when uploading a contact list or creating a custom segment.
  • Create a custom attribute or event.
  • Edit any of the previously created attributes or events.

Attributes and events often work together to provide a comprehensive view of user behavior and product performance. For example:

  • A user’s attributes (e.g., age, location) can be combined with their event data (e.g., product views and purchases) to understand how different user segments interact with the product.
  • Events can trigger updates to attributes (e.g., a purchase event updates the user’s last purchase date attribute).

Thanks to analyzing attributes and events together, you can gain deeper insights into your users, improve personalization, optimize user journeys, and make data-driven decisions.

What are the attributes?

Attributes are properties or characteristics that describe an entity. In the context of user data, attributes typically describe users, products, or any other entities being tracked. Some attribute examples are:

  • Age
  • Gender
  • Location
  • User ID
  • Account creation date
  • Subscription type

You can refer to the video below to explore user attributes:

What are the attribute limits?

Landing on this page, you can see the limit for custom attributes and parameters, how many there are, and the number of attributes. You can have up to 80 custom attributes (excluding default attributes) by default. This includes all custom attributes from the mobile application, website integration, CRM integration, and email custom fields. 

The total limit for custom attributes and event parameters varies by account.

For example, if UCD allocates more than the default limit of attributes to you in total, Insider calculates the difference between the default and custom attributes and displays the available custom attribute value.

The Attributes page

You can easily switch between events and attributes using the tabs under the top section.

You can filter listed attributes based on their types, data types, or the keyword you enter in the Search bar.

This listing page displays attributes along with the following information:

  • Type: Displays if it is a custom or default attribute. Custom attributes are automatically collected, while custom ones need to be fired by you.
  • Name: Displays the name of the attribute
  • Data type: Displays the value type (e.g., datetime, number, boolean, etc.)
  • Notes: Displays the notes written while creating.
  • PII Status: Displays the PII status.
  • Tags: Display the tags assigned to find, filter, and group attributes.
  • Actions: You can see the attribute analytics page and detailed information under the Actions column. Once you click the Information button, you will see all the information related to the attribute you selected.

To apply a broader filtering, click the Filters button.

You can filter attributes by their Source, PII status, and tags.

Thanks to the Columns button, you can customize the columns on the listing page.

What are the events?

Events are actions or occurrences that happen over time and can be tracked. These events are typically tied to user interactions with a product or service, providing valuable data on user behavior and engagement. Some event examples are:

  • Page views
  • Button clicks
  • Product purchases
  • Form submissions
  • Video plays

You can refer to the video below to explore events:

What are the event limits?

There is no limit to the number of events. However, event parameters—like attributes—are limited. You can create up to 80 custom event parameters (excluding default ones). Multiple events can share the same parameters, and each event can include multiple parameters.

Please note that one parameter name in the different events consumes only one limit. For example, you have an event parameter called “store name,” and you have three events:
- Event A - Purchase, Event B - Add to cart, Event C - Product Viewed
- Event Parameter = Store name
This parameter will consume 1/80 of the limit, even though it is used in multiple events.

The Events page

Using the tabs under the top section, you can easily switch between events and attributes.

You can filter the listed events based on their types or the keyword you enter in the Search bar. 

This listing page displays events along with the following information:

  • Type:  Displays if it is a custom or default event. Custom events are automatically collected, while custom ones need to be fired by you.
  • Name: Displays the name of the event. 
  • Notes: Displays the notes you wrote while creating the event.
  • Tags: Display the tags assigned to find, filter, and group events.
  • Actions: You can view analytics and detailed information in the Actions column. Once you click the Information button, you will see all the information related to your selected event.

To apply a broader filtering, click the Filters button.

You can filter events by their source and tags.

Thanks to the Columns button, you can customize the columns on the listing page.

Attributes and Events data analytics

You will see the analytics page with its trend line when you click the Analytics button next to an attribute or event.

For every data (attributes or events), you can understand how much has been ingested over time (whether on a daily, weekly, or monthly basis) 

  • Under Collected, you can see the sum/total data ingested over the period of time selected from the date range.
  • You can select to change how you view the data (on a trend-line basis) to see it over a daily, weekly, or monthly basis.
  • By default, you can view all data coming from all sources. If you want to filter it out, you can do it from the metrics filter from the Metrics dropdown (Web, Mobile SDK, Email/CRM, API)

Note that the displayed data is the total number of ingested data at that period range, but not the events that happen at that moment Examples to illustrate how we are counting the data ingestion

  • If today is 1 January 2024, and you send an event with 1 Dec 2023 time-stamp today, Insider will record +1 ingested data count for 1 January 2024 here.
  • If you send an Upsert API request and change the attribute value today, Insider will record +1 ingested data count for the period of today.
  • If you send an Upsert API request and send same value (example: same name) today, Insider will record +1 ingested data count for the period of today.
  • If you send a delete request and delete an attribute today, Insider will not record any ingested data, because deletion is not same as data ingestion.
The Raw Export logs events based on their actual timestamp, regardless of when they are recorded in UCD. In contrast, the S3 Export captures events within specific intervals, like the past hour, according to their UCD entry time. For example, the event counts displayed on the Metadata Analytics page represent all transmissions sent to UCD. Sending the same event 100 times results in only one entry in the database, but shows a transmission count of 100 on the page, while Raw Export will show only 1.
If an event timestamped three days ago but sent today will appear in S3 Export based on the current transmission timeframe, like the last hour.
The data you have seen here is not limited by the relevant Event TTL. Insider counts these metrics daily, stores them, and showcases the results as a trend line. If you have events with a 3-month TTL, you can see trends from over 3 months ago. Insider has stored these logs indefinitely since the first date of data ingestion.