@useblu/blu-lytics NPM

How it works

Main goals include: being the sole entry point, simplifying integration between monitoring tools, and enabling centralized sending of messages and events. These goals offer developers the following benefits:

Unified messages and events Allows messages and events to be propagated across all monitoring tools through a single entry point.
Centralized and simplified configuration (Zero config) Enables initializing tools by providing only their key or token, without the need for prior configuration, saving time and reducing code.
Scalability Facilitates the removal or addition of a tool, as the library contains all necessary configuration for operation. Flexibility that enhances the efficiency of monitoring tool management.

Installation

yarn add @useblu/blu-lytics

npm i @useblu/blu-lytics

Usage

Importing Library

Destructuring the import

import { initializeProviders } from 'blu-lytics';

Importing all functionalities

import * as blu-lytics from 'blu-lytics';

Method: `initializeProviders`

This method simplifies the connection to one or more monitoring tools, eliminating the need for pre-configurations. Simply provide the name of the tool to be used and its API key 'apiKey'.

To establish a connection with a single tool, it is necessary to pass an object as a parameter, containing the fields providerName, apiKey, and another object with the environment (the latter is optional, with the default value being 'production').

initializeProviders({providerName: 'track-tool-name', apiKey: 'your-api-key'}, {environment: 'development'});

To connect to more than one tool, it is necessary to pass an array (list) of objects as a parameter, maintaining the fields providerName, apiKey, and another object containing environment (optional).

initializeProviders([
    { providerName: 'track-tool-name', apiKey: 'your-api-key'},
    { providerName: 'another-track-tool-name', apiKey: 'your-api-key'}
], {environment: 'development'});

Method: `sendScreenEvent`

This method sends a message that will be propagated and recorded in all tools that have been previously initialized through the initializeProviders method. To use it, only a string needs to be provided as a parameter.

sendScreenEvent('page_view');

Method: `sendCustomEvent`

This method sends an event with a message and additional optional parameters, which will be propagated and recorded in all tools that have been previously initialized through the initializeProviders method.

To use it, two parameters need to be provided: a string to describe the event and an object containing the additional optional fields.

sendCustomEvent('your_custom_page', {
    props1: 'any-information',
    props2: true,
  });

Method: `sendUserIdentification`

This method sends relevant information related to user identification, such as their name, email, and ID, for example.

To use, it is possible to provide two parameters: a string representing a unique identifier and an object containing additional and optional fields.

sendUserIdentification('user-id', {
    name: 'user name',
    email: 'user@email.com',
  });

Supported tracking tools

Sentry
Fullstory
Mixpanel

Incoming Updates

- Suport for Microsoft Clarity

Contributing

Whether you're helping us fix bugs, improve the docs, or spread the word, we'd love to have you as part of this project! Read below to learn how you can take part of it.

Code of Conduct

We adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.