Privolitev znotraj iframov med različnimi origini: vzorec __tcfapiLocator in __gppLocator

Težava: privolitev živi v glavnem oknu

CMP deluje na vaši strani, v oknu najvišje ravni. Velik del vašega oglaševanja ne. Display kreative, rich media, upodabljalnike header biddinga in številne gradnike tretjih oseb poganjajo iframi, pogosto na drugem originu. Koda v iframu z drugim originom ne more neposredno poklicati funkcije na nadrejeni strani, zato preprosto ne more poklicati __tcfapi ali __gpp in prebrati izbire obiskovalca.

Okvirji IAB to rešujejo z majhno, dobro opredeljeno konvencijo pošiljanja sporočil. Če gradite oglaševalske izdelke, vdelave ali merilne skripte, ki delujejo v okvirjih, ali razhroščujete oglasne sklade, ki to počnejo, je dobro natančno vedeti, kako deluje.

Okvir locator

Poleg API-ja JavaScript TCF CMP na stran najvišje ravni doda prazen, nevidni iframe z imenom __tcfapiLocator. GPP CMP naredi isto z okvirjem z imenom __gppLocator. Ta okvirja nimata vsebine. Njuna edina naloga je, da ju je mogoče najti: vsaka skripta v katerem koli ugnezdenem okvirju se lahko povzpne po hierarhiji oken in na vsaki ravni preveri, ali okvir s tem imenom obstaja.

Ker so imena okvirjev vidna prek originov skozi window.frames, lahko skripta v globoko ugnezdenem iframu z drugim originom poišče okno, ki gosti CMP, ne da bi imela dostop do česar koli drugega na tej strani.

Kako skripta v okvirju najde CMP

  1. Začnite s trenutnim oknom. Če __tcfapi obstaja lokalno, ga uporabite neposredno — skripta ni v okvirju ali okvir deli CMP.
  2. Sicer se v zanki premikajte navzgor: preverite, ali trenutno okno vsebuje okvir z imenom __tcfapiLocator; če ne, preidite na window.parent in preverite znova, ter se ustavite pri najvišjem oknu.
  3. Ko je locator najden, je okno, ki ga vsebuje, okno CMP-ja. Komunikacija zdaj poteka prek postMessage.

Vsak dostop ovijte v try/catch, ker nekateri brskalniki ali nastavitve peskovnika ob dostopu do lastnosti z drugega origina vržejo napako, in zanko ustavite, ko je window.parent enak trenutnemu oknu.

Oblika sporočila

Pri TCF skripta v okvirju pošlje sporočilo oknu CMP-ja, ki vsebuje objekt z lastnostjo __tcfapiCall. Znotraj nje so štiri polja:

CMP posluša ta sporočila, izvede ukaz in pošlje nazaj objekt z lastnostjo __tcfapiReturn, ki vsebuje returnValue, success in isti callId. Klicatelj hrani preslikavo čakajočih callbackov po ključu callId, posluša dogodke message in vsak odgovor usmeri na pravi callback. GPP sledi istemu vzorcu z __gppCall in __gppReturn.

Številne integracije napišejo majhen proxy: lokalno funkcijo z imenom __tcfapi znotraj okvirja, ki klice prevaja v sporočila. Koda, napisana za glavno okno, potem deluje nespremenjeno znotraj okvirja.

Poslušalci dogodkov prek okvirjev

Klic addEventListener, poslan prek postMessage, ni enkratna zahteva. CMP bo poslal povratno sporočilo vsakič, ko se stanje privolitve spremeni, vsa z istim callId. Vaš dispatcher mora zato ta callback ohraniti registriran, namesto da ga po prvem odgovoru izbriše. Pozabiti na to je klasična napaka: skripta v okvirju privolitev prebere enkrat in poznejšega preklica nikoli ne opazi.

Varnostni premisleki

Kam vzorec ne seže

Nekatera oglasna okolja kreative strožje izolirajo. Vsebniki SafeFrame, iframi v peskovniku brez ustreznih dovoljenj in kreative, upodobljene v ločenih dokumentih, morda ne morejo prečkati drevesa okvirjev ali prejemati sporočil. V takih primerih je treba signal privolitve običajno posredovati izrecno, na primer kot parametre na oglasni zahtevi ali vrednosti, ki jih oglasni strežnik preda kreativi, kot sta parametra gdpr in gdpr_consent, ki ju podpirajo številne oglasne oznake.

Kontrolni seznam za razhroščevanje

Ključne ugotovitve

← Blog Preberi vse →