Modifiche all'API JS del framework CMP dell'IAB

Importante: se si utilizzano impostazioni CMP non conformi allo standard IAB TCF, il sistema disabiliterà automaticamente alcuni comandi. I comandi standard IAB TCF (ad es. getVendorConsents) saranno quindi disponibili solo tramite il nome del comando con prefisso (ad es. noncompliant_getVendorConsents anziché getVendorConsents). Maggiori informazioni sulla conformità TCF sono disponibili qui.

Per consentire una maggiore flessibilità, abbiamo aggiunto alcune estensioni alla nostra implementazione dell'API JS del CMP Framework IAB. Queste sono:

Comando	Descrizione
`__cmp(...)`	La funzione globale `__cmp` restituirà sempre anche l'oggetto/risultato del comando invece di passarlo solo alla funzione di callback.
`__cmp( … , … , …, async)`	La funzione globale `__cmp` è estesa da un quarto parametro. Se presente e impostato su false, la funzione callback verrà attivata immediatamente e non verrà messa in coda.
`__cmp("addEventListener", …)` `__cmp("removeEventListener", …)`	Vedi la sezione Eventi CMP.
`__cmp("getVendorConsents", …)`	Equivalente a IAB getVendorConsents ma restituisce anche `customPurposeConsents`, `customVendorConsents` e `googleVendorConsents` proprietà
`__tcfapi("getTCData", …)`	Equivalente a IAB getTCData ma restituisce anche `customPurposeConsents`, `customVendorConsents` e `googleVendorConsents` proprietà

Esempio:

<script>
  var vendorid = 3; //vendor number 3
  var purposeid = 1; //allow cookies
  var x = __cmp("consentStatus", null, null, false);
  if(typeof(x) == 'object' && "consentExists" in x && x.consentExists)
  { 
    //consent data is present, check if consent for vendor is given 
    var y = __cmp("getVendorConsents", new Array(vendorid), null, false); 
    if(typeof(y) == 'object' && "gdprApplies" in y && (!y.gdprApplies || (y.vendorConsents[vendorid] && y.purposeConsents[purposeid]))) 
    {  
      //everything is fine! 
    }
  }
</script>

(Assicurati di rimuovere le interruzioni di riga errate quando copi il testo sopra riportato)

L'esempio sopra mostra un codice di esempio su come puoi verificare se la stringa di consenso è presente e se il consenso è stato dato per un determinato fornitore e scopo in modo sincrono.

We do our best to keep this purely informative documentation up to date. However, if you notice that any of these guides need a little touch-up, let us know!