Configurazione utilizzo cookie

AEM fornisce un servizio che consente di configurare e controllare in che modo i cookie vengono utilizzati con le pagine Web:

  • Un servizio lato server configurabile mantiene un elenco di cookie utilizzabili.
  • Un'API javascript consente al codice javascript di verificare che sia possibile utilizzare un cookie.

Utilizzate questa funzione per assicurarvi che le pagine siano conformi al consenso degli utenti in merito all'utilizzo dei cookie.

Configurazione dei cookie consentiti

Configurate il Adobe Granite Opt-Out Service per specificare in che modo i cookie vengono utilizzati nelle pagine Web. La tabella seguente descrive le proprietà che puoi configurare.

Per configurare il servizio, è possibile utilizzare la console Web o aggiungere una configurazione OSGi all'archivio. Nella tabella seguente sono descritte le proprietà necessarie per entrambi i metodi. Per una configurazione OSGi, il servizio PID è com.adobe.granite.optout.

Nome proprietà (console Web) Nome proprietà OSGi Descrizione
Cookie di rifiuto optout.cookies I nomi dei cookie che indicano, se presenti sul dispositivo dell'utente, che l'utente non ha acconsentito all'uso dei cookie.
Intestazioni HTTP di rifiuto optout.headers I nomi delle intestazioni HTTP che indicano, se presenti, che l'utente non ha acconsentito all'uso dei cookie.
Cookie elenco bianco optout.whitelist.cookies Un elenco di cookie che sono essenziali per il funzionamento del sito Web e che possono essere utilizzati senza il consenso dell'utente.

Utilizzate JavaScript lato client per chiamare Adobe Granite Opt-Out Service per verificare che sia possibile utilizzare un cookie. Utilizzare l'oggetto javascript Granite.OptOutUtil per eseguire una delle seguenti operazioni:

  • Ottenete un elenco di nomi di cookie che indicano che l'utente non accetta di utilizzare i cookie a scopo di tracciamento.
  • Ottenere un elenco di cookie che possono essere utilizzati.
  • Determinare se il browser Web contiene un cookie che indica che l'utente non accetta l'uso dei cookie per il tracciamento.
  • Determinare se è possibile utilizzare un cookie specifico.

La cartella della libreria client granite.utils 🔗 fornisce l'oggetto Granite.OptOutUtil. Aggiungi il codice seguente al codice JSP dell'intestazione della pagina per includere un collegamento alla libreria javascript:

<ui:includeClientLib categories="granite.utils" />

Ad esempio, la seguente funzione javascript determina se il cookie COOKIE_NAME può essere utilizzato prima di scriverlo:

function writeCookie(value){
   if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME")) 
      return;
   if (value) {
      value = encodeURIComponent(value);
      document.cookie = "COOKIE_NAME=" + value; 
   }
}

L'oggetto Granite.OptOutUtil Javascript

Granite.OptOutUtil consente di determinare se l'utilizzo dei cookie è consentito.

funzione getCookieNames()

Restituisce i nomi dei cookie che, se presenti, indicano che l'utente non ha dato il consenso all'uso dei cookie.

Parametri

Nessuno.

Valore restituito

Un array di nomi di cookie.

funzione getWhitelistCookieNames()

Restituisce i nomi dei cookie che possono essere utilizzati indipendentemente dal consenso dell'utente.

Parametri

Nessuno.

Valore restituito

Un array di nomi di cookie.

isOptedOut(), funzione

Determina se il browser dell'utente contiene cookie che indicano che non è stato dato il consenso all'utilizzo dei cookie.

Parametri

Nessuno.

Valore restituito

Un valore booleano di true se viene trovato un cookie che indica l'assenza di consenso e un valore di false se nessun cookie indica l'assenza di consenso.

funzione MaySetCookie(cookieName)

Determina se un cookie specifico può essere utilizzato nel browser dell'utente. Questa funzione equivale a utilizzare la funzione isOptedOut insieme a determinare se il cookie specificato è incluso nell'elenco restituito dalla funzione getWhitelistCookieNames.

Parametri

  • cookieName: Stringa. Nome del cookie.

Valore restituito

Un valore booleano di true se è possibile utilizzare cookieName oppure un valore di false se non è possibile utilizzare cookieName.

In questa pagina