Pëlqimi brenda iframe-ve cross-origin: modeli __tcfapiLocator dhe __gppLocator
Problemi: pëlqimi jeton në dritaren e sipërme
Një CMP ekzekutohet në faqen tuaj, në dritaren e nivelit të sipërm. Pjesa më e madhe e reklamave tuaja jo. Kreativet display, rich media, renderuesit e header bidding dhe shumë widget-e të palëve të treta ekzekutohen brenda iframe-ve, shpesh nga një origjinë tjetër. Kodi në një iframe cross-origin nuk mund të thërrasë drejtpërdrejt një funksion të faqes prind, ndaj nuk mund të thërrasë thjesht __tcfapi ose __gpp dhe të lexojë zgjedhjen e vizitorit.
Kornizat e IAB e zgjidhin këtë me një konvencion të vogël dhe të përcaktuar mirë mesazhimi. Nëse ndërtoni produkte reklamash, ngulitje ose skripte matjeje që ekzekutohen në frame, ose nëse korrigjoni grupe reklamash që e bëjnë këtë, ia vlen ta dini saktësisht si funksionon.
Frame-i locator
Krahas API-t JavaScript, një CMP TCF shton në faqen e nivelit të sipërm një iframe bosh dhe të padukshëm me emrin __tcfapiLocator. Një CMP GPP bën të njëjtën gjë me një frame me emrin __gppLocator. Frame-t nuk kanë përmbajtje. E vetmja punë e tyre është të gjenden: çdo skript në çdo frame të ndërfutur mund të ngjitet në hierarkinë e dritareve dhe të kontrollojë nëse në çdo nivel ekziston një frame me atë emër.
Meqë emrat e frame-ve janë të dukshëm mes origjinave përmes window.frames, një skript në një iframe cross-origin thellë i ndërfutur mund ta gjejë dritaren që pret CMP-në pa pasur akses në asgjë tjetër në atë faqe.
Si e gjen CMP-në një skript brenda frame-it
- Filloni me dritaren aktuale. Nëse __tcfapi ekziston lokalisht, përdoreni drejtpërdrejt — skripti nuk është në frame, ose frame-i e ndan CMP-në.
- Përndryshe, ngjituni me një cikël: kontrolloni nëse dritarja aktuale përmban një frame me emrin __tcfapiLocator; nëse jo, kaloni te window.parent dhe kontrolloni përsëri, duke u ndalur te dritarja e sipërme.
- Kur gjendet locator-i, dritarja që e përmban është dritarja e CMP-së. Komunikimi tani ndodh përmes postMessage.
Mbështilleni çdo akses në një try/catch, sepse disa shfletues ose cilësime sandbox-i hedhin gabim në aksesimin e vetive cross-origin, dhe ndalojeni ciklin kur window.parent është i barabartë me dritaren aktuale.
Formati i mesazhit
Për TCF, skripti brenda frame-it i dërgon një mesazh dritares së CMP-së që përmban një objekt me veti __tcfapiCall. Brenda tij janë katër fusha:
- command — për shembull getTCData, ping ose addEventListener;
- parameter — çdo argument që i duhet komandës, ose null;
- version — versioni i API-t, 2 për TCF v2;
- callId — një vlerë unike e gjeneruar nga thirrësi.
CMP-ja i dëgjon këta mesazhe, ekzekuton komandën dhe kthen një objekt me veti __tcfapiReturn që përmban returnValue, success dhe të njëjtin callId. Thirrësi mban një hartë callback-esh në pritje të indeksuar sipas callId, dëgjon ngjarjet message dhe ia dorëzon çdo kthim callback-ut të duhur. GPP ndjek të njëjtin model me __gppCall dhe __gppReturn.
Shumë integrime shkruajnë një proxy të vogël: një funksion lokal me emrin __tcfapi brenda frame-it që i përkthen thirrjet në mesazhe. Kështu kodi i shkruar për dritaren e sipërme funksionon pa ndryshim brenda frame-it.
Listener-ët e ngjarjeve mes frame-ve
Një thirrje addEventListener e dërguar përmes postMessage nuk është kërkesë e njëhershme. CMP-ja do të postojë një mesazh kthimi sa herë që ndryshon gjendja e pëlqimit, të gjitha me të njëjtin callId. Prandaj shpërndarësi juaj duhet ta mbajë atë callback të regjistruar në vend që ta fshijë pas përgjigjes së parë. Harresa e kësaj është një gabim klasik: skripti i frame-it e lexon pëlqimin një herë dhe nuk e vëren kurrë një tërheqje të mëvonshme.
Konsiderata sigurie
- Validoni formën e mesazhit. Injoroni çdo mesazh që nuk përmban vetinë e pritur dhe analizoni me kujdes ngarkesat tekstuale, pasi disa zbatime dërgojnë vargje JSON në vend të objekteve.
- Mos u besoni verbërisht. Çdo faqe mund t’i dërgojë mesazhe frame-it tuaj. Trajtojini përgjigjet si sinjale pëlqimi që duhen respektuar, jo si të dhëna të autentikuara, dhe mos lejoni kurrë që të shkaktojnë veprime të privilegjuara.
- Përdorni origjina destinacioni specifike kur mundeni. Kur origjina e CMP-së dihet, postojini asaj dhe jo të gjitha origjinave.
Ku nuk arrin modeli
Disa mjedise reklamash i izolojnë kreativet më rreptësisht. Kontejnerët SafeFrame, iframe-t në sandbox pa lejet e duhura dhe kreativet e renderuara në dokumente të veçanta mund të mos jenë në gjendje të përshkojnë pemën e frame-ve ose të marrin mesazhe. Në këto raste, sinjali i pëlqimit zakonisht duhet të kalohet në mënyrë të qartë, për shembull si parametra te kërkesa e reklamës ose si vlera që ad server-i ia dorëzon kreativit, si parametrat gdpr dhe gdpr_consent që mbështesin shumë tag-e reklamash.
Lista e kontrollit për korrigjim
- Në DevTools të dritares së sipërme, konfirmoni që frame-t locator ekzistojnë në panelin Elements.
- Ndërroni kontekstin e konsolës te iframe dhe kontrolloni nëse locator-i arrihet që andej.
- Regjistroni ngjarjet hyrëse message në të dyja dritaret për të konfirmuar që thirrjet dhe kthimet qarkullojnë.
- Ndryshoni pëlqimin në baner dhe verifikoni që listener-ët brenda frame-ve marrin një përditësim.
- Testoni me CMP-në e ngarkuar vonë, për t’u siguruar që kodi brenda frame-it provon sërish ose pret në vend që të heqë dorë menjëherë.
Pikat kryesore
- Frame-t cross-origin e arrijnë CMP-në përmes frame-ve __tcfapiLocator dhe __gppLocator.
- Thirrjet dhe kthimet përdorin postMessage me __tcfapiCall/__tcfapiReturn ose ekuivalentët e GPP, të çiftuara sipas callId.
- Mbajini të regjistruara callback-et e listener-ëve që të arrijnë ndryshimet e mëvonshme të pëlqimit.
- Validoni çdo mesazh dhe shmangni ta trajtoni si hyrje të besuar.
- Ku frame-t janë plotësisht të izoluara, kalojeni pëlqimin në mënyrë të qartë te kërkesa e reklamës.