Leading Consent Management Platform

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

API IAB GPP

Le CMP UniConsent prend en charge la Plateforme mondiale de confidentialité (GPP), qui permet aux annonceurs, éditeurs et fournisseurs de technologie de l'industrie de la publicité numérique de se conformer aux exigences réglementaires dans divers marchés. Le protocole GPP rationalise la transmission des signaux de confidentialité, de consentement et de choix des consommateurs des sites et applications aux fournisseurs de technologies publicitaires. Le laboratoire technologique de l'IAB supervise le développement des spécifications techniques de la GPP.

L'API de la Plateforme mondiale de confidentialité (GPP) de l'IAB

La Plateforme mondiale de confidentialité (GPP) de l'IAB propose plusieurs API pouvant être utilisées pour récupérer des données liées à divers cadres de confidentialité et de consentement. Ces API comprennent:

Vous devez activer la GPP dans le tableau de bord UniConsent pour utiliser l'API GPP 1.1.

API de données GPP 1.1 :

La commande getGPPData a été supprimée dans l'API GPP 1.1 : vous pouvez récupérer les données GPP dans la réponse de la commande ping. À partir de GPP 1.1, la réponse de l'API GPP n'est disponible que via une fonction de rappel (callback). UniConsent répond encore à getGPPData via un callback pour les anciennes intégrations, mais les nouvelles intégrations doivent utiliser ping ou addEventListener.

La méthode fiable pour accéder aux données de consentement GPP

La méthode fiable consiste à utiliser un callback addEventListener. Elle ne nécessite pas que le tag CMP soit chargé ni que l'API GPP soit prête sur la page. C'est la méthode recommandée pour connaître l'état actuel du consentement.

__gpp("addEventListener", (data, success) => {
  if (success && data.pingData && data.pingData.signalStatus === 'ready') {
    console.log(data);
    // supprimer l'écouteur pour un accès unique aux données
    __gpp('removeEventListener', () => {}, data.listenerId);
  }
});

API Ping :

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

// réponse

