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

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

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

La méthode 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 :

Value	Description
définir	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 les tâches de nettoyage comme la suppression des identifiants de cookie.

Lorsque le consentement est révoqué, deux événements sont déclenchés : d'abord 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é donné pour la catégorie. 
    
    } else {
        
        // Le consentement n'a pas été donné pour la catégorie. 
           
    }
    
});

Exemple ne réagissant aux changements de consentement d'une catégorie spécifique qu'après le consentement initial accordé

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') {
    
        // Le consentement a été accordé pour la catégorie lors d'une mise à jour.
    
    } 
    
});