Menu de la documentation

Événements et callbacks

Événements du SDK CookieHug et callbacks de configuration — écouter les changements de consentement, avec des exemples.

Événements

CookieHug émet des Custom Events sur l'objet window. Écoutez-les avec addEventListener.

Événements disponibles

Événement	Description	event.detail
`CookieHugOnConsentReady`	L'état du consentement est prêt (chargé ou tout juste envoyé)	`{ consent: {...} }`
`CookieHugOnLoad`	Bannière chargée, état du consentement lu	`{}`
`CookieHugOnAccept`	L'utilisateur a accepté les cookies (ou les avait déjà acceptés)	`{ consent: {...} }`
`CookieHugOnDecline`	L'utilisateur a refusé les cookies (ou les avait déjà refusés)	`{ consent: {...} }`
`CookieHugOnDialogInit`	Bannière initialisée (avant l'affichage)	`{}`
`CookieHugOnDialogDisplay`	Bannière affichée à l'utilisateur	`{}`
`CookieHugOnTagsExecuted`	Les scripts portant `data-cookiehug-consent` ont été exécutés	`{ count: N }`

Exemple : écouter les événements

window.addEventListener('CookieHugOnAccept', function(e) {
  console.log('Consentement donné :', e.detail.consent);

  if (e.detail.consent.statistics) {
    // Initialiser l'analytics
  }
  if (e.detail.consent.marketing) {
    // Initialiser les pixels marketing
  }
});

window.addEventListener('CookieHugOnDecline', function(e) {
  console.log('L\'utilisateur a refusé les cookies');
});

window.addEventListener('CookieHugOnConsentReady', function(e) {
  // Se déclenche à chaque chargement dès que l'état est connu
  console.log('État du consentement :', e.detail.consent);
});

Callbacks

Comme alternative aux événements, vous pouvez définir des fonctions de callback globales. Définissez-les avant le chargement du script CookieHug.

Callbacks disponibles

Callback	Événement correspondant
`CookieHugCallback_OnConsentReady`	`CookieHugOnConsentReady`
`CookieHugCallback_OnLoad`	`CookieHugOnLoad`
`CookieHugCallback_OnAccept`	`CookieHugOnAccept`
`CookieHugCallback_OnDecline`	`CookieHugOnDecline`
`CookieHugCallback_OnDialogInit`	`CookieHugOnDialogInit`
`CookieHugCallback_OnDialogDisplay`	`CookieHugOnDialogDisplay`
`CookieHugCallback_OnTagsExecuted`	`CookieHugOnTagsExecuted`

Exemple : utiliser les callbacks

<script>
  // Définissez les callbacks AVANT le script CookieHug
  window.CookieHugCallback_OnAccept = function() {
    console.log('Cookies acceptés !');
    // Initialiser les services tiers
  };

  window.CookieHugCallback_OnDecline = function() {
    console.log('Cookies refusés');
  };

  window.CookieHugCallback_OnLoad = function() {
    console.log('CookieHug chargé');
  };
</script>

<script src="https://cookiehug.com/api/script/VOTRE-CLÉ-DE-LICENCE.js"></script>