{
  "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 :

Cette API vérifie si une section spécifique est présente dans l'objet de données GPP. Pour vérifier si la section IAB EU TCF v2 est présente, la commande suivante peut être utilisée :

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

API de Récupération de Section :

Cette API récupère une section spécifique dans l'objet de données GPP. Pour récupérer la section IAB EU TCF v2, la commande suivante peut être utilisée :

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

API de Récupération de Champ :

Cette API récupère un champ spécifique dans une section de l'objet de données GPP. Pour récupérer une liste d'identifiants de fournisseurs avec le consentement donné pour l'IAB EU TCF v2, la commande suivante peut être utilisée :

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

Sections nationale et des États américains

Pour les visiteurs des États-Unis, UniConsent envoie la section nationale américaine (usnat) et, pour les États qui disposent de leur propre section GPP, la section de l'État : Californie (usca), Virginie (usva), Colorado (usco), Utah (usut), Connecticut (usct), Floride (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) et Rhode Island (usri).

Utilisez ces noms de section avec hasSection, getSection et getField. Les anciens noms comme usnatv1 ou uscav1 ne font pas partie de la spécification GPP et ne renvoient aucune donnée.

__gpp("getField", function (data, success) {
  console.log(data, success); // 1 = opposition exprimée, 2 = pas d'opposition
}, 'usnat.SaleOptOut');

Lorsque le navigateur d'un visiteur des États-Unis envoie un signal Global Privacy Control (GPC), UniConsent enregistre automatiquement l'opposition à la vente, au partage et à la publicité ciblée, et définit Gpc sur true dans les sections qui contiennent ce champ. Cela s'applique aussi lorsqu'aucune option de confidentialité américaine n'est activée. Dans ce cas, les balises du site se chargent toujours et l'analyse reste active : seule la publicité personnalisée s'arrête (Google Consent Mode refuse ad_user_data et ad_personalization). Si le visiteur enregistre ensuite un choix dans la bannière, ce choix prévaut sur GPC. Sur les bannières de catégories de consentement, GPC désactive la catégorie Ciblage ou Publicité jusqu'à ce que le visiteur enregistre un choix. GPC ne modifie pas le consentement IAB TCF pour l'UE ou le Canada.

Choisissez les États, les sections GPP et votre statut MSPA dans le tableau de bord UniConsent, sous US State Privacy and GPP.

Lorsque seul le CCPA est activé, UniConsent envoie la section US Privacy (uspv1) avec usnat et, pour les visiteurs de Californie, usca, toutes avec le même choix CCPA. L'IAB a rendu la chaîne US Privacy obsolète en janvier 2024 : les lecteurs GPP peuvent donc utiliser usnat et usca, tandis que uspv1 et __uspapi restent disponibles pour les anciens partenaires.

Erreur courante du code d'ébauche

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

À partir de GPP 1.1, la réponse de l'API GPP n'est disponible qu'avec une fonction de callback. Mettez votre intégration à jour pour utiliser l'API GPP 1.1.

API de données GPP 1.0 (obsolète)

Les commandes GPP 1.0 renvoyaient le résultat directement et acceptaient null à la place d'un callback. Ces formes ne renvoient plus de données. Utilisez les formes GPP 1.1 ci-dessus. Pour les anciennes intégrations, getGPPData reste disponible via un callback :

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

API Has Section (1.0) :

Cette API vérifie si une section donnée est présente dans l'objet de données GPP. Pour vérifier la présence de la section IAB EU TCF v2, la commande suivante était utilisée :

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

API de Récupération de Section (1.0) :

Cette API récupère une section donnée de l'objet de données GPP. Pour récupérer la section IAB EU TCF v2, la commande suivante était utilisée :

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

API de Récupération de Champ (1.0) :

Cette API récupère un champ donné d'une section de l'objet de données GPP. Pour récupérer la liste des identifiants de fournisseurs ayant reçu le consentement pour l'IAB EU TCF v2, les commandes suivantes étaient utilisées :

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

Ces API permettent la récupération de données importantes liées à divers cadres de confidentialité et de consentement, pouvant être utilisées par les annonceurs, les éditeurs et les fournisseurs de technologie dans l'industrie de la publicité numérique pour s'adapter aux exigences réglementaires à travers les marchés. La IAB Tech Lab supervise le développement de ces spécifications techniques.

Comparaison entre GPP et IAB TCF 2.3 API

Le Global Privacy Platform (GPP) API et l'IAB TCF EU v2 API ont tous deux pour objectif de garantir la conformité avec le cadre du TCF de l'UE. Cependant, ils diffèrent de la manière suivante :

  1. Portée : Le GPP API est un protocole unique conçu pour rationaliser la transmission des signaux de confidentialité, de consentement et de choix des consommateurs des sites et applications aux fournisseurs de technologies publicitaires à l'échelle mondiale. En revanche, l'IAB TCF EU v2 API est spécifiquement conçu pour la transmission de signaux liés au cadre du TCF de l'UE.

  2. Responsabilité : Le protocole GPP est supervisé par l'IAB Tech Lab, qui supervise également l'IAB TCF EU v2 API. Cependant, le protocole GPP englobe d'autres spécifications techniques au-delà du TCF de l'UE, tandis que l'IAB TCF EU v2 API se concentre uniquement sur le TCF de l'UE.

  3. Fonctionnalité : Le GPP API offre une gamme de fonctions au-delà du TCF de l'UE, telles que la récupération des données CCPA, tandis que l'IAB TCF EU v2 API se concentre uniquement sur la récupération des données liées au cadre du TCF de l'UE.

  4. Syntaxe : Le GPP API et l'IAB TCF EU v2 API ont une syntaxe différente pour la récupération des données. Par exemple, pour récupérer la section TCF de l'UE v2 dans les données GPP, la commande suivante est utilisée :

__gpp('getSection', function (data, success) {
  // Code pour traiter la réponse
}, 'tcfeuv2')

Alors que, pour récupérer les mêmes données à l'aide de l'IAB TCF EU v2 API, la commande suivante est utilisée :

__tcfapi('getTCData', 2, function (tcData, success) {
  // Code pour traiter la réponse
})

Bien que le GPP API et l'IAB TCF EU v2 API aient tous deux pour objectif de garantir la conformité avec le cadre du TCF de l'UE, le GPP API est un protocole plus complet conçu pour rationaliser la transmission des signaux de confidentialité, de consentement et de choix des consommateurs à l'échelle mondiale, tandis que l'IAB TCF EU v2 API est spécifiquement conçu pour la transmission de signaux liés au cadre du TCF de l'UE.