# Events

# Overview

Events track what individual actions users perform in your app or website. Some examples of events include a user launching an app, viewing a product, signing in, sharing a photo, making a purchase. Events are recorded by a tracker and can be used to define segments.

# Types of Events

Events are organized by type into collections. Events have properties, key-value pairs that record relevant information about the event.

For example, a user clicks on a link:

  • The click is an event

  • It belongs to the clicks collection (HTML field)

  • The properties of the event include the time of the click, the id and other HTML attributes of the element that was clicked, the URL of the page on which the click happened

# Custom Collections

Custom collections allow you to bring specific customer data into your event collections. Custom events are not auto-created so you need to specifically define and pass each custom event parameters and their collections from your sources.

Depending on the type of business, these events could be anything like:

  • Product Page Viewed
  • Product Added to Cart
  • Subscribed to Newsletter
  • Checkout Started | Checkout Completed
  • Review Submitted

# Creating an Event

To create an event, select Data -> Events, and click “Create Event”.

img

Enter the name of the event and select the data source, which you have created.

img

Select an event type and a corresponding property.

img

Click on the plus symbol to add event filter (group)

img

# Event formula

Event formula dinamically displays the event definition. Letters in blue color shows that these filters (e.g. A and B) are in the brackets and must be prioritized in the formula. In the example below, the event would be only valid if a group of A and B OR a group of C and D event filters are triggered.

img

# Event formula operators

Operators in the event editor allow you to define your events by using complex conditions. By clicking on "and"/"or" operators, you can specify how each event filter relates to the other. For example, if you have created a "pageview" type event, you can select "Geo" and "Page" as two filters that define your event. By selecting an operator and establish a relation, that event will only be valid once both conditions are true (visiting the page and visitor being from Los Angeles). If you select the operator "or" it would mean that event would be true if any of the filter conditions will be met.

img

# Event filter operators

Events have different filters based on the filter object type. You should enter event filter value based on the event filter operator type.

String object type operators:

  • equals - value nust be exactly the same
  • is defined - value must exist (not null)
  • contains - at least a fragment must match

img

Integer object type operators:

  • equals
  • does not equal
  • greater than
  • greater than or equal
  • less than or equal
  • less than

img

# Event Relations

Usually events do not appear in isolation. Events have their own action pairs which are called event relations. For example, interaction event always happen in particular page, so it has a page view relation. In iOS devices interaction event appears in relation to "scene" elements. It is not required to set event relations for every event, however, this helps to increase event precision (e.g. defining page URL of the interaction event).

# Example Event

Let’s create an event named “myEvent”, which has a custom collection “Flight-Booking-Event” (collection data that holds all the data related to flight bookings in the website).

img

Step Element Value
1 Source Web tracker
2 Event type "Clicks"
3 Event property HTML Element
4 Event property filter Path
5 Filter operator Contains /pricing
6 Formula operator AND
7 Event property Geo
8 Event property filter Country
9 Filter operator equals USA

# Sample Event Templates

Event Description Example Event type Property String
Searched Track search for a product Keyword: Samsung Galaxy Page with path /catalogsearch/result Query contains q=Samsung+Galaxy
Product viewed Track viewed products Product: WH-1000XM3 headphones Visit of a view with path N/A /headband-headphones/wh-1000xm3
Category Viewed Track browsed categories Category: Smart Watches Visit of a view with path N/A /catalog/smart-watches
Added to Wishlist Track if product is added to a wishlist for future purchase Product: iPhone XS Interaction [and] Visit of a view with path HTML -> Class name [and] N/A “action towishlist” [and] /catalog/iphone-xs
Product Reviewed Track review of the product Product: UE Boom 3 Speaker Interaction [and] Visit of a view with path HTML -> Class name [and] N/A “action submit review” [and] /speakers/ue-boom
Added to Cart Item added to cart Product: Panasonic GH5S Camera Interaction [and] Visit of a view with path HTML -> Class name [and] N/A “action primary tocart” [and] /cameras/panasonic-gh5s
Coupon Used Track if coupon code is used to complete the purchase Offer: 20% off all mobile phones; Coupon Code: DISCOUNT20 Interaction [and] Interaction HTML -> Value [and] Type “apply discount” [and]“DISCOUNT20”
Purchase Track successful purchase Name: Xootr Cruz Scooter Custom event collection {Purchase} [and] Page Equals [and] Title 1 [and] “Xootr Cruz Scooter”