Consentement IAB TCF V2.2

Description de la façon 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 bannière de confidentialité est déployée.

Cette fonction est définie dans votre container et dans votre bannière de confidentialité afin que vous puissiez l'utiliser avant que votre bannière de confidentialité n'ait fini de se charger. Elle est parfois désignée par IAB comme le TCF API stub.

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

Comment utiliser l'API TCF

La façon recommandée d'obtenir la valeur du consent-string de TCF (tcData.tcString dans l'exemple ci-dessous) est d'utiliser la addEventListener commande.

__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 de 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 : IAB TCF commands

Comment décoder le Consent-String

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

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

Google Additional Consent Mode

Ceci est une extension optionnelle à IAB TCF. Une fois configurée dans les Consent Management Settings, un addtlConsent supplémentaire sera disponible sur le 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