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

  1. Joriy oynadan boshlang. __tcfapi lokal mavjud boʻlsa, uni bevosita ishlating — skript frame ichida emas yoki frame CMP ni ulashadi.
  2. 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.
  3. 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:

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

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

Asosiy xulosalar

← Blog Hammasini o'qish →