Labeling User Actions

Labelling user actions, also referred to as "defining events" is the main way you manage data in Freshpaint. Once you have labelled a specific user action, you can then send all instances of that user action into the destinations supported by Freshpaint. There are several different types of actions you can define with Freshpaint. As an example, we'll walk through how we at Freshpaint defined an event for when a user clicks the Features button on our home page:

The primary way to define an event is to use the Freshpaint visual editor. To start the visual editor, go to Events > Editor in the Freshpaint app. Then enter the URL of your website and click Launch Editor. This will open your website in the visual editor:

You can use the visual editor to label user actions that are click events. To label a specific user action, just click on the element of your page that you want to define an action on. In our case, we want to define an event on the Features button:

Once you click on the element of your website you care about, the visual editor will highlight that element and all similar elements on the page.

The visual editor will show the number of elements on the page that are similar to the element you clicked on:

To narrow down to a specific element on the page, you can use filters. The visual editor supports three kinds of filters:

  • An href filter - this limits the matching elements to only those elements with the same link as the clicked on element.

  • A text filter - this limits the matching elements to only those elements with the same text as the clicked on element.

  • A path filter - this limits the matching elements to those only on the current page.

In most cases, an href filter will do what you need. In this case, limiting by href limits the event definition to just the Features button:

Once the definition fits the elements you care about, give the event a name and click Save Event. This will label the user action in Freshpaint. In our case, we will call the event Click - Features.

Verifying the Event Definition

To verify the event definition you can use the Freshpaint liveview. Previously all the actions in the liveview were unlabelled. Now that you've created an event definition, when that action is performed on your site, it will show up bolded in the liveview. For example, now when someone clicks on the Features button, a Click - Features event shows up in the liveview:

Sending data to Destinations

Now that you've labelled a user action, you can now send that event into any of your destinations whenever a user performs that action. To send that event to a destination, go to the Events Schema page. The Schema page is where you manage all your event definitions and the destinations they are being sent to. If you select the event you just defined and scroll to the bottom, you will see the Event Destinations Panel:

This is where you control what destinations this event is being sent to. Once you turn on a destination, Freshpaint will forward that event to the destination every time that event occurs. Once I turn on the Google Analytics destination for the Click - Features event, Freshpaint will forward that event to Google Analytics every time a user performs the Click - Features event. For example, once I turn it on and go to the Realtime > Events view in Google Analytics, I see: