How to use Tealium with the Vega SDK

Vega Open Beta Knowledge Base
1

Overview

Tealium connects customer data across web, mobile, offline, and IoT so businesses can better connect with their customers. Tealium’s turnkey integration ecosystem supports more than 1,300 built-in connections, empowering brands to create a complete and real-time customer data infrastructure.

Tealium’s solutions include a customer data platform with machine learning, tag management, an API hub, and data management solutions that make customer data more valuable, actionable, privacy-compliant, and secure. More than 1,000 leading businesses throughout the world trust Tealium to power their customer data strategies.

The latest versions of our NPM packages bring the power of Tealium’s real-time CDP and data collection products to Vega!

One SDK to Rule Them All!

Tealium can save a lot of time for developers by providing a single SDK that sends data to multiple vendors in real-time, even if the vendor doesn’t yet support Vega. Your first-party data can also be used to power hyper-personalized real-time customer experiences directly in the Tealium platform.

How do I use it?

We constantly update documentation for all of our integrations. You can read more on the latest documentation available about our NPM packages which we conveniently updated to support Vega too.

Install

To install the Tealium Collect module for Node.js with NPM, run the following command:

npm install tealium-collect

The install automatically includes the dependency module tealium.

Initialize

Import the modules:

var Tealium = require('tealium');
var tealiumCollect = require('tealium-collect');

Initialize the Tealium instance with the Tealium() constructor method:

var config = {
      "account"    : "ACCOUNT",
      "profile"    : "PROFILE",
      "datasource" : "DATASOURCE"
};
var tealium = Tealium(config);

Call the addModule() method to add the Tealium Collect module :

tealium.addModule(tealiumCollect);

Track

The only thing needed to leverage the full potential of Tealium is to track the data that will be used on the Server Side. Nothing else is required for the developer.

Track Events / Views

The track() method tracks all events and page views, as shown in the following example:

tealium.track("EVENT_NAME", {"KEY": "VALUE"});

Track Visitors

If your application tracks user activity and you want to associate events with a visitor, include the tealium_visitor_id attribute in the data object of each track call as shown in the following example:

var myVisitorId = myVisitorIdFunction();

tealium.track("page_view", {
    "tealium_visitor_id" : myVisitorId,
    "some_key"           : "KEY"
});

This event attribute uniquely identifies the current user so make sure to use a unique identifier (e.g. a UUID) for each user and keep it constant across launches.
Other identifiers, such as a hashed email address, can also be used to identify the user across devices.
Read more about identifiers and visitor stitching here.

Limitations

This integration is an MVP and can be used for a quick integration with the Tealium CDP. More features may be added in future based on customer feedback. Please get in touch if you have any suggestions.
Consent, as an example, is not included in this first iteration.

Customers using this integration will need to make sure they have user’s consent before calling the track method.

Support

For any support queries, feature requests or bug reports, please reply to this thread.

Enrico Zannini
Senior Software Engineer @ Tealium

Vega Supported Libraries and Services