Override configurazioni (API)

In base al caso di utilizzo della CMP, potrebbe essere necessario modificare le configurazioni della CMP attraverso logiche personalizzate all'interno del tuo sito.

Per questo motivo, è necessario introdurre la possibilità di specificare le configurazioni attraverso la variabile globale di override per PubConsent CMP. Attualmente, questo override è possibile solo nelle integrazioni web standard e non in AMP, dove è disponibile solo se è abilitata la Condivisione del Consenso (Consent Sharing: AMP <-> Web Standard ).

All'interno della variabile window.__pub_tech_override_cmp_config, possiamo specificare tutti i parametri che vogliamo sovrascrivere, come nell'esempio:

È importante che questa variabile sia specificata prima dell'esecuzione della CMP.

Per questo motivo, consigliamo di specificare questa variabile prima del tag script di integrazione della CMP.

Come mostrato nell'esempio seguente:

Di seguito puoi controllare tutti i parametri di configurazione.

acceptAllText: (string | null) Descrizione: Sovrascrive il testo predefinito per il pulsante "Accetta Tutto" nell'interfaccia utente.

additionalRefreshConsentOnPCUpdates: (boolean | null) Descrizione: Parametro logico: Se true, quando viene rilevata una nuova versione dei Cookie configurati, la CMP richiederà il consenso agli utenti.

adaptiveFont: (boolean | null) Descrizione: Se impostato su true, il font della Consent Management Platform (CMP) utilizzerà il font predefinito del sito web (controlla il CSS del tuo sito web).

advancedClose: (boolean | null) Descrizione: Abilita la chiusura avanzata della CMP tramite un pulsante "X" in alto. È responsabilità dell'editore abilitare questa funzione.

affirmativeButtonIcon: (ButtonIconStyle) Descrizione: I valori 1 e 2 aggiungono un'icona al pulsante "Accetta Tutto". Valori possibili: 0 (Nessuno), 1 (Freccia), 2 (Segno di spunta).

buttonBorderStyle: (ButtonBorderStyle | null) Descrizione: Sovrascrive lo stile predefinito del bordo del pulsante. Opzioni: 0 (Rettangolare), 1 (Arrotondato).

buttonShadow: (boolean | null) Descrizione: Se true, rimuove l'effetto CSS box-shadow sui pulsanti.

buttonThickness: (ThicknessButtonType | null) Descrizione: Specifica lo spessore dei pulsanti. Opzioni: 0 (base), 1 (grasso), 2 (medio).

closeButtonBackgroundColor: (string | null) Descrizione: Sovrascrive il colore di sfondo del pulsante di chiusura.

closeButtonBorder: (boolean | null) Descrizione: Se true, visualizza un bordo attorno al pulsante di chiusura.

closeButtonBorderColor: (string | null) Descrizione: Sovrascrive il colore del bordo del pulsante di chiusura.

closeButtonColor: (string | null) Descrizione: Sovrascrive il colore primario specificamente per il pulsante di chiusura.

closeButtonType: (CloseButtonType | null) Descrizione: Specifica il tipo di pulsante di chiusura. Opzioni: 0 (pulsante "X"), 1 (pulsante "Chiudi" per GDPR), 2 (chiusura personalizzata con testi).

closeText: (string | null) Descrizione: Sovrascrive il testo predefinito per il pulsante di chiusura.

compactFirstLayer: (boolean | undefined) Descrizione: Rende il primo livello un'interfaccia utente compatta. Disponibile nel layout standard.

contentAlign: (ALIGNMENT | null) Descrizione: Specifica l'allineamento del contenuto all'interno della CMP. Opzioni: 0 (Sinistra), 1 (Centro), 2 (Destra).

cookieWallMode: (boolean | null) Descrizione: Se true, abilita la modalità "piano", impedendo il rifiuto del consenso forzando l'utente ad accettare tutto o a sottoscrivere un abbonamento.

cookieWallModeDenyPersistence: (boolean | null) Descrizione: Parametro logico: Solo se hooksUsage è true e viene comunicato esplicitamente al cliente che gli hook onWasRejected devono essere configurati.

cookieWallModeHooksUsage: (boolean | null) Descrizione: Parametro logico: Abilita la CMP a utilizzare gli Hook del Cookie Wall per consentire agli sviluppatori del cliente di implementare un'integrazione avanzata della modalità Cookie Wall sui loro siti web. (Modalità Cookie Wall)

