Consenso sui cookie e trigger proattivi per utenti anonimi
Il consenso del Sito Web e l' widget sono separati
Il tuo sito web rimane responsabile del proprio banner di consenso e dell'Informativa sulla Privacy. L'interfaccia di consenso del widget non sostituisce la tua piattaforma di gestione del consenso (CMP), e WebChatAgent non aggiunge un secondo banner all'interno del widget incorporato.
Il widget si avvia in modalità Privacy Anonimo quando tracking-consent viene omesso o impostato su unknown. In questa modalità, le decisioni dei trigger locali rimangono in memoria e non vengono inviate a WebChatAgent.
<!-- tracking-consent is optional; omitted means unknown -->
<web-chat-agent chatbot-id="YOUR_ID"></web-chat-agent>
Cosa funziona senza un segnale di consenso
| Funzionalità | Senza un segnale di consenso |
|---|---|
| Tempo sulla pagina | Funziona localmente in memoria |
| Profondità di scorrimento | Funziona localmente in memoria |
| Intento di uscita | Funziona localmente in memoria |
| Inattività | Funziona localmente in memoria |
| Corrispondenza URL | Funziona per la Pagina corrente |
| Visibilità della sezione | Funziona localmente in memoria |
| Rage click | Funziona localmente in memoria |
| Pagine visitate | Funziona durante la navigazione SPA nello stesso documento, si reimposta dopo un ricaricamento completo |
| Visitatore di ritorno | Disattivato |
| Saluto proattivo generato dall'IA | Utilizza il fallback statico configurato |
| Analisi dei trigger prima dell'interazione in chat | Disattivato |
| Cooldown persistente/Giornaliero | Esegue il fallback alla durata del documento attuale |
| Rifiuto permanente | Dura solo fino al ricaricamento del documento |
Prima che un Visitatore interagisca con la chat, la valutazione anonima dei trigger non crea un ID Visitatore, non scrive lo stato proattivo nello storage del browser e non invia eventi di Comportamento a WebChatAgent.
Interfaccia di consenso
Utilizza l'attributo opzionale quando il tuo gestore del consenso conosce già la scelta del Visitatore:
<web-chat-agent
chatbot-id="YOUR_ID"
tracking-consent="granted"
></web-chat-agent>
I valori consentiti sono unknown, denied e granted. I valori mancanti e non validi vengono trattati come unknown.
Per le modifiche al consenso senza un ricaricamento della pagina, invia:
window.dispatchEvent(
new CustomEvent('webchatagent:consent', {
detail: { tracking: 'granted' }
})
)
Invia denied quando il consenso viene rifiutato o revocato. WebChatAgent interrompe quindi il tracciamento facoltativo e rimuove lo stato dei trigger proattivi oltre alla personalizzazione dell'interfaccia utente vincolata al consenso. L'archiviazione funzionale delle Sessioni di chat rimane Disponibile dopo che il Visitatore utilizza attivamente la chat.
Nelle distribuzioni white-label, il nome dell'evento neutrale rispetto al brand chat-widget:consent funziona in modo identico, utilizzalo quando la pagina che incorpora non deve fare riferimento al Nome piattaforma.
granted solo dopo che la tua CMP ha registrato una scelta valida per la Categoria che copre ogni Funzionalità abilitata. I saluti generati dall'IA, il riconoscimento dei visitatori e l'Analisi dei trigger potrebbero richiedere descrizioni o categorie diverse nella tua configurazione. Conferma la mappatura con il tuo consulente per la privacy.Adattatore CMP generico
function updateWebChatAgentConsent(isGranted) {
window.dispatchEvent(
new CustomEvent('webchatagent:consent', {
detail: { tracking: isGranted ? 'granted' : 'denied' }
})
)
}
// Call this from your CMP's consent-ready and consent-change callbacks.
updateWebChatAgentConsent(false)
Cookiebot
Cookiebot espone le decisioni della Categoria Attuale tramite Cookiebot.consent e notifica le modifiche con eventi del browser. Scegli la Categoria corrispondente alle finalità documentate:
function syncWebChatAgentWithCookiebot() {
const consent = window.Cookiebot?.consent
const granted = Boolean(consent?.preferences && consent?.statistics)
updateWebChatAgentConsent(granted)
}
window.addEventListener('CookiebotOnConsentReady', syncWebChatAgentWithCookiebot)
window.addEventListener('CookiebotOnAccept', syncWebChatAgentWithCookiebot)
window.addEventListener('CookiebotOnDecline', syncWebChatAgentWithCookiebot)
Consulta la documentazione per sviluppatori di Cookiebot per le proprietà e gli eventi correnti delle categorie.
Complianz
Complianz fornisce cmplz_has_consent(category) e hook di Stato/revoca:
function syncWebChatAgentWithComplianz() {
const granted = typeof window.cmplz_has_consent === 'function'
&& window.cmplz_has_consent('marketing')
updateWebChatAgentConsent(granted)
}
jQuery(document).on(
'cmplz_status_change cmplz_revoke cmplz_enable_category',
syncWebChatAgentWithComplianz
)
Sostituisci marketing se la Configurazione documentata della tua CMP utilizza un'altra Categoria. Consulta la documentazione di integrazione di Complianz.
Borlabs Cookie 3
Crea un servizio WebChatAgent nel gruppo di servizi Borlabs appropriato e utilizza l'ID di tale gruppo:
function syncWebChatAgentWithBorlabs() {
const granted = Boolean(
window.BorlabsCookie?.Consents?.hasConsentForServiceGroup('marketing')
)
updateWebChatAgentConsent(granted)
}
window.addEventListener('borlabs-cookie-after-init', syncWebChatAgentWithBorlabs)
window.addEventListener('borlabs-cookie-consent-saved', syncWebChatAgentWithBorlabs)
Sostituisci marketing con l'ID del gruppo di servizi utilizzato nella tua Configurazione di Borlabs. Consulta le API JavaScript di Borlabs Cookie.
Riferimento per l'archiviazione nel browser
| Chiave | Archiviazione | Creato quando | Scopo |
|---|---|---|---|
chatSessionId_<chatbotId> | localStorage | Il Visitatore utilizza attivamente la chat | Riprendere la conversazione funzionale |
chatRecentSessions_<chatbotId> | localStorage | Il Visitatore utilizza le funzionalità delle chat recenti | Elenco locale delle Sessioni di chat note |
chatEndedSessions_<chatbotId> | localStorage | Il Visitatore termina una chat | Mantieni le sessioni terminate fuori dalla Vista attiva |
chatWidgetIsOpen | localStorage | Il Visitatore apre o chiude il widget mobile | Ripristinare lo stato funzionale dell'interfaccia utente |
livechat_timeout_<chatbotId>_<sessionId> | localStorage | Il Visitatore richiede la Chat dal vivo | Riprendere il timeout della Chat dal vivo |
chatThumbRatings_<chatbotId> | localStorage | Il consenso al tracciamento è concesso e il feedback viene inviato | Ricordare la selezione locale del feedback |
wca_privacy_box_dismissed_<chatbotId> | sessionStorage | Il consenso al tracciamento è concesso e l'avviso viene scartato | Nascondere l'avviso nella scheda attuale |
wca_speech_bubble_dismissed_<chatbotId> | sessionStorage | Il consenso al tracciamento è concesso e il fumetto viene scartato | Nascondere il fumetto nella scheda attuale |
wca_triggers_<chatbotId>_* | localStorage/sessionStorage | Il consenso al tracciamento è concesso | Visite di ritorno, contatori, cooldown e stato di rifiuto |
La tua Informativa sulla Privacy deve descrivere l'archiviazione e il trattamento lato server effettivamente abilitati nella tua Configurazione. Questa Documentazione rappresenta una guida tecnica, non un sostituto di una consulenza legale.
