Menú de documentación
Eventos y callbacks
Eventos del SDK de CookieHug y callbacks de configuración: escuchar los cambios de consentimiento, con ejemplos.
Eventos
CookieHug lanza eventos personalizados sobre el objeto window. Escúchalos con addEventListener.
Eventos disponibles
| Evento | Descripción | event.detail |
|---|---|---|
CookieHugOnConsentReady | El estado del consentimiento está listo (cargado o recién enviado) | { consent: {...} } |
CookieHugOnLoad | Banner cargado, estado del consentimiento leído | {} |
CookieHugOnAccept | El usuario aceptó las cookies (o las había aceptado antes) | { consent: {...} } |
CookieHugOnDecline | El usuario rechazó las cookies (o las había rechazado antes) | { consent: {...} } |
CookieHugOnDialogInit | Banner inicializado (antes de mostrarse) | {} |
CookieHugOnDialogDisplay | Banner mostrado al usuario | {} |
CookieHugOnTagsExecuted | Se ejecutaron los scripts con data-cookiehug-consent | { count: N } |
Ejemplo: escuchar eventos
window.addEventListener('CookieHugOnAccept', function(e) {
console.log('Consentimiento otorgado:', e.detail.consent);
if (e.detail.consent.statistics) {
// Inicializar la analítica
}
if (e.detail.consent.marketing) {
// Inicializar los píxeles de marketing
}
});
window.addEventListener('CookieHugOnDecline', function(e) {
console.log('El usuario rechazó las cookies');
});
window.addEventListener('CookieHugOnConsentReady', function(e) {
// Se dispara en cada carga de página cuando se conoce el estado
console.log('Estado del consentimiento:', e.detail.consent);
});Callbacks
Como alternativa a los eventos, puedes definir funciones de callback globales. Defínelas antes de que se cargue el script de CookieHug.
Callbacks disponibles
| Callback | Evento correspondiente |
|---|---|
CookieHugCallback_OnConsentReady | CookieHugOnConsentReady |
CookieHugCallback_OnLoad | CookieHugOnLoad |
CookieHugCallback_OnAccept | CookieHugOnAccept |
CookieHugCallback_OnDecline | CookieHugOnDecline |
CookieHugCallback_OnDialogInit | CookieHugOnDialogInit |
CookieHugCallback_OnDialogDisplay | CookieHugOnDialogDisplay |
CookieHugCallback_OnTagsExecuted | CookieHugOnTagsExecuted |
Ejemplo: usar callbacks
<script>
// Define los callbacks ANTES del script de CookieHug
window.CookieHugCallback_OnAccept = function() {
console.log('¡Cookies aceptadas!');
// Inicializar servicios de terceros
};
window.CookieHugCallback_OnDecline = function() {
console.log('Cookies rechazadas');
};
window.CookieHugCallback_OnLoad = function() {
console.log('CookieHug cargado');
};
</script>
<script src="https://cookiehug.com/api/script/TU-CLAVE-DE-LICENCIA.js"></script>