Usercentrics Extension

How it works

The Tealium iQ Tag Management Usercentrics extension is used to ensure that your CMP policy is enforced at the source level, thus blocking or firing tags according to the user’s consent preferences.

Simple bookmarklet functionality is used to import the Data Processing Services JSON object text to a bookmark in your browser, which is then used to create a mapping table.

To use, add the extension, enter the required information, and then use the mapping table to map consent preferences to your tags. Using this method significantly reduces implementation time and provides an extra layer of protection by preventing tags from firing until they are mapped to a CMP service.

To prevent privacy risk exposure in instances where a tag is added without being mapped to a Usercentrics data processing service, only mapped tags fire once the extension is active.

Prerequisites

• Knowledge of your Usercentrics Implementation
  You must have knowledge of the current or planned version of your Usercentrics implementation. To obtain all of the Data Processing Services in your Consent Management Platform (CMP), follow the instructions outlined in the Usercentrics Direct Implementation Guide.
• Use a Test Environment for your First Implementation
  We recommend using a testing environment for your first implementation in order to fully access the CMP to create the mapping table within the extension. Using a testing environment ensures that no end-user data is processed prior to applying the extension in your development environment.
  Once you have completed the mapping of all data processing services to their corresponding tags, you can release it to production and Tealium iQ Tag Management will handle the enforcement of end-user privacy preferences (consent).

Requirements

• Tealium Universal Tag (utag.js), Version 4.48. For more information about updating the utag.js template, see our knowledge base article Best Practices for Updating to the Latest Version of utag.js.

• The Usercentrics CMP must load before Tealium iQ Tag Management. For this reason, you must do one of the following:

  • Implement the Usercentrics Script (tag) directly within the HTML code of your website.
    - OR -
  • Go to the Implement the Usercentrics Tag section below and follow the instructions to implement the tag within Tealium iQ Tag Management.

• Create a Data Processing Service for Tealium iQ Tag Management in your Usercentrics CMP setup.
  To learn more, see the Usercentrics documentation, Assign a data attribute. Know the name of your Data Processing Service before you begin, as it is required in the configuration steps.

Implement the Usercentrics tag

Use the following steps to implement the Usercentrics tag within Tealium iQ Tag Management using the JavaScript Code extension:

1. Go to Tealium iQ Tag Management > Extensions > Add Extension and select the JavaScript Code extension to add the script for Usercentrics V1 or Usercentrics V2.

2. Add the JavaScript Code extension.

   If you have not previously used the JavaScript Code extension and need to learn how, see JavaScript Code Extension.

3. Name the extension Usercentrics Tag, and set the scope to Pre Loader.

4. Use the script from one of the following examples to create the extension:

   • Usercentrics V1 Script: Supports Usercentrics CMP v1.

     (function(a, b, c, d) {
                 b = document;
                 c = 'script';
                 d = b.createElement(c);
                 d.src="XXXXXXXXXXX"; // URL for Usercentrics CMP Version 1 Script.
                 d.type = 'text/java' + c;
                 d.async = true;
                 d.id = 'XXXXXXXXX'; // Usercentrics Settings-ID
                 a = b.getElementsByTagName(c)[0];
                 a.parentNode.insertBefore(d, a);
             }
             )();
     

   • Usercentrics V2 Script: Supports Usercentrics CMP V2 Browser SDK

     (function(a, b, c, d) {
                 b = document;
                 c = 'script';
                 d = b.createElement(c);
                 d.src="XXXXXXXXXXX"; // URL for Usercentrics CMP Version 2 Script.
                 d.type = 'text/java' + c;
                 d.async = true;
                 d.id = 'usercentrics-cmp';
                 d.setAttribute('data-settings-id', "XXXXXXXXXXX"); // Usercentrics Settings-ID
                 a = b.getElementsByTagName(c)[0];
                 a.parentNode.insertBefore(d, a);
             }
             )();
     

5. Save and publish the JavaScript Code extension to your environment.

Create a Tealium Data Processing Service in your Usercentrics CMP

You must create a Tealium Data Processing Service in your Usercentrics account to ensure that user consent preferences are enforced and third parties can only process data if allowed to do so.

Use the following steps to create a Data Processing Service for Tealium iQ Tag Management in your Usercentrics CMP account:

