---
title: Override configurazioni (API)
slug: it-pubtech-cmp/override-configurazioni-api
docTags: 
createdAt: 2022-04-07T08:56:51.000Z
---

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](docId\:xqdUk0jGQ7J8e5ylnnWPW) ).

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

```javascript
window.__pub_tech_override_cmp_config = {
  policyUrl: 'https://www.yourwebsite.com/privacy-policy/',
  logoUrl: 'https://www.yourwebsite.com/img/logo.png',
  primaryColor: '#c66653', 
  secondaryColor: '',
  closeButtonColor: '',
  //Vedi la tabella per tutti i parametri
}
```

È 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:

```html
<head>
    <script>
        window.__pub_tech_override_cmp_config = {
            policyUrl: 'https://www.yourwebsite.com/privacy-policy/',
            logoUrl: 'https://www.yourwebsite.com/img/logo.png',
            primaryColor: '#c66653',
        }
    </script>

    <!-- Codice di integrazione di PubConsent dal configuratore -->
</head>
```

### Elenco dei Parametri di Configurazione

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](docId:5QvpJzEMKkMNX41DpdWnQ))

`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](docId\:xqdUk0jGQ7J8e5ylnnWPW) ).

**(1) Esempio di link alla politica sulla privacy.**

```html
<a rel="nofollow noopener noreferrer" href="qui il link alla policy" target="_blank">privacy url</a>
```