cookieWallModeLoginLink: (string | null) Descrizione: Campo obbligatorio utilizzato nell'interfaccia utente per creare un pulsante che reindirizza gli utenti alla pagina di accesso quando la modalità cookie wall è abilitata.

cookieWallModeNoConsentRoutes: (string[] | null) Descrizione: Percorsi in cui la CMP dovrebbe saltare la richiesta di consenso quando la modalità cookie wall è abilitata.

cookieWallModeOptOutCookieName: (string | null) Descrizione: Campo obbligatorio utilizzato per escludere il rendering dell'interfaccia utente della CMP per l'utente quando la modalità cookie wall è abilitata.

cookieWallModeSubscriptionLink: (string | null) Descrizione: Campo obbligatorio utilizzato nell'interfaccia utente per creare un pulsante che reindirizza gli utenti alla pagina del piano (abbonamento) quando la modalità cookie wall è abilitata.

customMessage: (string | null) Descrizione: Sostituisce il messaggio predefinito nel pannello principale della CMP con un messaggio personalizzato. È supportato il formato HTML. All'interno del testo personalizzato, è possibile inserire HTML. All'interno dell'HTML, è possibile specificare un link all'elenco dei fornitori tramite un elemento con la classe 'partners-shortcut'; la CMP renderà automaticamente possibile l'apertura dell'elenco dei fornitori al clic. Per il link alla politica sulla privacy, si consiglia di aggiungere il link come nell'esempio in fondo alla pagina. (1)

debug: (boolean | null) Descrizione: Abilita o disabilita la funzionalità di debug della CMP.

delegateConsentPersist: (boolean | null) Descrizione: Parametro logico: Se true, la CMP delega la persistenza del consenso al codice dell'editore; se false o null (predefinito), la CMP gestisce la persistenza internamente.

differentiateButtons: (boolean | null) Descrizione: Se true, il colore primario viene utilizzato nel pulsante di accettazione.

disableLegitimateMirror: (boolean | null) Descrizione: Se true, lo stato dei consensi legali non si rifletterà sui rispettivi interessi legittimi.

disableVendorsAutomaticallyEnabling: (boolean | null) Descrizione: Se true, i fornitori non saranno abilitati per il controllo.

discloseConsentAfterPrerender: (boolean | undefined) Descrizione: Parametro logico - Se true, il consenso sarà divulgato solo dopo la fase di prerendering del browser.

expandToViewport: (boolean | undefined) Descrizione: Se true, la CMP si espanderà alle dimensioni della viewport (altezza e schermo intero su mobile).

expirationDaysForPartialConsents: (number | null) Descrizione: Imposta il numero di giorni prima che un consenso parziale scada e l'interfaccia utente della CMP riappaia.

flatUIPosition: (FlatUIPosition | null) Descrizione: Cambia la posizione quando l'interfaccia utente della CMP utilizza il parametro UI piatto. Opzioni: 'top', 'bottom'.

footerAlign: (ALIGNMENT | null) Descrizione: Specifica l'allineamento del piè di pagina all'interno della CMP. Opzioni: 0 (Sinistra), 1 (Centro), 2 (Destra).

googleConsentModeDebug: (boolean) Descrizione: Parametro logico: Utilizzato per eseguire il debug dell'integrazione della Modalità di Consenso di Google visualizzando i log della console del browser.

googleConsentModeWebTcfFlag: (boolean) Descrizione: Se l'utente non può utilizzare il modello GTM o l'integrazione Gtag, può abilitare questa opzione e Google Tag leggerà direttamente il consenso TCF per conoscere lo stato della Modalità di Consenso.

headerActionsToBottom: (boolean | undefined) Descrizione: Tenta di spostare le azioni disponibili nella sezione dell'intestazione dell'interfaccia utente in basso, vicino al contenuto. Disponibile nel layout standard.

hideLoginCta: (boolean | null) Descrizione: Parametro logico: Se true, la CMP non mostrerà il pulsante di accesso nell'interfaccia utente.

hideMoreOptionsButton: (boolean | null) Descrizione: Se true, nasconde il pulsante "Altre opzioni".

isFlatUI: (boolean | null) Descrizione: Se true, indica l'uso della versione piatta dell'interfaccia utente.

isLegitimateInterestEnabled: (boolean | null) Descrizione: Parametro logico: Se true, gli interessi legittimi saranno abilitati.

lockBodyScroll: (boolean | null) Descrizione: Se true, blocca lo scorrimento del sito quando viene mostrato il pannello della CMP.

