September 1, 2023

Tealium Universal Tag (utag.js)

Version 4.50 provides more transparency and control over cookies written by utag.js.

Previously, we recommended using multi-value cookies (multicookies). However, due to the increasing demand for transparency and simplicity, particularly for data privacy audits, we have revised our recommendation. Now, we advise using standalone cookies, which is now the default behavior in utag.js.

This release includes the following updates:

• Writes separate utag_main cookies instead of a single multi-value cookie. To use the legacy behavior that stores multiple values in a single cookie, set split_cookie to false.
• Moves responsibility for utag_main_v_id from utag.js to the Tealium Collect tag. To force utag.js to set the utag_main_v_id cookie, set always_set_v_id to true.
• Adds a new id element in the Consent Manager cookie for logging consent. When this cookie is first set, it will match any utag_main_v_id values found, after which it won’t be changed. That behavior prioritizes maintaining the link between the user and the logged events, but means that a match isn’t guaranteed in all cases.
• Can easily be upgraded by updating the relevant templates.
• Adds the following utag settings:
  • split_cookie - Set to false to use the legacy single multi-value cookie.
  • split_cookie_allowlist - Specifies an array cookie names that can be set using the utag_main namespace.
  • always_set_v_id - Forces utag.js to set the utag_main_v_id cookie or the v_id component of utag_main.
• Updates the following templates:
  • utag.js (loader) to version 4.50, to update cookie behavior
  • cmGeneral to version 3.0.12, to add centralized logic for generating or retrieving a device ID that can be called from consent logging templates
  • cmDoNotSell to version 1.4.0, to call the centralized logic
  • fullConsentEventHandler to version 1.0.3, to call the centralized logic
  • partialConsentEventHandler to version 1.0.3, to call the centralized logic
  • Collect to version tv:20064.20230519 (released in May 2023)

For more information about the new settings for enhanced transparency in utag 4.50 or later, see Enhancing Cookie Transparency with utag 4.51.

Tealium for Android (Kotlin)

• Fix: ProGuard adjustment resolve missing BatchDispatch$Companion class.
• Minor lint warning fixes

Client-side tags

Updates and fixes

• Updated the Adobe Experience Platform Web SDK tag with the following:
  • Renamed edgeConfigId to datastreamId.
  • Updated the webPageDetails and webInteraction attributes to camel case.
  • Added the setConsent event.
  • Updated defaultConsent default value logic: If a setConsent event is mapped, defaultConsent is set to pending to queue pending events; if not mapped, defaultConsent is set to in, while retaining the option to map the defaultConsent variable.
  • Updated tooltip to version 2.18.0.
  • Added an Adobe Analytics migration guide to the documentation.
• Updated the Criteo OneTag tag to support multiple account IDs.
• Updated the Epsilon Site tag to fix issues with query parameter and update mappings based on the vendor’s requirements.
• Updated the tags summary section under the Extensions tab for tags to display related extensions.
• Updated the PulsePoint HCP365 Pixel tag to pre-populate default values in the following fields during pixel setup:
  • us_privacy
  • url
  • rr
• Updated the Simpli.fi tag and logo.
• Deprecated the following tags:
  • Avazu tag
  • Adknowledge tag
  • AffiliateTraction tag
  • AdReady tag
  • Ask tag
  • Amadesa tag
  • AudienceScience tag
• Updated the Twitter Pixel tag to add conversion_id to the tag request.

Consent Integrations

New/Cool Stuff

• Add support for multiple purpose mappings per tag.
• Updated the Consent Integrations template utcm_framework to version 1.1.0, which includes:
  • Improved console logging in debug mode when no enforcement rule applies from a purpose group.
  • Support for multiple purpose mappings per tag.
• Updated the purpose groups slide-out with the ability to add or edit rules within an enforcement rule.

Fixes

• Added an option to clear the Tealium iQ purpose mapping in Consent Integrations purpose groups.
• Fixed an issue with merge history that previously caused garbled messages.

Client-side consent management

Updates and fixes

• Updated event logging to use a new dedicated id parameter in the CONSENTMGR cookie (with support for custom namespaces), instead of using the utag_main_v_id.

  The following templates have been updated to support this update:

  • cmGeneral has been updated to version 3.0.12 to add centralized logic for generating consent forms ID that can be called from consent logging templates.
  • cmDoNotSell has been updated to version 1.4.0 to call the centralized logic.
  • fullConsentEventHandler has been updated to version 1.0.3 to call the centralized logic.
  • partialConsentEventHandler has been updated to version 1.0.3 to call the centralized logic.

  For more information about this change and related changes to utag.js, see the release notes for version 4.50.

Server-side connectors

New connectors

• New marketplace connector: Amazon Ads Audience Management connector

Updates and fixes

• Updated Amazon Ads Audience Management connector with the following:
  • Added new component amazon_audience_field.jsx.
  • Updated Advertiser ID.
• Updated the conversion name flow and added country code to the Amazon Ads Conversions connector.
• Updated the Pinterest Audiences connector to add a Test Connection button.
• Updated the following connectors to use Facebook version 17:
  • Facebook App Events connector
  • Facebook Audiences connector
  • Facebook Audiences connector (Customer-Provided Credentials)
  • Facebook Conversions connector
  • Facebook Messenger connector
• Updated the LaunchDarkly Metric Import API connector to add two different domains, Commercial and Federal. The default domain is Commercial.
• Updated the Quantcast Audiences connector to support new authentication flow.
• Fixed Limited Server-Side Request Forgery (SSRF) vulnerability in all connectors with the Test Connection button.
• Updated connector configuration screen to allow multiple row functionality.

Data sources

Updates

• Updated the file import sample file upload and column mapping tools to enforce a limit of 1,000 columns.

DataAccess

New/Cool Stuff

• Redesigned the AudienceDB screen to make it easier to browse and filter the attributes and audiences that are stored in the database.
• Added a button to easily copy connection credentials for the EventStore, AudienceStore, EventDB, and AudienceDB screens.