Setting up Your Events

Setting up your events is the most important part of setting up Freshpaint. Once you've setup your events, you can then send those events into any of the destinations you have enabled. We recommend creating a spreadsheet of all the events you and your team will need. Once you've created this list, go through and define each of them.

If you are on our paid account plan, we'll guide you through the implementation process and help you develop an event capture strategy. Reach out to [e-mail] and we'll find a time to jump on an onboarding call together.

There are several ways to define events in Freshpaint:

When possible, we recommend defining events with either the visual tagger or with Live View. Here is a table of which ways to define events are supported by each SDK:

	Web	React Native	iOS	Android
The Visual Tagger	YES	no	no	no
The Live View	YES	no	no	no
The Event Library	YES	YES	no	no
With Precision Tracking	YES	YES	YES	YES

The Visual Tagger

The visual tagger is the recommended way to setup events for non-technical users. The visual tagger provides a point and click interface for creating events. For more information on how to use the visual tagger, see our guide:

Visual Tagger

Liveview

Defining events through Liveview is the other way we recommend defining events. If you want to define an action, you can perform it on your website, then click Create Event in Liveview next to the action you just performed. This will take you to the events library page with the definition for your event pre-populated. For more information, see our guide to the Liveview:

Live View

The Event Library

The event library editor is a more advanced way to define events. The event editor is more expressive than either liveview or the visual tagger, but you do need to be a bit technical to understand how to use it. If you are technical and want to create an event definition that you can't easily express in the visual tagger, the event library editor may be the best option available. See our guide to the Event Library for more information:

Event Library

Precision Tracking

Web

freshpaint.track("login", {"property": "value"});

React Native

freshpaint.track("login", {"property": "value"});

iOS Swift

Freshpaint.shared().track(
    "Purchase", 
    properties: ["price": 500]
)

iOS Objective-C

[[FPAnalytics sharedAnalytics]
              track:@"login" 
              properties:@{ @"property": @"value" }];

Android

Freshpaint
    .with(getActivity().getApplicationContext())
    .track("login", new Properties().putValue("property", "value"));

If you want to track events that aren't automatically captured by Autotrack, you can use the traditional approach of writing code to collect that data. See the docs on the Precision Tracking source for more information:

Precision Tracking

Cross Domain Tracking

Our Cross-Domain Tracking feature ensures seamless user tracking across multiple domains by passing unique identifiers and other parameters from one domain to another (Freshpaint must be installed on all domains). This approach eliminates tracking gaps, enhances analytics accuracy, and supports a more comprehensive understanding of the customer journey. Click the link below to read more about Cross Domain tracking.