Custom Events and User Data


Woopra has three data scopes or types of data that it tracks: event or action data, session data (aka visit data ), and user data .

After installing the basic Woopra Snippet, Woopra will automatically track pageview event data and visit data such as IP address, location, and even campaign data.


Developer Recommended

To track custom actions and identifying users requires some custom coding and sound knowledge of Javascript and the language(s) that your site or app is leveraging. If you are not the primary developer, you will need to work with your development team to set up this custom data tracking appropriately. If you do not have a developer to help create the custom code, please contact [email protected] and we can referrer you do a third-party developer that can assist with your project (individual rates vary).

This section will cover tracking custom actions and user data that are relevant to your business. This includes actions such as signups, payments, subscription updates, product feature usage, video views and so on. This also includes user data such as emails and names.

Please see our technical documentation for custom actions and user data. As well as a more in-depth guide on what to track for eCommerce and SaaS.

Tracking Action Data

What: Custom action data allows you to track any kind of action that is important to your business. For example, you could track “signup”, “play video”, “payment”, and any other critical actions that you would like to analyze and use as criteria for segmentation and reports.

Why: This data can be invaluable to your business. Knowing where user drop off occurs or how many users are clicking on a specific blog can greatly influence site improvement and user engagement. This action data allows you to analyze critical customer behavior that is immediately relevant to you across your various touchpoints. Data driven decisions can make or break a business — tracking actions in Woopra is imperative to get you the data you need.

How: In order to track custom actions, you must send them to Woopra in the Javascript tracking code you placed on your website. For further instructions on how to do this, please see the Javascript tracking setup tutorial. These actions can also be tracked by built-in events installed automatically when you install an Integrations app.

Next: Once you're tracking action data, you can immediately use it throughout Woopra’s features. You can use this data to create various reports(report links), use it to filter customer segments, and even trigger automations. Woopra will automatically create “schemas” the moment the action is detected. Schemas are used to tell Woopra how to read and aggregate the data. More info can be found in our Schemas section (link).

Tracking User Data

What: User data allows you to track user information that is important to your business. This includes tracking visit durations and acquiring identity information such as names and emails when they sign up. User properties are known in different systems as contact or user properties or fields. They are very simply, data describing properties of a particular person. In Woopra, an email property is considered a unique identifier for the user. If you don’t specify the email property for the user, Woopra will automatically fall back to the cookie as a unique identifier.

Why: To get the full value out of Woopra, you should identify your users using custom user data. You can use this data for campaigns or understanding user behavior. For example, knowing what companies your users are working for and which campaigns are driving your signups can save you time and money.

How: In order to track custom user data, you must send it to Woopra by identifying users in the tracking code you place on your website. For more info please see our technical documentation on user tracking, or the specific SDK you wish to use. Additionally, you can start identifying users by email address whenever they sign up if at all possible, as this will give you more accurate data about each individual’s behavior. Lastly, many of our Integration apps require users to be identified by email in order to assign the behavioral data to the correct profile.

Next: Once you are tracking user data in Woopra, you can use this data throughout Woopra’s features. You can use this data to filter or segment users based on selected criteria, create detailed People reports, and create profiles that track a user's journeys through their engagement with your product. Similar to Action data, Woopra will automatically create “schemas” for these events as well.