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. The Commanders Act Stub OnSite API doit être installé avant d'utiliser l'une des fonctions OnSite API.

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

La consent.onUpdate la méthode permet de s'abonner avec une fonction de rappel pour les mises à jour de consentement. La fonction de rappel sera appelée avec l'objet Consent 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.

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

Valeur	Description
définir	Le consentement a été défini.
changed	Le consentement avait déjà été é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 d'identifiants de cookie.

Lorsque le consentement est révoqué, cela déclenche deux événements : 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'identifiant de catégorie de consentement 2 dans les paramètres Commanders Act Consent.

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

Exemple ne réagissant 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'identifiant 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') {
    
        // Consent was provided for the category during an update.
    
    } 
    
});