IAB GPP qatorini brauzer konsolida tuzatish: bosqichma-bosqich qoʻllanma
GPP muammolarini payqash nega qiyin
AQShlik tashrif buyuruvchi maʼlumotlarini sotish yoki ulashishdan voz kechganda (opt-out), bu tanlov sahifadagi har bir reklama hamkoriga yetib borishi kerak. IAB Global Privacy Platform (GPP) bilan u ixcham qator va boʻlim identifikatorlari roʻyxati sifatida uzatiladi. Ulardan biri notoʻgʻri boʻlsa — yoʻq, eskirgan yoki notoʻgʻri boʻlimni olib yursa — koʻzga koʻrinadigan hech narsa buzilmaydi. Reklamalar baribir yuklanadi, banner baribir yaxshi koʻrinadi, muammo esa keyinroq hamkorlar opt-outlarni eʼtiborsiz qoldirishi yoki inventaringizga past stavka qoʻyishi bilan maʼlum boʻladi.
Yaxshi xabar shuki, deyarli hamma narsani brauzer konsolidan tekshirish mumkin. Ushbu qoʻllanma tekshiruvlarni jonli sahifada biz bajaradigan tartibda koʻrib chiqadi.
1-qadam: API mavjud va tayyor ekanini tasdiqlang
GPP bilan mos CMP global __gpp funksiyasini taqdim etadi. Sahifangizda DevTools ni oching va ping buyrugʻini ishga tushiring:
__gpp('ping', function (data) { console.log(data); });
Qaytgan obyekt bir qarashda koʻp narsani aytib beradi:
- gppVersion — joriy implementatsiyalarda 1.1 boʻlishi kerak.
- cmpStatus — CMP yuklanganmi yoki xatoga uchraganmi.
- cmpDisplayStatus — banner bu tashrif buyuruvchi uchun koʻrinadimi, yashirinmi yoki oʻchirilganmi.
- signalStatus — CMP rozilik holatini aniqlagach “ready”, hali qaror qilayotganda “not ready”.
- supportedAPIs — CMP yarata oladigan boʻlimlar.
- applicableSections — hozir shu tashrif buyuruvchiga tegishli boʻlgan boʻlim identifikatorlari.
- gppString — kodlangan qatorning oʻzi.
__gpp aniqlanmagan (undefined) boʻlsa, CMP stub yoʻq yoki juda kech yuklanmoqda. Stub uni kutadigan har qanday reklama skriptidan oldin joyida boʻlishi kerak, aks holda bu skriptlar CMP ni umuman koʻrmaydi va yo kutadi, yo signalsiz davom etadi.
2-qadam: Tegishli boʻlimni tekshiring
GPP dagi har bir maxfiylik doirasining raqamli boʻlim identifikatori bor. Nashriyotchilar eng koʻp uchratadiganlari: 2 (EI TCF v2), 5 (Kanada TCF), 7 (US National, “usnat”) va Kaliforniya, Virjiniya, Kolorado, Yuta va Konnektikut kabi alohida shtat boʻlimlari uchun 8 va undan keyingilari. AQSh shtatidan kelgan tashrif buyuruvchi odatda applicableSections da EI boʻlimini emas, milliy boʻlimni yoki tegishli shtat boʻlimini koʻrishi kerak.
Bir nechta joydan sinab koʻring. Keng tarqalgan xato — banner uchun geografiyani toʻgʻri aniqlaydigan, lekin hududdan qatʼi nazar qatorga standart boʻlimni yozadigan CMP, yoki aksincha. VPN yoki CMP ning koʻrib chiqish vositalari yordamida banner koʻrsatayotgan narsani applicableSections xabar qilayotgan narsa bilan solishtiring.
3-qadam: Boʻlim maʼlumotlarini oʻqing
Qatorni qoʻlda dekodlash oʻrniga CMP dan tahlil qilingan boʻlimni soʻrang:
__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');
US National boʻlimida opt-out maydonlari oddiy qoidaga amal qiladi: 0 — qoʻllanilmaydi, 1 — foydalanuvchi opt-out qildi, 2 — foydalanuvchi opt-out qilmadi. Avval quyidagi maydonlarga eʼtibor bering:
- SaleOptOut va SharingOptOut
- TargetedAdvertisingOptOut
- Tashrif buyuruvchiga har bir amaliyot haqida bildirishnoma berilgani-berilmaganini qayd etadigan mos notice maydonlari
Endi sahifada opt-out ni bajaring — “Do Not Sell or Share” havolangizni bosing yoki sozlamalar markazida sozlamani oʻzgartiring — va getSection ni yana ishga tushiring. Opt-out maydonlari 2 dan 1 ga oʻtishi kerak. Oʻtmasa, interfeys va signal sinxron emas.
4-qadam: Global Privacy Control yoʻlini sinang
Bir nechta shtat qonunlari bizneslardan Global Privacy Control signalini opt-out sifatida qabul qilishni talab qiladi. GPC ni uni qoʻllab-quvvatlaydigan brauzer yoki kengaytmada yoqing, konsolda navigator.globalPrivacyControl true qaytarishini tasdiqlang, soʻng sahifani yangi sessiyada yuklang. Tashrif buyuruvchi bannerga tegmasdan ham tegishli opt-out maydonlari allaqachon 1 boʻlishi kerak. Baʼzi boʻlimlarda tanlov GPC signalidan kelganini koʻrsatadigan maydon ham bor.
5-qadam: Faqat suratlarni emas, hodisalarni kuzating
Reklama skriptlari qatorni sahifa yuklanganda bir marta oʻqib, unutib qoʻymasligi kerak. Hamkorlar nimani koʻrayotganini bilish uchun listener roʻyxatdan oʻtkazing:
__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });
listenerRegistered, signalStatus va sectionChange kabi hodisalarni kuzatishingiz kerak. Tashrif buyuruvchi tanlovni oʻzgartirganda, yangilangan qator bilan sectionChange hodisasi kelishi kerak. Header bidding wrapper yoki reklama serveri integratsiyangiz qatorni faqat signalStatus “ready” boʻlishidan oldin oʻqisa, boʻsh yoki eskirgan qiymat yuborishi mumkin.
6-qadam: Qatorni reklama soʻrovlarigacha kuzatib boring
Nihoyat, Network yorligʻini oching va reklama soʻrovlaringizni filtrlang. Koʻplab reklama endpointlari gpp va gpp_sid parametrlarini (qator va tegishli boʻlim identifikatorlari) qabul qiladi. Quyidagilarni tekshiring:
- ikkala parametr ham AQShlik tashrif buyuruvchilar soʻrovlarida mavjud;
- qator soʻrov paytida ping qaytargan qator bilan mos keladi;
- opt-outdan keyingi soʻrovlar keshlangan qatorni emas, yangi qatorni olib yuradi.
Prebid.js dan foydalansangiz, uning rozilikni boshqarish moduli GPP uchun sozlanganiga ishonch hosil qiling va yakuniy reklama serveri chaqiruvidan tashqari wrapper dan chiqayotgan stavka soʻrovlarini ham tekshiring.
Keng tarqalgan nosozlik namunalari
- Stub reklama teglaridan keyin yuklanadi — hamkorlar CMP ni umuman koʻrmaydi.
- Hudud uchun notoʻgʻri boʻlim — AQSh trafigi uchun EI boʻlimi yuboriladi yoki umuman boʻlim yoʻq.
- Interfeys va signal sinxron emas — tumbler oʻzgaradi, qator esa yoʻq.
- GPC eʼtiborsiz qoldirilgan — brauzer signali hech qachon opt-out ga aylanmaydi.
- Soʻrovlardagi eskirgan qatorlar — wrapper koʻrgan birinchi qiymatni keshlaydi.
Asosiy xulosalar
- ping dan boshlang: versiya, holat, tegishli boʻlimlar va qator voqeaning katta qismini aytib beradi.
- Opt-out maydonlarini oʻqish uchun getSection dan foydalaning; 1 — opt-out qilingan, 2 — qilinmagan.
- Opt-out havolasi va GPC ni alohida sinang va ikkalasi ham signalni oʻzgartirishini tasdiqlang.
- Hodisalarni tinglang va reklama soʻrovlari qatorni oʻqishidan oldin “ready” signalini kuting.
- gpp va gpp_sid ni haqiqiy tarmoq soʻrovlarida, opt-outdan oldin va keyin tekshiring.