Consent IAB TCF V2.3

Description de la manière d'interagir avec l'API de consentement IAB

Si vous utilisez l’option IAB TCF (voir cette page pour configurer IAB TCF sur votre compte), vous pourrez utiliser le __tcfapi là où votre privacy banner est déployée.

Cette fonction est définie dans votre container et dans votre privacy banner afin que vous puissiez l’utiliser avant que votre privacy banner ait fini de se charger. IAB la désigne parfois comme le stub de l’API TCF.

Le consentement IAB TCF est encodé dans un format appelé le Consent-String.

Comment utiliser la TCF API

La méthode recommandée pour obtenir la valeur du consent-string de TCF (tcData.tcString dans l’exemple ci-dessous) consiste à utiliser la commande addEventListener .

__tcfapi('addEventListener', 2, (pingReturn, success) =>{
 if(success &&
    (pingReturn.eventStatus === 'tcloaded' || pingReturn.eventStatus === 'useractioncomplete')) {
 
    // faire quelque chose avec pingReturn.tcString

  } else {

    // faire autre chose

  }
});

Parfois, vous ne souhaitez pas être notifié des mises à jour du consentement. Vous pouvez y parvenir en utilisant le code plus avancé ci-dessous :

__tcfapi('addEventListener', 2, function(pingReturn, success) {
  if(success &&
    (pingReturn.eventStatus === 'tcloaded' || pingReturn.eventStatus === 'useractioncomplete')) {

    // faire quelque chose avec pingReturn.tcString

    // nous supprimer pour ne pas être appelés plus d’une fois
    __tcfapi('removeEventListener', 2, pingReturn.listenerId);

  } else {

    // faire autre chose

  }
});

• Référence : Commandes IAB TCF

Comment décoder le Consent-String

Vous pouvez utiliser ce copier-coller Consent-String sur cette page : https://iabtcf.com/#/decode.

• Référence : Format du Consent-String IAB TCF

Google Additional Consent Mode

Il s’agit d’une extension optionnelle à IAB TCF. Une fois configurée dans les paramètres de Consent Management, un addtlConsent supplémentaire sera disponible sur tcData objet.

__tcfapi('addEventListener', 2, function(pingResult, success) {
  if(success &&
    (pingResult.eventStatus === 'tcloaded' || pingResult.eventStatus === 'useractioncomplete')) {

    // faire quelque chose avec pingResult.addtlConsent

  } else {

    // faire autre chose

  }
});

• Référence : Spécification technique de Google Additional Consent Mode