Versions Compared

Old Version 1

changes.mady.by.user Yonina Spithoven

Saved on

compared with

New Version Current

changes.mady.by.user Margarita Itaj

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

We have several sources available which help you with your migration to the CMP v2.

Videos

Info

Please note that the Admin Interface has been updated since this video was created. However, the steps that you need to take to migrate have not changed.


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.

Checklist

  1. Create a support ticket https://support.usercentrics.com/hc/en-us/requests/new or contact your dedicated Customer Success Manager Executive to activate your enable the CMP v2 in the Admin Interface .

  2. Exchange the CMP script tag.

  3. Adjust tags in your tag manager (new event + “once per page”for your Configuration / Setting-ID.

    Important: After this step has been completed by the support team or your personal CSE, the Admin Interface for the CMP v2 has been activated. Please note, that this  does not automatically migrate your Usercentrics CMP to version 2. Further steps (outlined below) are needed to complete the migration on your website(s).

  4. Check your implementation for custom HTML (e.g. in the banner message).Banner Message, which was called Opt-In Message in v1) and remove it. Custom HTML is not supported with CMP v2.

  5. Adjust the styling of your CMP.

  6. Adjust the content (e.g. banner message).Optionally, . Banner Message).

  7. Exchange the Usercentrics CMP script tag. Copy & paste the CMP v2 script tag from the v2 Admin Interface and replace your CMP v1 script tag with it.

    Image Added

    (warning) Recommendation: Test in a staging environment or similar first.

    With this step of switching script tags, you should also, if applicable:

    1. Adjust tags in your tag manager (new event + “once per page”). This process for CMP v2 is documented for Google Tag Manager (GTM) specifically.
      For reference only (do not use with CMP v2): The CMP v1 GTM documentation.

    2. Optionally, only if you’re using them, also adjust:

      • API: Switch from using v1’s Javascript API to v2’s Browser UI API

      • Privacy Policy Embeddings: Switch from v1’s version to v2's version

      • Event Listener: Switch from v1’s events to v2's events

      • Privacy Link: If you’re using a Privacy Link (e.g. in the footer of your website) as your Privacy Trigger, this will need to be adjusted for CMP v2. You can get the HTML for the v2 Privacy Link in the v2 Admin Interface under Appearance → Layout tab → Privacy Trigger

Info

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

Note

Some settings in the Admin Interface (e.g. the Opt-In Message / Banner Message) apply to both version 1 and version 2 of the Usercentrics CMP. An overview of the settings is available.
If you are using the same Configuration / Setting-ID for v2 and you make changes in the Admin Interface for these settings, they are directly live on your current CMP version.

Possible next step

After your migration from v1 to v2, you can make use of v2’s Preview & Publish feature with future adjustments. It’s just one of the big improvements that come with the switch from version 1 to version 2 of the Usercentrics CMP.