{"id":3682,"date":"2021-04-08T21:58:53","date_gmt":"2021-04-08T16:28:53","guid":{"rendered":"https:\/\/dataled.academy\/?post_type=guides-new&#038;p=3682"},"modified":"2022-02-07T16:05:33","modified_gmt":"2022-02-07T10:35:33","slug":"entities-and-event-data","status":"publish","type":"guides","link":"https:\/\/dataled.academy\/guides\/entities-and-event-data\/","title":{"rendered":"What are Entities in the Context of Event Data?"},"content":{"rendered":"\n<p><em>This is part 3 of the 5-part series on Customer Data. Here are parts <a href=\"https:\/\/dataled.academy\/guides\/customer-data\/\" target=\"_blank\" rel=\"noreferrer noopener\">1,<\/a> <em><a href=\"https:\/\/dataled.academy\/guides\/purpose-of-event-data\/\" target=\"_blank\" rel=\"noreferrer noopener\">2,<\/a><\/em> <em><a href=\"https:\/\/dataled.academy\/guides\/components-of-event-data\/\" target=\"_blank\" rel=\"noreferrer noopener\">4,<\/a><\/em> and <em><a href=\"https:\/\/dataled.academy\/what-to-track\/\" target=\"_blank\" rel=\"noreferrer noopener\">5<\/a><\/em>.<\/em> <em>It is also highly recommended to go through part 1 (<\/em><a href=\"https:\/\/dataled.academy\/guides\/customer-data\/\"><em>What Is Customer Data?<\/em><\/a><em>) before this one.<\/em><\/p>\n\n\n\n<h2 id=\"introduction\">Introduction<\/h2>\n\n\n\n<p>Event data is incredibly helpful to decipher <strong>what <\/strong>is going on inside a product or <strong>how <\/strong>something is being done. However, unless you know <strong>who <\/strong>is performing those events, there\u2019s not much you can do in terms of segmentation and understanding user personas.<\/p>\n\n\n\n<p>This is where entity data<em> <\/em>comes into play where <em>User <\/em>is the primary entity and <em>user_id <\/em>is the key property that needs to be associated with every event. Doing so, enables you to understand user behavior by answering questions like:&nbsp;<\/p>\n\n\n\n<ul><li>How many unique users performed the event <em>Campaign Sent<\/em>?<\/li><li>Which users performed this event?<\/li><li>What is the average number of events a user segment performed before performing the event <em>Campaign Sent <\/em>for the first time?<\/li><li>Which events were performed by the user segment before this event?<\/li><\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Besides understanding user behavior, associating events with users enables you to send them relevant in-app messages and emails based on their actions.\u00a0<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 id=\"one-event-multiple-entities\">One Event, Multiple Entities<\/h2>\n\n\n\n<p><em>User <\/em>is the primary entity associated with every event performed by a user. But when a user is part of a group or an account \u2014 <em>organizations <\/em>or <em>workspaces <\/em>in the context of B2B SaaS products \u2014 <em>Account <\/em>is also an entity that needs to be associated in order to provide more context about events and track user activity at an account (or group) level.<\/p>\n\n\n\n<p>Since an account comprises multiple users, associating the right account with user events helps understand the overall health of an account and answer important questions such as:<\/p>\n\n\n\n<ul><li>How many accounts are activated?<\/li><li>What is the average number of users for active accounts?<\/li><li>How many accounts contain X or more users?<\/li><\/ul>\n\n\n\n<p>It helps to keep in mind that the collective actions of users in an account often contribute towards activation rather than those of a single user.<\/p>\n\n\n\n<p>Therefore, SaaS products that are used by multiple users collaboratively need to associate multiple entities \u2014 <em>user <\/em>and <em>account <\/em>\u2014&nbsp; with every event.&nbsp;<\/p>\n\n\n\n<p>If an account is referred to as an organization, on top of the <em>user_id<\/em>, the <em>organization_id<\/em> needs to be associated with events in order to know <em>which user<\/em> performed an event, and under <em>which organization.\u00a0<\/em><\/p>\n\n\n\n<p>For instance, if a user (X) creates a new project inside a project management app used by an organization (Y) with 10 users, two important pieces of information is generated:&nbsp;<\/p>\n\n\n\n<ul><li>X created a new project <em><strong>or<\/strong> <\/em>X performed the event <em>Project Created<\/em><\/li><li>A new project was created inside organization Y <em><strong>or<\/strong> <\/em>the event <em>Project Created <\/em>took place in organization Y<\/li><\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Besides associating the event <em>Project Created <\/em>with the <em>user<\/em>, failure to associate the event with the <em>organization<\/em> will result in the loss of the second piece of information. <\/p>\n\n\n\n<p>Additionally, subscription-related events such as <em>Trial Started<\/em>, <em>Trial Ended<\/em>, and <em>Subscription Cancelled <\/em>take place at the organization level and do not pertain to any specific user.<br>Whether such events take place automatically (the card on file couldn\u2019t be charged) or as a result of a user action, it can be helpful to associate these organization-level events with all users in an organization. This ensures that you are not restricted to engaging only with the owner of the account and that other users in the account can be notified when such events take place.<br><em><br><\/em>Failure to associate events with accounts will hinder analysis and engagement efforts as you will only have data pertaining to the actions of individual users. Moreover, combining user events with the right organizations at a later time either won\u2019t be possible or will be a huge pain for your data engineers.<\/p>\n\n\n\n<p>And this problem exacerbates multifold if your product enables a user to be part of multiple accounts.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 id=\"one-user-multiple-accounts\">One User, Multiple Accounts<\/h2>\n\n\n\n<p>In B2B SaaS, it is common for a user to be associated with multiple accounts or organizations.&nbsp;<\/p>\n\n\n\n<p>Apps such as Notion, ClickUp, and Integromat allow a unique user to join or create multiple organizations.&nbsp;<\/p>\n\n\n\n<p>This means that the same user performs events under multiple accounts. However, those events are unrelated as they don\u2019t take place under the same account or organization.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter size-large is-resized\"><img data-attachment-id=\"1752\" data-permalink=\"https:\/\/dataled.academy\/?attachment_id=1752\" data-orig-file=\"https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts-.jpg\" data-orig-size=\"2624,1524\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"03.-One-User-Multiple-Accounts-\" data-image-description=\"\" data-image-caption=\"\" data-medium-file=\"https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--300x174.jpg\" data-large-file=\"https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--1024x595.jpg\" loading=\"lazy\" src=\"https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--1024x595.jpg\" alt=\"\" class=\"wp-image-1752\" width=\"586\" height=\"340\" srcset=\"https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--1024x595.jpg 1024w, https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--300x174.jpg 300w, https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--768x446.jpg 768w, https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--1536x892.jpg 1536w, https:\/\/dataled.academy\/wp-content\/uploads\/2020\/11\/03.-One-User-Multiple-Accounts--2048x1189.jpg 2048w\" sizes=\"(max-width: 586px) 100vw, 586px\" \/><\/figure><\/div>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>For products that allow one user to be part of multiple organizations, it is paramount to know under which organization did a user perform an event in order to track account-level activity.<br><br>In conclusion, when one user is part of multiple accounts, you need to isolate user activity that takes place under each account to understand what is going on at an account level.<\/p>\n\n\n\n<p>If entities <em>(user, organization, workspace, etc.)<\/em> are not associated with events correctly, your data set can get heavily skewed. Not being aware of such issues can lead to business decisions being taken on incorrect data, the outcome of which can be significantly detrimental.&nbsp;<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 id=\"not-just-an-identifier\">Not Just an Identifier<\/h2>\n\n\n\n<p>Let\u2019s go back and assume the user to be the only entity for a product.&nbsp;<\/p>\n\n\n\n<p>Entity data not only helps identify the user who performs an event but also tells you a lot more about that user. It is a good practice to categorize entity data into the following buckets:<\/p>\n\n\n\n<ul><li><strong>Personally identifiable information<\/strong> such as <em>name, email, <\/em>and <em>phone\u00a0<\/em><\/li><li><strong>Demographics<\/strong> such as <em>age, gender, <\/em>and <em>location<\/em><\/li><li><strong>Persona <\/strong>such as <em>industry, job role, <\/em>and <em>goal<\/em><\/li><li><strong>Preferences <\/strong>such as <em>brands, genres, and product categories<\/em><\/li><li><strong>Account data<\/strong> such as <em>subscription_type, number_of_users, account_manager, <\/em>and <em>renewal_date<\/em><\/li><\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Specifying the entity properties is a crucial step in the process of setting up event-tracking, and is <a href=\"https:\/\/dataled.academy\/guides\/tracking-plan\/\">covered in detail in the tracking plan guide<\/a>.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 id=\"conclusion\">Conclusion<\/h2>\n\n\n\n<p>Thinking about entity properties (that help in segmenting users) might spark new ideas or bring up queries related to user segmentation such as what data is gathered when a user signs up for your product.<br><br>Are you asking the right questions and providing users with relevant options? Do you need to modify those questions or ask new ones to better understand user personas? What about the naming convention of the properties or the data type of each property?&nbsp;<\/p>\n\n\n\n<p>While it might seem a bit much to mull over all those minute details, it is important to ask those questions sooner rather than later to ensure that you collect clean data, that is easy to analyze and act upon.&nbsp;<\/p>\n\n\n\n<p>You now know the role entity data plays in the process of gathering event data which means it\u2019s a good time to <a href=\"https:\/\/dataled.academy\/guides\/purpose-of-event-data\/\" target=\"_blank\" rel=\"noreferrer noopener\">see what events and entities look like and learn how to define them properly<\/a>.&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn what entitities are and what purpose they serve in the context of tracking event data.<\/p>\n","protected":false},"author":56487188,"featured_media":1769,"template":"","technologies":[1423,1428],"teams":[],"data-flow-stages":[1410,1415,1422],"jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/guides\/3682"}],"collection":[{"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/guides"}],"about":[{"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/types\/guides"}],"author":[{"embeddable":true,"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/users\/56487188"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/media\/1769"}],"wp:attachment":[{"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/media?parent=3682"}],"wp:term":[{"taxonomy":"technologies","embeddable":true,"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/technologies?post=3682"},{"taxonomy":"teams","embeddable":true,"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/teams?post=3682"},{"taxonomy":"data-flow-stages","embeddable":true,"href":"https:\/\/dataled.academy\/wp-json\/wp\/v2\/data-flow-stages?post=3682"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}