Leading Consent Management Platform

Compliant with GDPR, CCPA, COPPA, LGPD, PECR, PDPA, PIPEDA, and more.

API IAB GPP

UniConsent CMP supporta la Global Privacy Platform (GPP), che consente a inserzionisti, editori e fornitori di tecnologia del settore della pubblicità digitale di rispettare i requisiti normativi in diversi mercati. Il protocollo GPP semplifica la trasmissione dei segnali di privacy, consenso e scelta dei consumatori da siti e app ai fornitori di ad tech. L'IAB Tech Lab supervisiona lo sviluppo delle specifiche tecniche GPP.

Devi abilitare GPP nella dashboard di UniConsent per utilizzare l'API GPP 1.1.

L'API IAB Global Privacy Platform (GPP)

L'IAB Global Privacy Platform (GPP) fornisce diverse API che possono essere utilizzate per recuperare dati relativi a vari framework di privacy e consenso. Queste API includono:

API dei dati GPP 1.1:

Il comando getGPPData è stato rimosso nell'API GPP 1.1: puoi recuperare il gppData dalla risposta del comando ping. A partire da GPP 1.1, puoi ottenere la risposta dall'API GPP solo tramite una funzione di callback.

Organizzazioni e piattaforme che utilizzano l'API GPP versione 1.1:

  • Google Ad Manager
  • Amazon Advertising
  • e altre

Il metodo affidabile per accedere ai dati di consenso GPP

Il metodo affidabile per accedere ai dati di consenso GPP è tramite una callback addEventListener. Non richiede che il tag della CMP sia caricato né che l'API GPP sia pronta sulla pagina. È il metodo consigliato per accedere allo stato di consenso corrente.

__gpp("addEventListener", (data, success) => {
  if (success) {
    console.log(data);
  }
  // rimuovi il listener per un accesso ai dati una tantum
  __gpp('removeEventListener', () => {}, data.listenerId);
});

API Ping:

__gpp("ping", function (data, success) {
  console.log(data);
});

// risposta

{
  "gppVersion": "1.1",
  "cmpStatus": "loaded",
  "cmpDisplayStatus": "hidden",
  "signalStatus": "ready",
  "supportedAPIs": ["tcfeuv2","tcfcav1","uspv1","usnatv1","uscav1","usvav1","uscov1","usutv1","usctv1"],
  "cmpId":68,
  "sectionList":[2,6],
  "applicableSections":[2,6],
  "gppString":"xxxx",
  "parsedSections": {"xxx": "xxx"},
}

API Has Section:

Questa API verifica se una sezione specifica è presente nell'oggetto dati GPP. Per verificare se è presente la sezione IAB EU TCF v2, puoi utilizzare il seguente comando:

__gpp("hasSection", function (data, success) {
  console.log(data, success);
}, 'tcfeuv2');

API Get Section:

Questa API recupera una sezione specifica dell'oggetto dati GPP. Per recuperare la sezione IAB EU TCF v2, puoi utilizzare il seguente comando:

__gpp("getSection", function (data, success) {
  console.log(data, success);
}, 'tcfeuv2');

API Get Field:

Questa API recupera un campo specifico all'interno di una sezione dell'oggetto dati GPP. Per recuperare l'elenco degli ID dei fornitori che hanno ricevuto il consenso per IAB EU TCF v2, puoi utilizzare i seguenti comandi:

__gpp("getField", function (data, success) {
  console.log(data, success);
}, 'tcfeuv2.VendorConsents');

Errore comune del codice stub

Uncaught TypeError: p is not a function
    at window.__gpp_stub (stub.min.js:3:519)

A partire da GPP 1.1, puoi ottenere la risposta dall'API GPP solo tramite una funzione di callback. Aggiorna la tua integrazione per utilizzare l'API GPP 1.1.

API dei dati GPP 1.0 (obsoleta)

Questa API consente di recuperare l'intero oggetto dati GPP, che include i dati di tutti i framework normativi supportati. Per recuperare l'oggetto dati GPP puoi utilizzare il seguente comando:

__gpp('getGPPData')

API Has Section:

Questa API verifica se una sezione specifica è presente nell'oggetto dati GPP. Per verificare se è presente la sezione IAB EU TCF v2, puoi utilizzare il seguente comando:

__gpp('hasSection', null, 'tcfeuv2')

API Get Section:

Questa API recupera una sezione specifica dell'oggetto dati GPP. Per recuperare la sezione IAB EU TCF v2, puoi utilizzare il seguente comando:

__gpp('getSection', null, 'tcfeuv2')

API Get Field:

Questa API recupera un campo specifico all'interno di una sezione dell'oggetto dati GPP. Per recuperare l'elenco degli ID dei fornitori che hanno ricevuto il consenso per IAB EU TCF v2, puoi utilizzare i seguenti comandi:

__gpp('getField', null, 'tcfeuv2.VendorConsents')
__gpp('getField', null, 'tcfeuv2.VendorLegitimateInterests')

Queste API consentono di recuperare dati importanti relativi a vari framework di privacy e consenso, che inserzionisti, editori e fornitori di tecnologia del settore della pubblicità digitale possono utilizzare per adeguarsi ai requisiti normativi nei diversi mercati. L'IAB Tech Lab cura lo sviluppo di queste specifiche tecniche.

Confronto tra GPP e l'API IAB TCF 2.3

L'API Global Privacy Platform (GPP) e l'API IAB TCF EU v2 servono entrambe a garantire la conformità al framework EU TCF. Tuttavia, si differenziano nei seguenti aspetti:

  1. Ambito: l'API GPP è un protocollo unico progettato per semplificare la trasmissione dei segnali di privacy, consenso e scelta dei consumatori da siti e app ai fornitori di ad tech a livello globale. L'API IAB TCF EU v2, invece, è progettata specificamente per trasmettere i segnali relativi al framework EU TCF.

  2. Gestione: il protocollo GPP è supervisionato dall'IAB Tech Lab, che cura anche l'API IAB TCF EU v2. Tuttavia, il protocollo GPP comprende altre specifiche tecniche oltre all'EU TCF, mentre l'API IAB TCF EU v2 è incentrata esclusivamente sull'EU TCF.

  3. Funzionalità: l'API GPP offre una serie di funzioni che vanno oltre l'EU TCF, come il recupero dei dati CCPA, mentre l'API IAB TCF EU v2 si concentra esclusivamente sul recupero dei dati relativi al framework EU TCF.

  4. Sintassi: l'API GPP e l'API IAB TCF EU v2 utilizzano una sintassi diversa per recuperare i dati. Ad esempio, per recuperare la sezione EU TCF v2 all'interno dei dati GPP, si utilizza il seguente comando:

__gpp("getSection", null, "tcfeuv2")

Mentre, per recuperare gli stessi dati utilizzando l'API IAB TCF EU v2, si utilizza il seguente comando:

__tcfapi('getTCData', 2, function (tcData, success) {
  // Codice per gestire la risposta
})

Sebbene sia l'API GPP sia l'API IAB TCF EU v2 servano a garantire la conformità al framework EU TCF, l'API GPP è un protocollo più completo, progettato per semplificare la trasmissione dei segnali di privacy, consenso e scelta dei consumatori a livello globale, mentre l'API IAB TCF EU v2 è progettata specificamente per trasmettere i segnali relativi al framework EU TCF.