• Overview
• Getting started with the Tracking Package
• Constructing the Event Object
• Types of events
• Event Object Parameters
• How to populate the actionLabel parameter
• Examples
• Testing the Tracking Implementation
• FAQ

The Tracking Package enables you to measure views and engagement across your applications. This documentation provides implementation instructions and reference materials geared towards a developer audience.

To track a new application, developers construct an event object for each event they wish to track and utilize this npm package to send the event. Once sent, the tracking package formats each event object according to the specifications outlined in the emDataStandards and pushes it to a dataLayer object. Subsequently, both customers and EveryMundo have the ability to leverage a tag manager to access the data layer values and transmit events to an Analytics account.

Follow these simple steps to quickly integrate the Tracking Package into your project for seamless event tracking.

Step 1: Download the npm Package

Install @everymundo/airmodules-event-datalayer by using npm. Open your terminal and run:

npm install @everymundo/airmodules-event-datalayer

Step 2: Import the Formatter Function into the Project

In your project file where you plan to implement event tracking, import the formatter function. Add the following line at the top of your file:

import { formatter } from "@everymundo/airmodules-event-datalayer"

Step 3: Construct the Event Object Based on Vertical

Create an event object that captures the relevant information for the specific event you want to track. Ensure that the object follows the required structure and contains essential details related to the event. Refer to the details below for more information.

Note: For fields that contain additional details, such as passenger, guest, or lodging information, the appropriate format is a single object, not an array of objects. If an array is provided, the package will automatically convert it into an object within the data layer.

const eventObject = {
  event: 'viewable_impression',
  module: 'em-booking-mask',
  actionLabel: '',
  originAirportIataCode: 'CMB',
  destinationAirportIataCode: 'SIN',
  currencyCode: 'LKR',
  totalPrice: 5.21,
  totalPriceUSD: '',
  departureDate: '2021-03-13',
  returnDate: '2021-06-14',
  deeplinkSiteEdition: '',
  miles: '',
  timestamp: '2021-02-16T00:00:00.000Z',
  url: 'https://www.srilankan.com/en-lk/',
  passenger: {
    count: 1,
    adultCount: 1,
    youngAdultCount: '',
    childCount: '',
    infantInLapCount: '',
    infantInSeatCount: '',
    overseasFilipinoWorker:  ''
  },
  lodging: {
    cityCode: 'SIN',
    name: 'Intercontinental',
    startDate: '2021-03-13',
    endDate: '2021-03-20',
    roomCount: 2,
    tripLength: 7,
    starRating: 5
  },
  carRentals: {
    provider: 'Hertz',
    brand: 'BMW',
    model: '530i'
  },
  moduleId: '',
  tagName: ''
}

Step 4: Call the Function Based on Vertical

After constructing the event tracking object, use the appropriate function based on the tenant type (vertical) to format and process the event. Pass the event object as the parameter to ensure accurate tracking.

// For Vertical Airlines
formatter.formatAirlines(eventObject);

// For Vertical Hospitality
formatter.formatHotels(eventObject);

// For Vertical Events
formatter.formatEvents(eventObject);

These functions are designed to handle specific verticals and ensure proper formatting of the event object. Here's a brief explanation of the process:

• Handling Missing Fields: If the event object is missing values for certain keys, the respective keys will be assigned empty values during the formatting process.

• Handling Null Values: Null values in the event object will be converted to an empty string during the formatting process.

• Handling Multiple Values: If 'eventExperience' contains multiple values (e.g., "The Lounge," "Player Pod"), the function will format them to "MULTIPLE."

• Pushing to the dataLayer: After formatting, the resulting data will be pushed to the dataLayer, making it ready for further processing and analysis by analytics tools.

• Handling Nested Fields: Nested fields should not be sent in the form of "Array of Objects" [{}] (e.g., ❌ page[0].typeName -> ✅ page.typeName). Fields that do not adhere to the standard dataLayer structure will be discarded.

Ensure you choose the correct function based on your application's vertical to maintain consistency in data formatting and tracking. Customize the event object and parameters as needed for your specific tracking requirements.

Events let you measure user interactions on your app; for example, you can measure when someone, clicks on a button or interacts with a filter. The data from events is used to create reports.

Step 1: Select the Empty Event Object by Vertical

Identify the appropriate empty event object template based on the vertical or category of the event you intend to track. Different verticals may require specific information to be captured.

const eventObject = {
  event: '',
  module: '',
  actionLabel: '',
  originAirportIataCode: '',
  originCountryCode: '',
  destinationAirportIataCode: '',
  destinationCountryCode: '',
  currencyCode: '',
  totalPrice: 0,
  totalPriceUSD: '',
  departureDate: '',
  returnDate: '',
  deeplinkSiteEdition: '',
  miles: '',
  passenger: {
    count: 1,
    adultCount: 1,
    youngAdultCount: '',
    childCount: '',
    infantInLapCount: '',
    infantInSeatCount: '',
    overseasFilipinoWorker:  ''
  },
  lodging: {
    cityCode: '',
    name: '',
    startDate: '',
    endDate: '',
    roomCount: 0,
    tripLength: 0,
    starRating: 0
  },
  carRentals: {
    provider: '',
    brand: '',
    model: ''
  },
  moduleId: '',
  tagName: ''
}

const eventObject = {
  event: '',
  module: '',
  actionLabel: '',
  currencyCode: '',
  totalPrice: 0,
  totalPriceUSD: 0,
  startDate: '',
  endDate: '',
  roomAccesibility: true,
  guest: {
    count: 0,
    adultCount: 0
  },
  room: {
    count: 0,
    type: ''
  },
}

