Serenytics is a full-featured platform for creating dashboards. Generate charts and track KPIs from multiple sources, and easily share results with management and cross-functional teams.

With this integration you can use the full range of RudderStack tools to create functions, transform and filter your events on their way to the Serenytics warehouse where you can then visualize your data.

Find the open source code for this destination in this GitHub repository.

Getting started

RudderStack supports sending event data to Serenytics via the following connection modes:

Connection ModeWebMobileServer
Device mode---
Cloud modeSupportedSupportedSupported

Once you have confirmed that the source platform supports sending events to Serenytics, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Serenytics.
  2. Assign a name to your destination and click Continue.

Connection settings

To configure Serenytics as a destination, first retrieve your data storage URL from the Serenytics dashboard under the Data tab.

serenytics data storage

Then in the RudderStack dashboard, add the data storage URL to the URL fields in Connection Settings.

serenytics connection settings

Supported Calls

All RudderStack events are sent to Serenytics and stored in the Serenytics warehouse. The most common events for each RudderStack method are mapped automatically to the Serenytics naming convention. See the method-specific table below for a reference of the standard mappings.

Properties/fields that are not included in the mapping tables are passed as trait_{key_name} in the Serenytics dashboard.

For example, in this example RudderStack event:

rudderanalytics.identify(
"newUser",
{
email: "user@gmail.com",
phone: "+919876543210",
subscription: "youtube",
channelName: ["b", "d", "e", "f", "g", "h", "i", "j", "k"],
obj: {
first: "Bob",
last: "Smith",
},
}
);

The userId and email properties are mapped to user_id and email, and the remaining traits are mapped as trait_phone, etc.:

{
user_id: "newUser",
email: "user@gmail.com",
trait_phone: "+919876543210",
trait_subscription: "youtube",
trait_channelName: ["b", "d", "e", "f", "g", "h", "i", "j", "k"],
trait_obj: {
first: "Bob",
last: "Smith",
}
}

Identify

The identify call lets you uniquely identify a user and record any associated traits about them like their name, email, etc.

A sample identify call is shown below:

rudderanalytics.identify("1hKOmRA4el9Zt1WSfVJIVo4GRlm", {
likes_movies: true,
favorite_color: "purple",
age: 13
});

Event parameter mapping:

RudderStack propertySerenytics property
messageIdid
userIduser_id
context.ip
request_ip
context.ip
request_ip
firstNamefirst_name
lastNamelast_name
traits.age
context.traits.age
age
emailemail
receivedAtreceived_at
sentAtsent_at
originalTimestamporiginal_timestamp
timestamptimestamp

Track

The track call lets you capture user events along with the properties associated with them.

Event parameter mapping:

RudderStack propertySerenytics property
event
Required
event
messageIdid
anonymousIdanonymous_id
context.ip
request_ip
context_ip
receivedAtreceived_at
sentAtsent_at
originalTimestamporiginal_timestamp
timestamptimestamp
properties.priceprice
properties.currencycurrency
properties.product_idproduct_id
properties.product_nameproduct_name

Group

The group call lets you link an identified user with a group such as a company, organization, or an account, and record any traits associated with that group, for example, company name, number of employees, etc.

A sample group call is shown below:

rudderanalytics.group(
{
userId: "1hKOmRA4el9Zt1WSfVJIVo4GRlm",
likes_movies: true,
age: 25,
}
);

Event parameter mapping:

RudderStack propertySerenytics property
groupId
Required
id
context.ip
request_ip
context_ip
receivedAtreceived_at
sentAtsent_at
originalTimestamporiginal_timestamp
timestamptimestamp

Page

The page call lets you record your website's page views with any additional relevant information about the viewed page.

Event parameter mapping:

RudderStack propertyDestination property
messageIdid
anonymousIdanonymous_id
name
properties.name
name
context.ip
request_ip
context_ip
receivedAtreceived_at
sentAtsent_at
originalTimestamporiginal_timestamp
timestamptimestamp
properties.categorycategory
properties.pathpath
pageUrlurl
properties.titletitle

Screen

The screen call lets you record whenever your user views their mobile screen with any additional relevant information about the screen.

Event parameter mapping:

RudderStack propertySerenytics property
messageIdid
anonymousIdanonymous_id
name
properties.name
name
context.ip
request_ip
context_ip
receivedAtreceived_at
sentAtsent_at
originalTimestamporiginal_timestamp
timestamptimestamp
properties.categorycategory
properties.pathpath
pageUrlurl
properties.titletitle

Alias

The alias call lets you merge different identities of a known user.

Event parameter mapping:

RudderStack propertySerenytics property
userId
Required
user_id
previousId
anonymousId
previous_id
context.ip
request_ip
context_ip
receivedAtreceived_at
sentAtsent_at
originalTimestamporiginal_timestamp
timestamptimestamp

FAQ

How do I get the data storage URL?

  1. Log in to the Serenytics dashboard and click the Data tab.
  2. Click the New data source button and select the Serenytics Datawarehouse tab > Storage from the popup.
  3. From your newly-create source, retrieve the Url from the Configuration tab. Use this URL to populate your connection settings in RudderStack.

Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.

On this page