June 1, 2018

Tealium Universal Tag (utag.js)

• Adds support for the following new built-in variables:
  • tealium_session_number - a duplicate of the existing value in utag.data['cp.utag_main__sn']
  • tealium_session_event_number - the cookie value in utag.data['cp.utag_main__se'] that counts the number of tracking calls (utag.view(), utag.link()) in the current session (visit). This is useful for Single Page Apps (SPAs) where there is only one page load with many tracked events on that page. For pages using the noview flag, the value is ‘1’ for both page load (load rule evaluation) and the first call to utag.view().
• Adds support for an empty param list passed into utag.link, utag.view or utag.track calls. In previous versions, calls to utag.link() or utag.view() work fine, but gets an extra cfg object added to the data layer. Calls to utag.track() causes an exception in previous versions.
• For pages using noview flag, there are two things to keep in mind:
  • The data layer will have a ‘1’ value for tealium_session_event_number for both page load (utag.js uses data layer to loads in tags) and first call to utag.view (which fires tags and/or loads in more tags.)
  • Because cookies are used and initialized at page load time, if the utag.view call does not happen in time on the first page, and the page is refreshed in browser, it moves to ‘2’ for the first utag.view call which happens on second page. This is an edge case since most implementations calls utag.view immediately after utag.js executes.
• This update also includes fixes for the “OU” function used by legacy Privacy Manager Extension.
  • The OPTOUTMULTI cookie is re-checked with each call to utag.view/link (no page refresh required)
  • Tags fired directly by tag’s UID also checks the OPTOUTMULTI cookie settings before firing