1. Go to your Usercentrics account.
2. Select the most recent Data Processing template for Tealium iQ Tag Management.
3. Mark the template as Required to ensure that it cannot be opted out.
   If you customized the Tealium iQ Tag Management service name, it will not be automatically detected by the CMP extension.

In the Configuration section of this document, you will manually add the custom service name using the Service Name input field.

Configure the extension

The steps in this section describe how to add the extension, install the bookmarklet, copy the data processing services, import the data processing services, and map your tags to your data processing services.

Add the Extension

Use the following steps to add the Usercentrics extension:

1. Go to iQ Tag Management > Extensions > Add Extension and click the Privacy tab.
2. Select one of the Usercentrics extensions: Usercentrics V1 or Usercentrics V2.
   Select the version that corresponds with the version currently in use by your organization.
3. In the Title field, enter a meaningful title to be used for this extension.
   Note that the Scope field cannot be modified.
4. Enter the Settings-ID (Optional)
   Under Usercentrics Settings ID, in the Settings ID field, you can manually add your Usercentrics Settings_ID.

This step may not be needed as the Usercentrics Settings-ID is automatically added to the extension while importing the data processing services.

1. Under the Tealium iQ Service Name, in the Service Name field, enter the exact name that was given to the Tealium Data Processing Service within Usercentrics.
   

   

2. Continue to the next section to install and use the Service Mapper bookmarklet.

Install the Service Mapper bookmarklet

Use the following steps to install the bookmarklet:

1. Click the Bookmarklet button.
   The Usercentrics Service Mapper Bookmarklet dialog appears.
2. Click the Usercentrics Service Mapper link and drag and drop the bookmarklet onto the bookmark bar for your browser.
   

   

   
   The bookmarklet now displays in your browser bar.
3. Click Close to dismiss the Usercentrics Service Mapper Bookmarklet window.

Create a mapping table

Use the following steps to copy and import your data processing services to create a mapping table:

1. Open another browser tab and navigate to the Usercentrics test environment where your CMP is implemented and click the Usercentrics Service Mapper bookmarklet to launch.
   A pop-up window displays the text for your Data Processing Services JSON object.
2. Copy the entire text from this window.
3. Navigate back to the Usercentrics configuration dialog in iQ Tag Management and click the Import button.
   The Import Services dialog appears.
4. Paste the copied JSON text into the window, as shown in the following example.
   

   

5. Click Create Mapping Table.
   Your Usercentrics Settings ID and Tealium iQ Service Name are now automatically populated and the Service Mappings to your data processing services appear in a mapping table.

The mapping table must be updated each time a new tag is introduced or when your Data Processing Services with the Usercentrics configuration changes, as described in the Update the Mapping Table section of this document.

Map data processing services to tags

Use the following steps to map your data processing services to tags:

1. For each item in the mapping table, click the To UID field and use the prepopulated list to select the appropriate tag UID.
   You can map more than one tag to a data processing service.
   

   

2. The bookmarklet automatically adds a list item for Tealium iQ Tag Management and Usercentrics in the mapping table.
3. Use the trash can icon to delete the Tealium iQ Tag Management and Usercentrics services, as they are not used for consent enforcement.
4. (Optional) Click Add Service to manually add additional services and map them accordingly.
   When complete, consent is immediately enforced without the necessity of a page reload, which guarantees that end-user privacy preferences are enforced before any data processing takes place.
5. Save and Publish your changes.

Update the mapping table

The mapping table must be updated when a new tag is introduced or when your Data Processing Services within the Usercentrics setup changes. Use the bookmarklet functionality as described in the configuration steps and repeat the process to update.

The Import function identifies Data Processing Services that already exist, including any that have been recently added and those that were previously deleted, as follows:

• If the Data Processing Service already exists, mapping is not impacted.
• If the Data Processing Service was deleted, it also deletes the mapping entry.
• If the Data Processing Service is newly introduced, a new line item is added to the mapping table and you must map at least one corresponding tag.

Troubleshooting

To view typical events, log messages, and error messages that may require attention, enable console logging.

Use the following steps to enable console logging:

1. Go to JavaScript (Web) Debugging and follow the steps to add the debugging cookie.
2. After the debugging cookie is set, use the"/SENDING|\*\*\*\*/" filter to display only relevant entries.

FAQ

Can this extension be used in mobile installations?

No. Mobile installations, such as iOS and Android, do not support the Tealium iQ Tag Management Usercentrics extension.