Cross-origin iframe lardagi rozilik: __tcfapiLocator va __gppLocator namunasi
Muammo: rozilik yuqori oynada yashaydi
CMP sahifangizda, eng yuqori darajadagi oynada ishlaydi. Reklamangizning koʻp qismi esa yoʻq. Displey kreativlar, rich media, header bidding renderlari va koʻplab uchinchi tomon vidjetlari iframe lar ichida, koʻpincha boshqa origin da ishlaydi. Cross-origin iframe dagi kod yuqori sahifadagi funksiyani bevosita chaqira olmaydi, shuning uchun u shunchaki __tcfapi yoki __gpp ni chaqirib, tashrif buyuruvchi tanlovini oʻqiy olmaydi.
IAB doiralari buni kichik, aniq belgilangan xabar almashish qoidasi bilan hal qiladi. Frame larda ishlaydigan reklama mahsulotlari, embed lar yoki oʻlchov skriptlarini yaratsangiz, yoki ularni ishlatadigan reklama tizimlarini tuzatsangiz, uning aynan qanday ishlashini bilish foydali.
Locator frame
JavaScript API bilan bir qatorda, TCF CMP yuqori darajadagi sahifaga __tcfapiLocator nomli boʻsh, koʻrinmas iframe qoʻshadi. GPP CMP xuddi shuni __gppLocator nomli frame bilan qiladi. Bu frame larda kontent yoʻq. Ularning yagona vazifasi topilishi mumkin boʻlish: har qanday ichma-ich frame dagi har qanday skript oyna ierarxiyasi boʻylab yuqoriga koʻtarilib, har bir darajada shu nomli frame bor-yoʻqligini tekshirishi mumkin.
Frame nomlari window.frames orqali originlar oʻrtasida koʻrinadigan boʻlgani uchun, chuqur ichma-ich joylashgan cross-origin iframe dagi skript shu sahifadagi boshqa hech narsaga kirish huquqisiz CMP ni joylashtirgan oynani topa oladi.
Frame dagi skript CMP ni qanday topadi
- Joriy oynadan boshlang. __tcfapi lokal mavjud boʻlsa, uni bevosita ishlating — skript frame ichida emas yoki frame CMP ni ulashadi.
- Aks holda, yuqoriga qarab sikl yuring: joriy oynada __tcfapiLocator nomli frame bor-yoʻqligini tekshiring; yoʻq boʻlsa, window.parent ga oʻting va yana tekshiring, yuqori oynada toʻxtang.
- Locator topilganda, uni oʻz ichiga olgan oyna CMP ning oynasi hisoblanadi. Aloqa endi postMessage orqali amalga oshadi.
Har bir murojaatni try/catch ga oʻrang, chunki ayrim brauzerlar yoki sandbox sozlamalari cross-origin xususiyatga kirishda xato beradi, window.parent joriy oynaga teng boʻlganda siklni toʻxtating.
Xabar formati
TCF uchun frame dagi skript CMP oynasiga __tcfapiCall xususiyatiga ega obyektni oʻz ichiga olgan xabar yuboradi. Uning ichida toʻrtta maydon bor:
- command — masalan, getTCData, ping yoki addEventListener;
- parameter — buyruq talab qiladigan har qanday argument yoki null;
- version — API versiyasi, TCF v2 uchun 2;
- callId — chaqiruvchi yaratgan noyob qiymat.
CMP bu xabarlarni tinglaydi, buyruqni bajaradi va returnValue, success hamda xuddi shu callId ni oʻz ichiga olgan __tcfapiReturn xususiyatli obyektni qaytarib yuboradi. Chaqiruvchi kutayotgan callback larning callId kalitli xaritasini saqlaydi, message hodisalarini tinglaydi va har bir qaytishni toʻgʻri callback ga yetkazadi. GPP xuddi shu namunaga __gppCall va __gppReturn bilan amal qiladi.
Koʻplab integratsiyalar kichik proxy yozadi: frame ichida chaqiruvlarni xabarlarga aylantiradigan __tcfapi nomli lokal funksiya. Shunda yuqori oyna uchun yozilgan kod frame ichida oʻzgarishsiz ishlaydi.
Frame lar oʻrtasida hodisa tinglovchilari
postMessage orqali yuborilgan addEventListener chaqiruvi bir martalik soʻrov emas. CMP rozilik holati har oʻzgarganda, hammasi bir xil callId bilan qaytish xabarini yuboradi. Shuning uchun dispetcheringiz bu callback ni birinchi javobdan keyin oʻchirmasdan, roʻyxatda saqlashi kerak. Buni unutish klassik xato: frame dagi skript rozilikni bir marta oʻqiydi va keyingi qaytarib olishni hech qachon sezmaydi.
Xavfsizlik jihatlari
- Xabar shaklini tekshiring. Kutilgan xususiyatni oʻz ichiga olmagan har qanday xabarni eʼtiborsiz qoldiring va satr yuklarini ehtiyotkorlik bilan tahlil qiling, chunki ayrim implementatsiyalar obyekt oʻrniga JSON satrlarini yuboradi.
- Koʻr-koʻrona ishonmang. Har qanday sahifa frame ingizga xabar yuborishi mumkin. Javoblarni autentifikatsiya qilingan maʼlumot emas, rioya qilinishi kerak boʻlgan rozilik signallari deb hisoblang va ular imtiyozli amallarni ishga tushirishiga hech qachon yoʻl qoʻymang.
- Iloji boricha aniq target origin dan foydalaning. CMP origin i maʼlum boʻlsa, hamma origin ga emas, unga yuboring.
Namuna yetib bormaydigan joylar
Ayrim reklama muhitlari kreativlarni qattiqroq izolyatsiya qiladi. SafeFrame konteynerlari, kerakli ruxsatlarsiz sandbox qilingan iframe lar va alohida hujjatlarda render qilingan kreativlar frame daraxti boʻylab yura olmasligi yoki xabar ololmasligi mumkin. Bunday hollarda rozilik signali odatda aniq uzatilishi kerak, masalan, reklama soʻrovidagi parametrlar yoki koʻplab reklama teglari qoʻllab-quvvatlaydigan gdpr va gdpr_consent parametrlari kabi reklama serveri kreativga beradigan qiymatlar sifatida.
Tuzatish chek-roʻyxati
- Yuqori oynaning DevTools ida Elements panelida locator frame lar mavjudligini tasdiqlang.
- Konsol kontekstini iframe ga oʻtkazing va locator ga u yerdan yetib borish mumkinligini tekshiring.
- Chaqiruvlar va qaytishlar oqayotganini tasdiqlash uchun ikkala oynada kiruvchi message hodisalarini jurnalga yozing.
- Bannerda rozilikni oʻzgartiring va frame dagi tinglovchilar yangilanish olishini tasdiqlang.
- Frame dagi kod darhol taslim boʻlmay, qayta urinishi yoki kutishiga ishonch hosil qilish uchun CMP kech yuklanganda sinab koʻring.
Asosiy xulosalar
- Cross-origin frame lar CMP ga __tcfapiLocator va __gppLocator frame lari orqali yetib boradi.
- Chaqiruvlar va qaytishlar callId bilan moslashtirilgan __tcfapiCall/__tcfapiReturn yoki ularning GPP analoglari bilan postMessage dan foydalanadi.
- Keyingi rozilik oʻzgarishlari yetib kelishi uchun tinglovchi callback larni roʻyxatda saqlang.
- Har bir xabarni tekshiring va uni ishonchli kirish deb hisoblashdan qoching.
- Frame lar toʻliq izolyatsiya qilingan joyda rozilikni reklama soʻrovida aniq uzating.