Skip to content
No description, website, or topics provided.
TypeScript
Branch: master
Clone or download
tygavin Merge pull request #3 from tygavin/master
fix url to Tealium community page
Latest commit a3a4130 Apr 1, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example/src/app adding app component Mar 31, 2017
LICENSE.txt adding MIT License Mar 31, 2017
README.md fix url Mar 31, 2017

README.md

Tealium Angular Integration [Example]

  • This example shows how to implement Tealium iQ with your Angular (aka "Angular 2") App.

  • Tealium iQ is a Tag Management System (TMS) which will subsequently execute "tags" (such as Google Analytics or Adobe Analytics) with the Data Layer passed through to these vendors.

  • The service works well with the example App from Angular's CLI Quickstart: https://angular.io/docs/ts/latest/cli-quickstart.html

  • This integration should be considered an example (for now) as opposed to an Angular library on NPM.

  • If you are looking for previous integration using AngularJS, please visite http://github.com/Tealium/integration-angularjs

Summary

  • The goal of this integration is to provide a simple wrapper for the Tealium utag.track function for use in Angular. This function is used to track link clicks and content view events in your App.

  • The data layer is passed as an object of key/value pairs to these functions. The first tracking event call will also invoke asynchronous download of your client-specific utag.js file from Tealium's CDN.

  • The provider service definition is found in ./example/src/app/tealium/utag.service.ts

  • An example of how to configure and invoke the services (i.e. an example of this.tealium.track call) is found in ./example/src/app/app.component.ts

Steps to Add the Tealium Utag Service to Your App

  1. Create a "tealium" directory below ./src/app/ in your Angular App

  2. Copy the utag.service.ts file to the ./src/app/tealium/ location

  3. Use the example found in ./example/src/app/app.compontent.ts to define and invoke the tealium service in your App

  4. Be sure to replace the ##TEALIUM_ACCOUNT##, ##TEALIUM_PROFILE##, ##TEALIUM_ENVIRONMENT## values to your specific values. Typically the environment value is 'dev' or 'prod'

  5. When you want to track a content view event use this.tealium.track

  // Content Viewed event
  this.tealium.track( "view", { event_name : "prodview", my_key : "my_value", my_products_displayed : ["p1", "p2"] });

  // Button/Link Clicked event
  this.tealium.track( "link", { event_name : "filter_button", my_key : "my_value", my_filters_selected : ["f1", "f2"] });

Additional Information and Troubleshooting

  • This module defines tealium.track which is a wrapper to utag.track

  • Set the cookie document.cookie="utagdb=true" in your browser console for debugging output

  • Only a specific set of tags in Tealium's Tag Marketplace support the "link" event tracking and some (i.e. Google Analytics) will require mapping configuration

  • Visit http://tealium.com and http://community.tealiumiq.com for more details on Tealium iQ and tag-specific configuration

Set Config

The follow configuration settings are required and passed in to the 'setConfig' function

  • ##TEALIUM_ACCOUNT## (String) Tealium iQ account
  • ##TEALIUM_PROFILE## (String) Tealium iQ profile
  • ##TEALIUM_ENVIRONMENT## (String) Tealium iQ environment ("dev", "qa", "prod")
  // The example in app.component.js shows how to configure
  this.tealium.setConfig({ account: '##TEALIUM_ACCOUNT##', profile: '##TEALIUM_PROFILE##', environment: '##TEALIUM_ENVIRONMENT##' });
You can’t perform that action at this time.