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. UniConsent continua a rispondere a getGPPData tramite callback per le integrazioni meno recenti, ma le nuove integrazioni devono usare ping o addEventListener.

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 && data.pingData && data.pingData.signalStatus === 'ready') {
    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": ["2:tcfeuv2","5:tcfcav1","6:uspv1","7:usnat","8:usca","9:usva","10:usco","11:usut","12:usct","13:usfl","14:usmt","15:usor","16:ustx","17:usde","18:usia","19:usne","20:usnh","21:usnj","22:ustn","23:usmn","24:usmd","25:usin","26:usky","27:usri"],
  "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');

Sezioni nazionale e statali degli Stati Uniti

Per i visitatori degli Stati Uniti, UniConsent invia la sezione nazionale statunitense (usnat) e, per gli stati che hanno una propria sezione GPP, anche la sezione dello stato: California (usca), Virginia (usva), Colorado (usco), Utah (usut), Connecticut (usct), Florida (usfl), Montana (usmt), Oregon (usor), Texas (ustx), Delaware (usde), Iowa (usia), Nebraska (usne), New Hampshire (usnh), New Jersey (usnj), Tennessee (ustn), Minnesota (usmn), Maryland (usmd), Indiana (usin), Kentucky (usky) e Rhode Island (usri).

Usa questi nomi di sezione con hasSection, getSection e getField. I nomi precedenti come usnatv1 o uscav1 non fanno parte della specifica GPP e non restituiscono dati.

__gpp("getField", function (data, success) {
  console.log(data, success); // 1 = opposizione espressa, 2 = nessuna opposizione
}, 'usnat.SaleOptOut');

Quando il browser di un visitatore degli Stati Uniti invia un segnale Global Privacy Control (GPC), UniConsent registra automaticamente l'opposizione alla vendita, alla condivisione e alla pubblicità mirata e imposta Gpc su true nelle sezioni che hanno questo campo. Questo vale anche quando nessuna opzione di privacy per gli Stati Uniti è attiva. In questo caso i tag del sito continuano a caricarsi e l'analisi resta attiva: si ferma solo la pubblicità personalizzata (Google Consent Mode nega ad_user_data e ad_personalization). Se il visitatore salva in seguito una scelta nel banner, quella scelta ha la precedenza su GPC. Nei banner con categorie di consenso, GPC disattiva la categoria Targeting o Pubblicità finché il visitatore non salva una scelta. GPC non modifica il consenso IAB TCF per l'UE o il Canada.

Scegli gli stati, le sezioni GPP e il tuo stato MSPA nella dashboard di UniConsent, in US State Privacy and GPP.

Quando è attivato solo il CCPA, UniConsent invia la sezione US Privacy (uspv1) insieme a usnat e, per i visitatori della California, usca, tutte con la stessa scelta CCPA. IAB ha deprecato la stringa US Privacy a gennaio 2024, quindi i lettori GPP possono usare usnat e usca, mentre uspv1 e __uspapi restano per i partner meno recenti.

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. I comandi GPP 1.0 restituivano il risultato direttamente. UniConsent ora risponde a getGPPData solo tramite callback:

__gpp('getGPPData', function (data, success) {
  console.log(data);
});

Le forme GPP 1.0 seguenti passano null al posto di un callback e non restituiscono più dati. Usa le forme GPP 1.1 indicate sopra.

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", function (data, success) {
  // Codice per gestire la risposta
}, "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.