Finalités Personnalisées

Les Finalités Personnalisées vous permettent de définir vos propres finalités de consentement au-delà des finalités standard IAB TCF et des types Google Consent Mode. Elles sont affichées dans l'interface de consentement, stockées séparément du consentement TCF, et peuvent être interrogées via l'API JavaScript ou utilisées avec le chargement de balises UnicScript.

Configuration des Finalités Personnalisées

1. Activer les Finalités Personnalisées

  1. Connectez-vous au tableau de bord UniConsent.
  2. Accédez à Collecte de Consentement -> Gestionnaire de Consentement et sélectionnez votre site web.
  3. Allez à Étape 4 : Fonctionnalités Avancées.
  4. Activez Activer les Finalités Personnalisées.
  5. Cliquez sur Enregistrer les Modifications.

2. Définir les Finalités Personnalisées

  1. Après l'activation, un nouvel onglet Finalités Personnalisées apparaîtra.
  2. Cliquez sur l'onglet Finalités Personnalisées.
  3. Cliquez sur Ajouter une Finalité Personnalisée pour en créer une nouvelle.
  4. Remplissez :
    • ID : Un identifiant unique sous forme de chaîne (ex. custom_analytics, ab_testing, newsletter_tracking). Cet ID est utilisé dans le stockage, le dataLayer, le chargement de balises et les requêtes API.
    • Nom : Le nom affiché aux utilisateurs dans l'interface de consentement (ex. "Analyse Personnalisée").
    • Description : Une description affichée lorsque les utilisateurs cliquent sur la finalité pour plus de détails.
  5. Cliquez sur Enregistrer les Modifications, puis Publier pour déployer.

Vous pouvez ajouter plusieurs finalités personnalisées. Chacune doit avoir un ID unique.

Fonctionnement des Finalités Personnalisées

  • Les finalités personnalisées apparaissent dans l'interface de consentement aux côtés des finalités standard. Les utilisateurs peuvent activer ou désactiver chacune individuellement.
  • Le statut de consentement est stocké dans une clé de stockage séparée (__unic_custom_consent), indépendante des chaînes de consentement TCF et de Google Consent Mode.
  • Lorsque les utilisateurs cliquent sur « Tout Accepter », toutes les finalités personnalisées sont accordées. Lorsqu'ils cliquent sur « Tout Refuser », toutes sont refusées.
  • Les finalités personnalisées fonctionnent avec tous les cadres juridiques : RGPD, TCF Canada, CCPA, US State Privacy, Mode Simple (EZ), LGPD, PIPL et POPIA.

API JavaScript

Interroger le Statut de Consentement Personnalisé

Utilisez getCustomConsent pour récupérer le statut de consentement actuel de toutes les finalités personnalisées :

__tcfapi('getCustomConsent', 2, function(data, success) {
  if (success) {
    console.log(data);
    // Exemple : { "custom_analytics": true, "ab_testing": false }
  }
});

Ou en utilisant l'alias __unicapi :

__unicapi('getCustomConsent', 2, function(data, success) {
  if (success) {
    if (data['custom_analytics']) {
      // Le consentement pour l'analyse personnalisée est accordé
    }
  }
});

Accès via DataLayer

Le statut de consentement des finalités personnalisées est envoyé au dataLayer sous la forme UNIC_CP_{id} :

(function waitCMP() {
  var readyCMP;
  if (!readyCMP && window['dataLayer']) {
    window['dataLayer'].forEach(function(event) {
      if (event['event'] === 'unic_data') {
        readyCMP = 1;
        console.log(event['UNIC_CP_custom_analytics']); // true ou false
        console.log(event['UNIC_CP_ab_testing']);        // true ou false
      }
    });
  }
  if (!readyCMP) {
    setTimeout(waitCMP, 100);
  }
})();

Chargement de Balises UnicScript

Vous pouvez charger conditionnellement des scripts et des iframes en fonction du consentement des finalités personnalisées en utilisant les attributs unic-cp-id et unic-cp-ids.

Charger un Script pour une Seule Finalité Personnalisée

<script type="text/unicscript" unic-cp-id="custom_analytics">
  console.log('Consentement pour l\'analyse personnalisée accordé');
</script>

Charger un Script Externe pour une Finalité Personnalisée

<script type="text/unicscript" unic-cp-id="custom_analytics" src="https://example.com/analytics.js"></script>

Charger un Script pour Plusieurs Finalités Personnalisées

Toutes les finalités spécifiées doivent être consenties pour que le script se charge :

<script type="text/unicscript" unic-cp-ids="custom_analytics,ab_testing">
  console.log('Les deux finalités personnalisées sont consenties');
</script>

Charger un Iframe pour une Finalité Personnalisée

<iframe
  data-unicscript
  unic-cp-id="custom_analytics"
  width="560"
  height="315"
  data-src="https://example.com/widget"
  frameborder="0"
></iframe>

Intégration Google Tag Manager

Dans GTM, vous pouvez utiliser les variables dataLayer UNIC_CP_{id} pour créer des déclencheurs basés sur le consentement des finalités personnalisées :

  1. Créez une Variable de Couche de Données dans GTM avec le nom UNIC_CP_custom_analytics.
  2. Créez un Déclencheur qui se déclenche lorsque UNIC_CP_custom_analytics est égal à true.
  3. Attachez le déclencheur aux balises que vous souhaitez contrôler.

Stockage

Les données de consentement personnalisé sont stockées sous la clé __unic_custom_consent dans le localStorage (web) ou le stockage clé-valeur natif (applications mobiles). Le format est :

{
  "custom_analytics": true,
  "ab_testing": false
}

Le consentement personnalisé est effacé lorsque les utilisateurs réinitialisent leur consentement via le CMP.

Vous avez encore des questions ?

Contactez-nous : support@uniconsent.com