Home Resources Articles Browser UI – How to migrate from Consent Management Platform v1 to v2

Browser UI – How to migrate from Consent Management Platform v1 to v2

Ongoing optimizations and great new features of our CMP are in version 2. We’ve answered common questions about migrating.

by Usercentrics

Nov 6, 2021

Table of contents

Show more Show less

Book a demo

Learn how our consent management solution can improve privacy and user experience for your users.

Book now

Get your free data privacy audit now!

Version 2 of Usercentrics Consent Management Platform (CMP) brings a wide variety of optimizations and new features, and our team is always hard at work adding more. Get even more functionality and flexibility to build user trust and optimize your key KPIs.

The following FAQ addresses the migration from CMP v1 to CMP v2 to help your company make the change smoothly. Contact our support team or your Customer Success Manager with any questions and begin your migration to CMP v2.

General

What benefits can I expect from migrating to CMP v2?

Version 2 of Usercentrics’ Consent Management Platform comes with a lot of enhancements, many of them are only available in v2. Some of these include:

Substantially reduced file size and faster loading times
Performance optimized UI
WCAG 2.1 AA web accessibility certification
Cross-device Consent Sharing
Advanced Analytics Dashboard and Reporting
A/B Testing
Self-programmable UI and CMP behavior with Browser SDK
Multi-configuration Bulk Editing
Preview & Publish functionality

There is not a set date yet, but customers will be notified well in advance. It is also important to note that new features will only be added to v2.

Do I need CMP v2 to be able to use the CMP with the In-App SDK?

Yes, our App SDK is configured in the v2 Admin Interface, and will not work in v1. We recommend v2 in combination with the App SDK to guarantee a seamless user experience on websites, apps and games, e.g. for features like Cross-Device Consent Sharing.

Yes, because TCF 2.0 was not yet available with v1, it’s only included with v2, so that’s the only version that can enable TCF 2.0-compliant consent.

Implementation

Does the CMP v2 need to be activated in my account?

Yes, the CMP v2 needs to be activated by Usercentrics for each Settings ID. In order to do so, please contact us via the ticketing system or email your Customer Success Manager. Once activated, you can switch to the new CMP v2 in the Admin Interface.

Are there instructions for the migration and/or the implementation of CMP v2?

We also have video guides for migration:

To give you a quick overview of the migration process, here’s a handy checklist. Full details are in our videos or the linked documentation), here’s a handy checklist:

Checklist

Create a ticket or contact your Customer Success Manager to activate your CMP v2 in the Admin Interface.
Exchange the CMP script tag.
Adjust tags in your tag manager (new event + “once per page”).
Check your implementation for custom HTML (e.g. in the banner message).
Adjust the styling of your CMP.
Adjust the content (e.g. banner message).
Optionally, also adjust:
- API
- HTML Embeddings
- Event Listener
- Privacy Link

Note: Consents will be transferred automatically if the same Settings ID is being used in the script tag.

Do I have to start a new implementation when migrating to CMP v2?

To migrate to CMP v2, please replace the current Usercentrics script with the new script, which you can find in your Usercentrics Admin Interface.

If you integrate Data Processing Services using the Google Tag Manager, please adjust your tags’ existing variables and triggers: Google Tag Manager configuration for CMP v2

If you use the following, they will also need to be changed, as they differ between v1 and v2:

API
HTML Embeddings
Event Listener
Privacy Link

Nothing will change for Data Processing Services that you have integrated directly into your source code. These can still be adjusted: Direct integration of the Usercentrics CMP into your website

Will existing stored consents from v1 be transferred to v2?

Provided that the Settings ID remains the same, previously obtained consents can be transferred over to v2. There is a script integrated in v2 that adjusts the local storage from v1 to v2.

Important:

v2 is not backwards compatible, so converting consents from v2 to v1 is not possible.

Will there be an API interface in CMP v2?

Yes. The available functions can be found in our Browser UI API documentation.

Our partners Comspace GmbH or TWT Digital Group GmbH will be glad to assist you with the implementation.

User Interface and Configuration

Where can I see an example of the browser UI in action?

It’s in use right on the Usercentrics website.

What are the customization options for v2?

The following customizations can be made directly in the Admin Interface:

Logo
Brand color
Font
Layout (banner or wall)
Categories in the first layer
Deny button: Yes or No
Privacy Settings: various options
Privacy Trigger: various options

Check the Admin Interface for v2 for further customization options.

Customers using the Browser SDK can completely customize their CMP’s user interface.

Yes, by using the Browser SDK and self-programmable UI you can customize all aspects of appearance and messaging. Learn about how that works in our Browser SDK documentation.

How time or resource intensive is creating a customized UI?

That depends entirely on what you want to implement. We would be glad to put you in touch with one of our partners to get an initial cost estimate. Feel free to contact our partners Comspace GmbH or TWT Digital Group GmbH. Our support team can also address some questions, though they cannot assist with implementation.

Can I customize the UI in the Admin Interface?

Yes, we offer extensive customization features for the v2 CMP, which can be accessed (and previewed) in the Admin Interface.

Is Custom CSS available in CMP v2?

Custom CSS is only available for Premium plans. Please note that any CSS updates made by the customer are done at the customer’s own risk. We cannot support CSS troubleshooting.

The Browser UI is not customizable enough. Can Usercentrics help us develop our own UIs?

Usercentrics’ partners are happy to assist you with custom development. You can contact them at Comspace GmbH or TWT Digital Group GmbH.

Can I copy existing custom Data Processing Services directly from a v1 Settings ID to a different v2 Settings ID?

This is possible with our Bulk Editing feature, which is available in our Premium Plans.

Features

What features are currently available in v2?

Cross-Device & Cross-Domain Sharing
GDPR, CCPA/CPRA, VCDPA, CTDPA, UCPA,CPA, POPIA and TCF v2.0 support
UI customization
WCAG 2.1 AA Web Accessibility Certification
New Analytics dashboard and A/B Testing
Preview & Publish functionality
and more!

Can I preview the UI in the Admin Interface like in v1?

In the CMP v2 we have an improved version of the preview function. Our new “Preview & Publish” feature enables you to save changes made in the Usercentrics Admin Interface to a draft version before publishing them to the live version of your CMP. More information on how to use this feature can be found in our Technical Documentation.

How will reporting work in v2?

We revamped our Analytics Dashboard, and in the CMP v2 you will be able to obtain very detailed insights into your users’ consent decisions, including how they interact with the CMP and overall opt-in rates. You will also be able to conduct A/B Testing directly in Usercentrics. Learn more about the improved Interaction Analytics and Granular Analytics.

Yes, sharing custom DPS among multiple Settings IDs is possible with the Enterprise and Premium Plans.

Can I make batch edits in v2 for various Settings IDs?

That function is available for Enterprise and Premium customers upon request to their Customer Success Manager.

To learn more, we welcome you to get in touch to chat with one of our experts or schedule a demo.