logoAlign: (ALIGNMENT | null) Descrizione: Specifica l'allineamento del logo all'interno della CMP. Opzioni: 0 (Sinistra), 1 (Centro), 2 (Destra).

logoHeight: (number | null) Descrizione: Altezza del logo in px.

logoUrl: (string | null) Descrizione: Sovrascrive l'URL del logo predefinito dell'editore.

manageOptionsText: (string | null) Descrizione: Sovrascrive il testo predefinito per la gestione delle opzioni.

narrowGoogleVendorIds: (number[] | null) Descrizione: Parametro logico: Ciò consente di restringere i fornitori di Google utilizzati.

narrowTcfVendorIds: (number[] | null) Descrizione: Parametro logico: Ciò consente di restringere i fornitori TCF utilizzati.

openButton: (boolean | null) Descrizione: Se true, mostra il pulsante per riaprire la CMP in basso.

openButtonCTAColor: (string | null) Descrizione: Specifica il colore del testo o del simbolo utilizzato nel pulsante di apertura.

openButtonPosition: (OpenButtonPosition | null) Descrizione: Specifica la posizione del pulsante di apertura (se abilitato). Opzioni: 'middle', 'bottom'.

openButtonSide: (OpenButtonSide | null) Descrizione: Specifica il lato dello schermo per il pulsante di apertura (se abilitato). Opzioni: 'left', 'right'.

permitLegitimateInterestOnlyForCriticalVendors: (boolean) Descrizione: Parametro logico: Ciò consente alla CMP di abilitare l'interesse legittimo solo per i fornitori TCF critici che non possono essere abilitati in altro modo.

policyUrl: (string) Descrizione: URL della politica sulla privacy dell'editore.

popupWallModeEnabled: (boolean | null) Descrizione: Se true, mostra un popup dopo che l'utente ha cliccato sul pulsante di rifiuto per forzare un'azione. I comportamenti differiscono in base al flag 'cookieWallModeEnabled'.

popupWallModeMessage: (string | null) Descrizione: Utilizzato quando 'popupWallMode' è abilitato per mostrare a un utente un messaggio specifico sotto il titolo.

popupWallModeRequireAcceptOfMandatoryCookies: (boolean | null) Descrizione: Se true, richiede l'accettazione dei cookie obbligatori quando 'popupWallMode' è abilitato.

popupWallTitle: (string | null) Descrizione: Per sovrascrivere il titolo predefinito mostrato quando il Popup Wall viene mostrato all'utente finale.

primaryColor: (string | null) Descrizione: Configura il colore primario utilizzato dall'interfaccia utente della CMP.

purposesIdsThatMustBeEnabled: (number[] | null) Descrizione: Forza specifici ID di finalità primarie a essere true in tutti i casi.

secondaryColor: (string | null) Descrizione: Configura il colore secondario utilizzato dall'interfaccia utente della CMP.

secondaryTextColor: (string | null) Descrizione: Configura i colori del testo secondario utilizzati dall'interfaccia utente della CMP.

skipBot: (boolean | null) Descrizione: Se true, la CMP non salterà il bot e accetterà tutto direttamente senza rendering.

skipRoutesConsentRequest: (string[] | null) Descrizione: Contiene i percorsi in cui la CMP deve essere nascosta.

stackFooterActions: (boolean | undefined) Descrizione: Se true, le azioni del piè di pagina saranno impilate una sopra l'altra.

switchCloseBtnToRight: (boolean | null) Descrizione: Se true, posiziona il pulsante di chiusura a destra e il pulsante indietro a sinistra.

title: (string | null) Descrizione: Sovrascrive il titolo predefinito quando appare il banner dell'interfaccia utente della CMP.

titleAlign: (ALIGNMENT | null) Descrizione: Specifica l'allineamento del titolo all'interno della CMP. Opzioni: 0 (Sinistra), 1 (Centro), 2 (Destra).

uiBorderStyle: (UIBorderStyle | null) Descrizione: Sovrascrive lo stile predefinito del bordo dell'interfaccia utente. Opzioni: 0 (Rettangolare), 1 (Arrotondato).

uppercaseForActions: (boolean | undefined) Descrizione: Se true, il testo dei pulsanti sarà in maiuscolo.

useCompactACStringAsCookie: (boolean | null) Descrizione: Se true, memorizza la stringa AC in modalità compatta nel cookie invece che in localStorage. Deve essere true se l'editore necessita della condivisione del consenso (Vedi Consent Sharing: AMP <-> Web Standard ).

(1) Esempio di link alla politica sulla privacy.