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

  1. 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ë.
  2. 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.
  3. 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:

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

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

Pikat kryesore

← Blog Lexo të gjitha →