What are Events?

Any action your customers perform on your website, product, or app is an event. For example, in a customer journey where they get an email about a sale which ends with them making the purchase and completing the feedback survey, you can define the following events: opening emails, any clicks within emails, clicking buttons on your site, adding the products to a wishlist or a cart, making the purchase, and submitting a form.

Whenever an event occurs, an attribute will be attached to these events, giving more context. For example,

• what device were they using
• what operating system were they using
• when did the event happen
• what time and timezone were they in

You can also collect specific information to understand your customers better. With this understanding, you can offer personalized content relatable to them with better segmentation in future customer journeys.

What are custom events?

There are two types of events that are captured.

• Default events: Default events are captured automatically, such as customer email
• Custom events: Custom events are not captured automatically but need to be set up specifically for your use cases, such as cart abandonment, along with the attributes, such as product URLs, categories, and more.

Note: This process of tracking events on your website or your webapp requires some level of understanding in platforms such as Java, JS, Android & IOS, Webapps, etc.

Please proceed if you are comfortable with technical terminologies, if not, please work with your developers.

Defining Events

Before you begin, we recommend you note down all the different events you would like to track along with their attributes & Datatypes. You cannot change the datatypes that you define. Make sure of your definitions before starting. Similarly, data will not be recorded in customer journeys if the datatype received is not the same as it was defined in the beginning.

Here is a list of base attributes for your reference. These base attributes will be captured automatically whenever an event occurs on your webpage/web apps. Users cannot modify or edit these attributes in any way.

Base attributes (Table 1)

System events and Custom events

System Events

System events are automatically captured and are added alongside all the events performed by the user in the Journey workflow. Bulk campaigns also will be captured. System events can be categorized into these four categories:

1. Email Events 
2. Journey Events
3. Web Events 
4. Form Events

1. Email Events

Table 1.1

Email events attributes

Email event attributes are captured as part of the email events (listed in Table 1.1). These are saved along with any other attributes that are captured (listed in Table 1)

Table 1.2

2. Journey Events

Table 2.1

Journey event attributes

Journey event attributes are captured as part of the journey events (listed in Table 2.1). These are saved along with any other attributes that are captured (listed in Table 1)

Table 2.2

3. Web Events

Table 3.1

Web event attributes

Web event attributes are captured as part of the journey events (listed in Table 3.1). These are saved along with any other attributes that are captured (listed in Table 1)

Table 3.2

4. Form Events

Note: The above API will not create a contact if it is not already present in your account.

curl -XPOST -H "fm-token:jrr3g04b0atvta4tmghbguhgugvd03r9n8v7eon7mv1b7qa" 'http://<domain>.freshmarketer.com/mas/api/v1/contacts/associate-visitor' -d '{"visitor_id": "1564408766806r0.8685208684454182", "email": "johnny.depp@hollywood.com"}'

Note: The above API will create a contact if it is not already present in your account.

Custom Events API

• Frontend API

FM.trackCustomEvent("Added to cart",
{
"email": "david.thompson@sample.com",
"price": 100.21,
"currency": "USD",
"is_mobile_transaction": true,
"return date": "2019-12-30"
});

• Rest API

curl -XPOST 'https://<domain>.freshmarketer.com/mas/api/v1/events?email=david@aws.com&event_name=signup_from_social' -d'{"price": 1000, "currency": "USD", "product-name": "Amazon Fire Stick", "user_id": "1010303"}' -H "Content-Type: application/json"

curl -XPOST 'https://<domain>.freshmarketer.com/mas/api/v1/events?email=david@aws.com&event_name=signup_from_social' -d'{"price": 1000, "currency": "USD", "product-name": "Amazon Fire Stick", "user_id": "1010303"}' -H "Content-Type: application/json"

Date formats supported:

1. "yyyy-MM-dd";

2. "yyyy-MM-dd HH:mm:ssZ";

3. "yyyy-MM-dd HH:mm:ss.SSS z";

4. "yyyy-MM-dd HH:mm:ss.SSS";

Custom Events attributes