ADOBE LAUNCH EXTENSION

Consent Management by Usercentrics CMP v2

About this Documentation

This documentation explains the installation and functionality of the Adobe Launch Extension "Consent Management by Usercentrics CMP v2" which is developed by diva-e in cooperation with Usercentrics.


You can download this documentation as a PDF here.

Installation

Instructions for installing an Adobe Launch Extension can be found here.

Required

Settings-ID

Settings-ID of the relevant Usercentrics account. Can be found in the Usercentrics Admin Interface. This is needed to build the script-tag that will be included on your website to launch usercentrics.

 

Window Event Name

Window Event Name of Usercentrics will be used to identify consent status. You must create a new window event in the Usercentrics Admin Interface under 'Implementation’. The extension will use it as a “Trigger” for any changes that the clients make to their consent settings. If you already defined a Window Event Name within Usercentrics, you could also use that one. However, we would recommend creating an own Window Event Name, just for the Usercentrics Launch Extension.


Optional

Experience Cloud ID Service Opt-In

This allows you to use the Experience Cloud ID Service Opt-In feature, which handles consent for specific Adobe products. You can find a list of all default supported Adobe products in the Default section of Data Processing Services in the extension’s settings page. Please keep in mind that this will only work if the "Experience Cloud ID Service"-Extension is installed.

 

Predefined Data Processing Service

We already have defined some of the Adobe Products if you plan to use the Experience Cloud ID Service Opt-In. Those are: Adobe Advertising Cloud (DSP, Search), Adobe Analytics, Adobe Audience Manager & Adobe Target.

Custom Data Processing Services

If you use a DPS that is not listed in the default section (see above), you can configure them in this secion. To clearly identify the DPS, the Template Name and the Template ID from your Usercentrics Admin Interface and (optionally) the information whether it is an Adobe product should be specified. If you have activated the ECID Opt-In, the consent will be applied automatically for the specific Adobe categories.

Action: Load Usercentrics

Loads the Usercentrics (V2) CMP and applies the Usercentrics consents to the ECID opt-in framework if enabled over the extension’s configuration page.

To ensure that the CMP is loaded first, the order should be set to 1 for the "Library Loaded (Page Top)" event.

Action: Reload Website

Simple action to reload the website. This is useful if you use third party tags, which need a reload for reading a new consent state.

Please Note: This is an optional action that is not necessarily required for an implementation of the DPS you are using.


Event: Consent Update

Triggers when the configured Window Event fires. This update will not be called on the initial Window Event, to prevent the site from looping (e.g., if a page reload is configured as action).

If the consent for an initial page view and a new user is already given (for example for technically required DPS), we recommend adding / using another event (e.g.: Page Top) to the rule.

Condition: Consent Given

Based on the mappings configured in the extension’s configuration page, the condition evaluates to “true” if a selected service (multiple services possible) has changed its consent to "consent given".

Please Note: There is a distinction by which event this condition was triggered.

Case 1: The condition was triggered by the "Usercentrics: Consent Update" event. In this case, the consent must actually change from "Revoked" to "Given" so that the condition fires.

Case 2: The condition is triggered by any other event. If this is the case, it is only checked whether the current consent status is set to "Given" in order to fire the condition.

Condition: Consent Revoked

Based on the mappings configured in the extension’s configuration page, the condition evaluates to "true" if a selected service (multiple services possible) has changed its consent to "consent revoked".

Please Note: There is a distinction by which event this condition was triggered.

Case 1: The condition was triggered by the "Usercentrics: Consent Update" event. In this case, the consent must actually change from "Given" to "Revoked" so that the condition fires.

Case 2: The condition is triggered by any other event. If this is the case, it is only checked whether the current consent status is set to "Revoked" in order to fire the condition.


Loading Adobe Target with the ECID-Feature enabled (part 1)

Loading Adobe Target with the ECID-Feature enabled (part 2)

Loading Adobe Target without the ECID-Feature enabled

Please note

  • This extension supports the Usercentrics CMP Version 2 only.

  • If you plan to handle the consent management somewhere else and not via the extension, you can also use the extension to simply implement the Usercentrics CMP Version 2 on your website.

Smart Data Protector

The Smart Data Protector ist currently not part of this extension. If you plan to implement it you can find more information here.

Do you need help or do you have questions?

  • Feel free to write us an email at: usercentrics@diva-e.com

  • You don't have a Usercentrics Settings-ID yet? Create a Usercentrics account here.