const eventObject = {
  event: '',
  module: '',
  actionLabel: '',
  currencyCode: '',
  totalPrice: 0,
  totalPriceUSD: 0,
  startDate: '',
  endDate: '',
  roomAccesibility: true,
  guest: {
    count: 0,
    adultCount: 0
  },
  room: {
    count: 0,
    type: ''
  },
}

Step 2: Decide Which Events to Track in the 'event' Field

Determine the key event you want to track and assign them to the 'event' field. This field defines the type of user interaction and the specific action taken. For example:

const eventObject = {
  event: 'viewable_impression',
  module: 'em-booking-mask',
  ...
};

Adjust the value of 'event' to accurately reflect the nature of your tracked events. Refer to Types of Events below for more information.

Step 3: Set Up Event Parameters

The event object includes several parameters to provide detailed context to a specific event for better analysis. For instance:

const eventObject = {
  event: 'viewable_impression',
  module: 'em-booking-mask',
  actionLabel: '',
  originAirportIataCode: 'CMB',
  destinationAirportIataCode: 'SIN',
  currencyCode: 'LKR',
  totalPrice: 5.21,
  ...
};

Refer to Event Object Parameters below for a detailed explanation of each parameter, and which ones are required.

Note: Automatically Collected and Recommended Events

Automatically collected events are events that are collected by default. These events include:

• Pageviews: A pageview is recorded when a user loads a new page.
• Viewable impressions: A viewable impression is recorded when a module is displayed on the user's screen.

Recommended events are events that you implement, but that have predefined names and parameters. These events unlock existing and future reporting possibilities. The following is a list of recommended events that you can track using the tracking package:

Custom events are events that you define. Make sure to only create custom events when no other events work for your use case. Custom events do not show up in most standard reports and require a custom request for meaningful analysis. (we give guidelines in case nothing on our list is appropriate)

To track a custom event, simply add in the event object an event name and/or module name that is not on the recommended list.

The event object must contain the following properties:

• event: The name of the event.
• module: The name of the module.

For example, the following event object would track a custom event called "product_detail_clicked" for a new module:

const eventObject = {
  event: 'product_detail_clicked',
  module: '',
  ...
}

Note: Guidelines for Tracking Custom Events

When tracking custom events, it is important to follow these guidelines:

• Use descriptive event names. This will help you to easily identify and analyze your event data.
• Avoid tracking too many custom events. This can make your event data difficult to analyze.
• Only track custom events that are important to your business. This will help you to focus on the most important events and to get the most out of your tracking data.

This section provides a detailed explanation of the parameters used in the event object, along with their examples, definitions, and whether they are required.

• The parameters marked as required need to be included in all events.

• The viewable-impression events will only collect the required parameters when it has the asterisk after “Yes“.

• The interaction events, such as select-departure-date, will only populate the relevant parameters to the event itself and what has already been filtered in the module.

• Parameters that are not being used can be removed from the event object.

The 'actionLabel' serves as a descriptive label, tracking what was specifically selected based on the event. For instance, when the event is 'select-interest,' the 'actionLabel' might capture values like 'snorkeling.'

• Note that for select-destination and select-departure-date the values will also have to be included in the relevant event object parameters.

const eventObject = {
  event: 'viewable_impression',
  module: 'em-booking-mask',
  actionLabel: '',
  originAirportIataCode: 'MAD',
  originCountryCode: 'ES'
  destinationAirportIataCode: 'MIA',
  destinationCountryCode: 'US'
  currencyCode: 'LKR',
  totalPrice: 5.21,
  totalPriceUSD: '',
  departureDate: '2021-03-13',
  returnDate: '2021-06-14',
  deeplinkSiteEdition: '',
  miles: '',
  timestamp: '2021-02-16T00:00:00.000Z',
  url: 'https://www.srilankan.com/en-lk/',
  passenger: {
    count: 1,
    adultCount: 1,
    youngAdultCount: '',
    childCount: '',
    infantInLapCount: '',
    infantInSeatCount: ''
  },
  lodging: {
    cityCode: 'SIN',
    name: 'Intercontinental',
    startDate: '2021-03-13',
    endDate: '2021-03-20',
    roomCount: 2,
    tripLength: 7,
    starRating: 5
  },
  carRentals: {
    provider: 'Hertz',
    brand: 'BMW',
    model: '530i'
  },
  moduleId: '',
  tagName: '',
}

const eventObject = {
  event: 'viewable_impression',
  module: 'em-booking-mask-abstract',
  actionLabel: '',
  currencyCode: 'USD',
  totalPrice: 900.55,
  totalPriceUSD: 900.55,
  startDate: '2022-04-01',
  endDate: '2022-04-07',
  roomAccesibility: true,
  timestamp: '2021-02-16T17:41:43.200Z',
  url: 'https://www.hyatt.com/en/miami',
  guest: {
    count: 1,
    adult: 1
  },
  room: {
    count: 1,
    type: ''
  }
}

const eventObject = {
  event: 'search_initiation',
  module: 'em-booking-mask-abstract',
  actionLabel: null,
  currencyCode: 'LKR',
  totalPrice: null,
  totalPriceUSD: null,
  startDate:

 '2021-03-13',
  endDate: '2021-03-14',
  timestamp: '2021-02-16T17:41:43.200Z',
  url: 'https://www.srilankan.com/en-lk/',
  passenger: {
    count: 1,
    adultCount: 1,
    youngAdultCount: null,
    childCount: null
  }
}

Note: Tracking Implementation Options

Understand that legacy modules may employ the Tracking Library (TL), Tracking Package (TP), or both in their implementation. The focus should be on having an "airmodule" data layer for each user interaction, ensuring events are collected in Google Analytics 4 (GA4).