Samþykki innan iframe frá öðru origin: Mynstrið með __tcfapiLocator og __gppLocator
Vandamálið: Samþykki lifir í efsta glugganum
CMP keyrir á síðunni þinni, í efsta glugga. Stór hluti auglýsinga þinna gerir það ekki. Skjáauglýsingar, rich media, birtingarkóði header bidding og mörg viðmót þriðju aðila keyra inni í iframe, oft á öðru origin. Kóði í iframe frá öðru origin getur ekki kallað beint á aðgerð á móðursíðunni, svo hann getur ekki einfaldlega kallað á __tcfapi eða __gpp og lesið val gestsins.
IAB rammarnir leysa þetta með lítilli og vel skilgreindri skilaboðareglu. Ef þú smíðar auglýsingavörur, innfellingar eða mælingaskriftur sem keyra í römmum, eða villuleitar auglýsingakerfi sem gera það, er vert að vita nákvæmlega hvernig það virkar.
Locator-ramminn
Samhliða JavaScript API bætir TCF CMP tómum, ósýnilegum iframe með nafninu __tcfapiLocator á efstu síðuna. GPP CMP gerir það sama með ramma sem heitir __gppLocator. Rammarnir hafa ekkert efni. Eina hlutverk þeirra er að vera finnanlegir: hver skrifta í hvaða innfelldum ramma sem er getur gengið upp gluggastigveldið og athugað hvort rammi með því nafni sé til á hverju stigi.
Þar sem rammaheiti eru sýnileg milli origin í gegnum window.frames getur skrifta í djúpt innfelldum iframe frá öðru origin fundið gluggann sem hýsir CMP án þess að hafa aðgang að neinu öðru á þeirri síðu.
Hvernig skrifta í ramma finnur CMP
- Byrjaðu á núverandi glugga. Ef __tcfapi er til staðar staðbundið skaltu nota það beint — skriftan er ekki í ramma, eða ramminn deilir CMP.
- Annars skaltu fara í lykkju upp á við: athugaðu hvort núverandi gluggi inniheldur ramma sem heitir __tcfapiLocator; ef ekki skaltu færa þig í window.parent og athuga aftur, og stoppa í efsta glugganum.
- Þegar locator-inn finnst er glugginn sem inniheldur hann gluggi CMP. Samskiptin fara nú fram í gegnum postMessage.
Vefðu hverjum aðgangi í try/catch, því sumir vafrar eða einangrunarstillingar kasta villu við aðgang að eiginleikum milli origin, og stöðvaðu lykkjuna þegar window.parent er sama og núverandi gluggi.
Skilaboðasniðið
Fyrir TCF sendir skriftan í rammanum skilaboð til CMP-gluggans sem innihalda hlut með eiginleikanum __tcfapiCall. Innan hans eru fjórir reitir:
- command — til dæmis getTCData, ping eða addEventListener;
- parameter — hvers kyns argument sem skipunin þarf, eða null;
- version — útgáfa API, 2 fyrir TCF v2;
- callId — einstakt gildi sem kallarinn býr til.
CMP hlustar á þessi skilaboð, keyrir skipunina og sendir til baka hlut með eiginleikanum __tcfapiReturn sem inniheldur returnValue, success og sama callId. Kallarinn heldur utan um biðandi callback-föll eftir callId, hlustar á message atburði og beinir hverju svari til réttu callback-fallsins. GPP fylgir sama mynstri með __gppCall og __gppReturn.
Margar samþættingar skrifa lítinn proxy: staðbundið fall sem heitir __tcfapi inni í rammanum og þýðir köll í skilaboð. Kóði skrifaður fyrir efsta gluggann virkar þá óbreyttur inni í rammanum.
Event listener milli ramma
Kall á addEventListener sem sent er með postMessage er ekki einstök beiðni. CMP sendir svarskilaboð í hvert sinn sem samþykkisstaðan breytist, öll með sama callId. Dreifingin þín verður því að halda því callback-falli skráðu í stað þess að eyða því eftir fyrsta svar. Að gleyma þessu er klassísk villa: skriftan í rammanum les samþykki einu sinni og tekur aldrei eftir afturköllun síðar.
Öryggissjónarmið
- Staðfestu lögun skilaboða. Hunsaðu öll skilaboð sem innihalda ekki væntan eiginleika og þáttaðu strengjafarma varlega, því sumar útfærslur senda JSON-strengi frekar en hluti.
- Treystu ekki í blindni. Hver síða getur sent skilaboð á rammann þinn. Meðhöndlaðu svör sem samþykkismerki til að virða, ekki sem auðkennd gögn, og láttu þau aldrei kalla fram aðgerðir sem krefjast aukinna réttinda.
- Notaðu tiltekin markorigin þar sem hægt er. Þegar origin CMP er þekkt skaltu senda á það frekar en á öll origin.
Þar sem mynstrið nær ekki til
Sum auglýsingaumhverfi einangra birtingar strangar. SafeFrame ílát, iframe í sandkassa án réttra heimilda og birtingar sem eru teiknaðar í aðskildum skjölum geta ef til vill ekki gengið rammatréð eða tekið við skilaboðum. Í þeim tilvikum þarf samþykkismerkið yfirleitt að vera sent með beinum hætti, til dæmis sem breytur á auglýsingabeiðninni eða gildi sem auglýsingaþjónninn afhendir birtingunni, svo sem gdpr og gdpr_consent breyturnar sem mörg auglýsingatög styðja.
Gátlisti fyrir villuleit
- Í DevTools efsta gluggans skaltu staðfesta að locator-rammarnir séu til í Elements spjaldinu.
- Skiptu samhengi konsólsins yfir í iframe og athugaðu hvort locator-inn sé aðgengilegur þaðan.
- Skráðu innkomna message atburði í báðum gluggum til að staðfesta að köll og svör flæði.
- Breyttu samþykki í borðanum og staðfestu að listener-ar í römmum fái uppfærslu.
- Prófaðu með CMP hlaðið seint, til að tryggja að kóði í ramma reyni aftur eða bíði frekar en að gefast strax upp.
Lykilatriði
- Rammar frá öðru origin ná til CMP í gegnum __tcfapiLocator og __gppLocator rammana.
- Köll og svör nota postMessage með __tcfapiCall/__tcfapiReturn eða GPP-jafngildum þeirra, pöruð saman með callId.
- Haltu callback-föllum listener-a skráðum svo síðari samþykkisbreytingar berist.
- Staðfestu hver skilaboð og forðastu að meðhöndla þau sem traust inntak.
- Þar sem rammar eru fullkomlega einangraðir skaltu senda samþykki með beinum hætti á auglýsingabeiðninni.