Exécuter du code JavaScript et déterminer le signal de consentement

API Consent Ready : unicReady et unicUpdate

Si vous avez installé UniConsent avec la balise unique (https://cmp.uniconsent.com/v2/cmp.js), deux fonctions sont disponibles dès l'exécution de la balise :

• unicReady(callback) se déclenche une seule fois, lorsque l'état du consentement est définitif.
• unicUpdate(callback) se déclenche en même temps que unicReady, puis à chaque changement de consentement.

unicReady(function (status) {
  if (status.UNIC_P_1) {
    loadAnalytics();
  }
});

unicUpdate(function (status) {
  applyConsent(status);
});

Consultez la référence complète, y compris l'objet status, les événements DOM et la garde de file d'attente asynchrone, sur API Consent Ready.

API UniConsent CMP v2

• openunic

Affichez UniConsent CMP aux utilisateurs.

__unicapi('openunic')

• agreeAll

L'utilisateur a accepté toutes les options de consentement. Vous pouvez mettre en œuvre votre première couche programmatique du CMP et déclencher l'événement agreeAll une fois que l'utilisateur a cliqué sur le bouton "Accepter tout" dans votre interface utilisateur de première couche programmatique.

__unicapi('agreeAll')

• openOptions

Ouvrez la deuxième interface utilisateur. Cela peut être utilisé si vous souhaitez personnaliser la première couche et ouvrir de manière programmatique le gestionnaire de consentement.

__unicapi('openOptions')

• openVendorList

Ouvrez l'interface utilisateur de la liste des fournisseurs. Cela peut être utilisé si vous souhaitez personnaliser la première couche et ouvrir de manière programmatique le gestionnaire de consentement.

__unicapi('openVendorList')

• openCookiesList

Ouvrez l'interface utilisateur de la liste des cookies. Cette interface fournit aux utilisateurs des informations détaillées sur les cookies utilisés sur le site web.

__unicapi('openCookiesList')

Exemple de lien HTML :

<a class="font-bold underline cursor-pointer" href="javascript:void(0);" onclick="__unicapi('openCookiesList');">Cookies List</a>

• getUConsent

Obtenez le signal de consentement de vos fournisseurs personnalisés.

__unicapi(
  'getUConsent',
  2,
  (uConsent, success) => {
    if (success) {
      // do something with tcData
    } else {
      // do something else
    }
  },
  [1, 2, 3]
) // vendors Ids

• getCustomConsent

Obtenez le statut de consentement de vos Finalités Personnalisées.

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

    if (data['custom_analytics']) {
      // le consentement pour l'analyse personnalisée est accordé
    }
  }
});

• getUCData (deprecated, use addEventListener)

Obtenez les données de signal de consentement de vos fournisseurs personnalisés.

__unicapi(
  'getUCData',
  2,
  (ucData, success) => {
    if (success) {
      // do something with tcData
    } else {
      // do something else
    }
  },
  [1, 2, 3]
) // vendors Ids

API de la plateforme de gestion du consentement IAB TCF V2

• getTCData (deprecated, use addEventListener)

__tcfapi(
  'getTCData',
  2,
  (tcData, success) => {
    if (success) {
      // do something with tcData
    } else {
      // do something else
    }
  },
  [1, 2, 3]
) // vendors Ids

• ping

__tcfapi('ping', 2, (pingReturn) => {
  // faites quelque chose avec pingReturn
})

• addEventListener

const callback = (tcData, success) => {
  if (success && tcData.eventStatus === 'tcloaded') {
    // do something with tcData.tcString

    // remove the ourself to not get called more than once
    __tcfapi(
      'removeEventListener',
      2,
      (success) => {
        if (success) {
          // oh good...
        }
      },
      tcData.listenerId
    )
  } else {
    // do something else
  }
}

__tcfapi('addEventListener', 2, callback)

• getVendorList

__tcfapi(
  'getVendorList',
  2,
  (gvl, success) => {
    if (success) {
      // do something with gvl
    } else {
      // do something else
    }
  },
  'LATEST'
)

Vous pouvez trouver toutes les API à : Document IAB TCF.

Mécanisme de signal utilisateur de confidentialité aux États-Unis "USP API" (Mécanisme de conformité CCPA)

Exemple :

__uspapi('getUSPData', 1, (uspData, success) => {
  if (success) {
    // do something with uspData
  } else {
    // do something else
  }
})

Réponse uspData :

{
 "version": 1, /* number indicating the U.S. Privacy spec version */
 "uspString": "1YN" /* string; not applicable: "1--" */ /* number; 1 applies, 0 doesn't apply, -1 not set */
}

Retarder le chargement des publicités jusqu'à ce que le consentement TCF soit donné ou ait été donné

Assurez-vous que votre pile publicitaire obtient le consentement des utilisateurs avant de démarrer.

Exemple :

__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.unicLoad === true) {
    if (!window._initAds) {
      window._initAds = true
      // your code to kick off the ads
      console.log('_initAds started.')
    }
  }
})

Écouter et attendre les données de consentement unic_data avec du JavaScript pur

Exemple :

;(function waitCMP() {
  var readyCMP
  if (!readyCMP && window['dataLayer']) {
    window['dataLayer'].forEach(function (event) {
      if (event['event'] === 'unic_data') {
        readyCMP = 1
        console.log(event)
        // your other codes;
      }
    })
  }
  if (!readyCMP) {
    setTimeout(waitCMP, 100)
  }
})()