consent.onUpdate

Méthode pour s'abonner aux mises à jour du statut de consentement Commanders Act OnSite via JavaScript.

Méthode pour s'abonner aux mises à jour de consentement Commanders Act OnSite via JavaScript. Commanders Act stub OnSite API doit être installé avant d’utiliser l’une des fonctions OnSite API.

cact('consent.onUpdate', function (result) { ... })

Le consent.onUpdate la méthode permet de s'abonner à une fonction de rappel pour les mises à jour de consentement. La fonction de rappel sera appelée avec l'objet de consentement mis à jour. Elle est appelée chaque fois que le consentement est modifié via une interaction avec la bannière Commanders Act ou la consent.update méthode de l'API OnSite.

Le consentObject l'argument sera également enrichi d'une propriété supplémentaire updateEvent pour indiquer comment la mise à jour s'est produite. Elle peut prendre les valeurs suivantes :

Valeur	Description
set	Le consentement a été défini.
changed	Le consentement était déjà établi, puis a été modifié.
revoked	Le consentement a été révoqué par l'utilisateur. Utilisé pour des tâches de nettoyage comme la suppression des identifiants cookie.

Lorsque le consentement est révoqué, deux événements sont déclenchés : un changed suivi d'un revoked.

Exemples

Exemple pour réagir aux changements de consentement d'une catégorie spécifique

Dans cet exemple, la catégorie Analytics a été configurée avec l'ID de catégorie de consentement 2 dans les paramètres de consentement Commanders Act.

cact('consent.onUpdate', function (result) { 
    
    var ANALYTICS_ID = 2;
    var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};
     
    if (analyticsCategory.status === 'on') {
    
        // Le consentement a été fourni pour la catégorie. 
    
    } else {
        
        // Le consentement n’a pas été fourni pour la catégorie. 
           
    }
    
});

Exemple : ne réagir aux changements de consentement d'une catégorie spécifique qu'après que le consentement initial a été donné

Dans cet exemple, la catégorie Analytics a été configurée avec l'ID de catégorie de consentement 2 dans TrustCommander.

cact('consent.onUpdate', function (result) { 

    var ANALYTICS_ID = 2;
    var analyticsCategory = result.consent.categories[ANALYTICS_ID] || {};

    if (result.updateEvent === "changed" && analyticsCategory.status === 'on') {
    
        // Le consentement a été fourni pour la catégorie lors d'une mise à jour.
    
    } 
    
});