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
- Začnite s trenutnim oknom. Če __tcfapi obstaja lokalno, ga uporabite neposredno — skripta ni v okvirju ali okvir deli CMP.
- 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.
- 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:
- command — na primer getTCData, ping ali addEventListener;
- parameter — vsak argument, ki ga ukaz potrebuje, ali null;
- version — različica API-ja, 2 za TCF v2;
- callId — enolična vrednost, ki jo ustvari klicatelj.
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
- Preverjajte obliko sporočila. Prezrite vsako sporočilo, ki ne vsebuje pričakovane lastnosti, in previdno razčlenjujte nizovne vsebine, saj nekatere implementacije pošiljajo nize JSON namesto objektov.
- Ne zaupajte slepo. Vsaka stran lahko pošilja sporočila vašemu okvirju. Odgovore obravnavajte kot signale privolitve, ki jih je treba spoštovati, ne kot overjene podatke, in nikoli ne dovolite, da sprožijo privilegirana dejanja.
- Kjer je mogoče, uporabite določene ciljne origine. Ko je origin CMP-ja znan, sporočilo pošljite njemu, ne vsem originom.
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
- V DevTools glavnega okna potrdite, da okvirja locator obstajata v podoknu Elements.
- Kontekst konzole preklopite na iframe in preverite, ali je locator od tam dosegljiv.
- V obeh oknih beležite prihajajoče dogodke message, da potrdite, da klici in odgovori tečejo.
- V pasici spremenite privolitev in preverite, da poslušalci v okvirjih prejmejo posodobitev.
- Preizkusite s pozno naloženim CMP-jem, da zagotovite, da koda v okvirju poskuša znova ali čaka, ne pa takoj obupa.
Ključne ugotovitve
- Okvirji z drugim originom dosežejo CMP prek okvirjev __tcfapiLocator in __gppLocator.
- Klici in odgovori uporabljajo postMessage z __tcfapiCall/__tcfapiReturn ali ustreznicami GPP, povezani prek callId.
- Callbacke poslušalcev ohranite registrirane, da prispejo poznejše spremembe privolitve.
- Preverite vsako sporočilo in ga ne obravnavajte kot zaupanja vreden vnos.
- Kjer so okvirji povsem izolirani, privolitev posredujte izrecno na oglasni zahtevi.