IAB GPP

IAB Global Privacy Platform (GPP) je jedinstven API koji prenosi saglasnost za više zakona o privatnosti kroz jedan string i jedan interfejs. OptSens instalira window.__gpp i enkodira sekcije koje podržava u pravi GPP string.

Šta OptSens radi na vezi

OptSens instalira window.__gpp kao stub pri učitavanju stranice, a zatim ga nadograđuje na loaded kada stigne konfiguracija. Kreira se __gppLocator iframe za cross-frame pristup. API odgovara na ove komande:

Komanda	Vraća
ping	GPP verziju, CMP status, GPP string, podržane API-je, primenljive sekcije, parsirane sekcije
addEventListener	Ažuriranja uživo kako se sekcije menjaju
removeEventListener	Otkačinje listener
hasSection	Da li je sekcija prisutna u GPP stringu
getSection	Parsirani objekat sekcije
getField	Jedno polje, na primer usnat.SaleOptOut

Parametri sekcija koriste ime API prefiksa, na primer usnat ili tcfeuv2. Stariji oblici 7:usnat i numerički oblici su takođe prihvaćeni.

Sekcije

Sekcija	ID	Kada je omogućena
TCF EU v2 (tcfeuv2)	2	IAB TCF režim je aktivan
MSPA US National (usnat)	7	CCPA / opt-out režim je aktivan

GPP string uvek počinje enkodiranim zaglavljem, zatim ide po jedan segment po sekciji, spojeni znakom ~. U TCF EU režimu string je zaglavlje plus isti TC string koji proizvodi IAB TCF. U CCPA režimu string je zaglavlje plus enkodirana US National sekcija, sa ovim sadržajem:

• Polja obaveštenja su postavljena, jer baner i link za izbore privatnosti pružaju obavezna obaveštenja.
• SaleOptOut, SharingOptOut i TargetedAdvertisingOptOut prenose izbor posetioca. Vrednost 1 znači odjavljen, a 2 znači nije odjavljen.
• GPC podsekcija prenosi sirov Global Privacy Control signal tačno onako kako ga je pregledač poslao.
• Polja za osetljive podatke i saglasnosti poznate dece su postavljena na 0 (nije primenjivo). OptSens ne obrađuje te kategorije.
• MSPA polja transakcije označavaju transakciju van Multi-State Privacy Agreement okvira.

OptSens koristi nacionalni pristup. Jedna US National sekcija pokriva posetioce iz svake američke savezne države sa zakonom o privatnosti, jer geo detekcija radi na nivou zemlje. Enkodirani string je dostupan od prvog prikaza stranice. Pre bilo kog izbora prenosi podrazumevano stanje bez odjave, a ažurira se onog trenutka kada se posetilac odjavi.

Zapisi o saglasnosti čuvaju GPP string u polju gpp_string, a nasleđeni US Privacy string u odvojenom polju usp_string, i oba se prikazuju na potvrdi o saglasnosti.

Nasleđeni __uspapi

Za stariji američki ad tech koji direktno poziva window.__uspapi, OptSens instalira tanak omotač plus __uspapiLocator iframe. getUSPData vraća US Privacy string u 1YNN formatu, gde se treći karakter menja u Y kada se posetilac odjavio od prodaje. IAB je povukao ovaj format 2024. godine u korist GPP standarda, ali ga velike oglasne platforme i dalje čitaju, pa OptSens služi oba.

Kako da ga omogućite

GPP prati okvire i region koje već konfigurišete. Ne postoji poseban GPP prekidač. Sekcija 2 se uključuje kada omogućite IAB TCF. Sekcija 7 i __uspapi omotač se uključuju automatski za CCPA regione postavljene u vašim geo pravilima. Pogledajte i CCPA / CPRA.

Kako da ga proverite

Otvorite svoj sajt i pokrenite ovo u konzoli pregledača:

window.__gpp('ping', function (data, ok) {
  console.log(ok, data.gppString, data.applicableSections);
});

Na CCPA stranici string počinje sa DBABLA~. Pročitajte parsiranu US National sekciju ili jedno polje:

window.__gpp('getSection', function (section, ok) {
  console.log(ok, section.SaleOptOut, section.Gpc);
}, 'usnat');

window.__gpp('getField', function (value, ok) {
  console.log(ok, value);
}, 'usnat.SaleOptOut');

Proverite nasleđeni endpoint:

window.__uspapi('getUSPData', 1, function (data, ok) {
  console.log(ok, data.uspString);
});

US sekcije

U CCPA regionima, OptSens objavljuje i enkodira US National sekciju i prenosi isti opt-out kroz __uspapi string. Svaki GPP dekoder, uključujući IAB referentnu biblioteku, može da pročita emitovani string.