1. Help Center
  2. Versions & Proofs

Understand Versions & Proofs feature

This article describes in more detail the module Versions & Proofs and the information you can extract from there. 

The Versions and Proofs module is in private beta. Feel free to reach out to your Customer Success contact to know more about this coming feature. 

In the meantime, if you need any proof, please refer to this article

The module Versions & Proofs, available from the left menu in the console, is here to help you gathering proof of how consent was collected.

In other words, you will find in this section the history of your published notice configurations.  

For more info about notice creation and update from the console, please consult this documentation

🔎 Use cases

This module can be very useful for the following use cases: 

  • Generate proofs in case of an audit: to demonstrate how the notice was configured on your website for a particular period.
  • Generate proofs in case of complaints: to show a user the vendors and purposes available in notice when he or she gave his or her consent. 
  • Troubleshoot notices issues: to investigate differences from one published version to another that could explain new issues you are facing (for example loss of revenues due to removal of a vendor).
  • Track published changes made on notices: follow up easily changes made on a notice checking the comments made at publication time. 

🗒️ Notice version configuration information

The Versions & Proofs module allows you to consult from the console and extract in JSON or CSV format the configuration of a particular notice version.

You will find here the detailed description of all information you can find in a notice configuration extract: 

config.app.name Organization name
config.app.logoUrl Company logo URL
config.app.vendors Object containing vendors added in the notice
config.app.vendors.iab.all All IAB vendors are included or not. 
config.app.vendors.iab.stacks IAB stacks. Cf. https://support.didomi.io/stacks-feature
config.app.vendors.iab.stacks.id Id of selected stacks
config.app.vendors.iab.stacks.auto Auto selection of stacks according to vendors/purposes selected
config.app.vendors.iab.enabled True if some IAB vendors are included.
config.app.vendors.iab.exclude List of excluded IAB vendors (from custom JSON)
config.app.vendors.iab.include List of included IAB vendors (from custom JSON)
config.app.vendors.iab.version TCF version
config.app.vendors.iab.restrictions Restrictions of purposes by vendor with the legal basis specification (see 📰 documentation)
config.app.vendors.iab.restrictions.id Restriction id
config.app.vendors.iab.restrictions.vendors Vendors for which there is a restriction
config.app.vendors.iab.restrictions.purposeId Id of purpose for which the restriction appplies
config.app.vendors.iab.restrictions Type of restriction
config.app.vendors.include Custom vendors ids list
config.app.privacyPolicyURL Privacy policy URL to be added in the notice
config.app.essentialPurposes Purposes required for the website to work properly (the customer cannot refuse them)
config.app.gdprAppliesGlobally Notice displayed globally (for EU customers) if true. Otherwise, notice displayed for EU visitors
config.app.gdprAppliesWhenUnknown If set to true, the user will see a consent notice when its country is unknown.
config.user.bots Object containing bots configuration
config.user.bots.consentRequired If you check this box, the notice will be displayed when a robot visits your website.
config.theme The object containing notice theme (see 📰 documentation)
config.theme.css Custom CSS for the theme
config.theme.font Font for the notice texts
config.theme.color Theme color (button and main color of the notice)
config.theme.linkColor Color of links
config.integrations.vendors Objects containing integrations information
config.integrations.vendors.google Google Ad manager integration configuration
config.integrations.vendors.google.enable Enable Google Ad Manager integration
config.integrations.vendors.google.refresh Option to refresh ads (done by Didomi or by customer)
config.integrations.vendors.google.eprivacy Display non-personalized ads before collecting consent or when consent is denied
config.integrations.vendors.google.passtargetingVariables Pass IAB consent string and GDPR status as targeting variables to creatives
config.integrations.vendors.salesforce Salesforce DMP integration configuration
config.integrations.vendors.salesforce.enable Enable Salesforce DMP integration
config.integrations.vendors.salesforce.namespace Namespace used in Salesforce DMP (if any)
config.integrations.vendors.refreshOnConsent Refresh the page when consent is given for Google Ad Manager integration (deprecated)
config.languages.default The default language for notice (see 📰  documentation)
config.languages.enabled Enabled languages for notice
config.notice.content.notice Message displayed in the first view per language. Empty when standard text from TCF is used.
config.notice.position Notice position in the website  (see 📰  documentation)
config.notice.closeOnClick Notice closes on click outside or not
config.notice.CcloseOnScroll Notice closes on scroll or not
Display purposes on notice first view. Always true for compliancy reasons except if purposes are indicated in custom standard text.
config.notice.closeOnScrollThreshold Scroll percentage for close on scroll option
config.notice.daysBeforeShowingAgain After how many days notice should be displayed again if new vendors are added (see 📰  documentation)
config.notice.closeOnScrollThresholdType Scroll threshold type (percent)
config.notice.closeOnClickNavigationDelay Delay in milliseconds to collect consent when a user navigates to another page of the website
config.preferences.content.text Message displayed in the preferences pop-in view per language, before the list of purposes
config.preferences.content.title Title displayed in the preferences views per language
config.preferences.content.textVendors Message displayed in the preferences views per language, before the list of vendors
config.preferences.content.categories Categories of purposes
config.preferences.content.categories.type Equal to "category", or equal to "purpose" for purposes not part of a category
config.preferences.content.categories.purposeId Id of the purpose
config.preferences.content.categories.id Category id
config.preferences.content.categories.name Name of the category (in all languages)
config.preferences.content.categories.children Purposes included in the category.
config.preferences.content.categories.expanded Expand category by default or keep it closed
config.preferences.content.categories.description Category description
config.preferences.content.showWhenConsentIsMissing With pop in format, display the full Preferences popup to the user instead of the notice
config.regulations.ccpa Notice configuration for regions under CCPA regulations. Can be configured via custom JSON only
config.regulations.ccpa.config.notice.content Message displayed in notice first view per language for regions under CCPA regulation
config.regulations.ccpa.config.preferences.content Message displayed in the preferences per language, before the list of purposes, for regions under CCPA regulations
config.regulations.ccpa.config.preferences.title Title displayed in the preferences view per language for regions under CCPA regulation
consent_duration Consent validity duration
consent_duration_unit Consent validity duration unit
country Country where your company is operating from
created_at Notice creation date
custom_json Custom JSON added to add options that are not supported by the console
default Notice by default for the account
denied_consent_duration Custom duration after which consent should be recollected when the user denies all purposes and vendors based on consent.
denied_consent_duration_custom Custom validity duration
denied_consent_duration_unit Custom validity duration unit
deployed_at Date of notice publication
deployed_by Id of the user who published the notice
deployed_by_name Name of the user who published the notice
deployed_by_type Type of user who published the notice (user, API...)
disagree_button_style "Disagree to all" button type
enable_ignore_consent_before Enable consent recollection after a particular date
full_atp Use of standard list of ATP vendors for Google Additional Consent mode integration
gcm_ads_default_status Allow advertising cookies before the user gives consent for Google Consent Mode
gcm_analytics_default_status Allow analytics cookies before the user gives consent for Google Consent Mode
gcm_data_layer_name Data layer name for Google Consent Mode
gcm_enabled Google consent mode integration enabled
gcm_set_default_status Set the default status of Google Consent Mode when the page load
id Notice version id
ignore_consent_before Date after which consent should be recollected
negative_action Type of negative action (button, link, none...)
If true, when the user clicks on "disagree and close" in the notice first view, only purposes and vendors based on the consent legal basis will be disabled while the ones based on legitimate interest will remain enabled
notice_id Notice id
organization_id Organization id
platform Notice environment (web, AMP, TV...)
If true, when the user clicks on "disagree and close" in the preferences view, only purposes and vendors based on the consent legal basis will be disabled while the ones based on legitimate interest will remain enabled
targets Domain(s) where notice will be deployed.
text_id Standard text id if any
text_mode Standard text status (always approved)
updated_at Notice update date
version Revision number used to lock a version when several persons work at the same time on notice.
tagManager.provider Tag manager selected