IAB TCF V2.2 Consent

Description de l'interaction avec l'API IAB consent

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é 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 la TCF API

La manière recommandée d'obtenir la valeur du consent-string de TCF (tcData.tcString dans l'exemple ci-dessous) est d'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 de consentement. Vous pouvez le faire 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 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 de IAB TCF. Une fois configurée dans les Consent Management Settings, un addtlConsent supplémentaire sera disponible sur le tcData .

__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