Nõusolek erineva päritoluga iframe'ides: __tcfapiLocator ja __gppLocator muster
Probleem: nõusolek elab ülemises aknas
CMP töötab teie lehel, ülemise taseme aknas. Suur osa teie reklaamidest mitte. Displeikreatiivid, rich media, header biddingu renderdajad ja paljud kolmanda osapoole vidinad töötavad iframe'ides, sageli teises päritolus. Erineva päritoluga iframe'is olev kood ei saa vanemlehel funktsiooni otse kutsuda, seega ei saa see lihtsalt kutsuda __tcfapi või __gpp ega lugeda külastaja valikut.
IAB raamistikud lahendavad selle väikese, hästi määratletud sõnumivahetuse kokkuleppega. Kui ehitate reklaamitooteid, manuseid või mõõtmisskripte, mis töötavad kaadrites, või silute reklaamistakke, mis seda teevad, tasub täpselt teada, kuidas see töötab.
Locator-kaader
JavaScripti API kõrval lisab TCF CMP ülemise taseme lehele tühja, nähtamatu iframe'i nimega __tcfapiLocator. GPP CMP teeb sama kaadriga nimega __gppLocator. Kaadrid ei sisalda sisu. Nende ainus ülesanne on olla leitavad: iga skript mis tahes pesastatud kaadris saab akende hierarhias ülespoole liikuda ja iga taseme juures kontrollida, kas selle nimega kaader on olemas.
Kuna kaadrinimed on päritolude üleselt nähtavad window.frames kaudu, saab sügavalt pesastatud erineva päritoluga iframe'is olev skript leida akna, mis CMP-d majutab, ilma et tal oleks juurdepääsu millelegi muule sellel lehel.
Kuidas raamitud skript CMP leiab
- Alustage praegusest aknast. Kui __tcfapi on kohapeal olemas, kasutage seda otse — skript ei ole kaadris või kaader jagab CMP-d.
- Vastasel juhul liikuge tsüklis ülespoole: kontrollige, kas praegune aken sisaldab kaadrit nimega __tcfapiLocator; kui ei, liikuge aknasse window.parent ja kontrollige uuesti, peatudes ülemises aknas.
- Kui locator on leitud, on seda sisaldav aken CMP aken. Suhtlus toimub nüüd postMessage kaudu.
Mähkige iga juurdepääs try/catch'i, sest mõned brauserid või liivakasti sätted viskavad vea erineva päritoluga omaduse poole pöördumisel, ning peatage tsükkel, kui window.parent võrdub praeguse aknaga.
Sõnumivorming
TCF-i puhul postitab raamitud skript CMP aknale sõnumi, mis sisaldab objekti omadusega __tcfapiCall. Selle sees on neli välja:
- command — näiteks getTCData, ping või addEventListener;
- parameter — mis tahes käsu vajalik argument või null;
- version — API versioon, TCF v2 puhul 2;
- callId — kutsuja loodud unikaalne väärtus.
CMP kuulab neid sõnumeid, käivitab käsu ja postitab tagasi objekti omadusega __tcfapiReturn, mis sisaldab returnValue, success ja sama callId. Kutsuja hoiab ootel callback'ide kaarti, mille võti on callId, kuulab message sündmusi ja suunab iga tagastuse õigele callback'ile. GPP järgib sama mustrit märkidega __gppCall ja __gppReturn.
Paljud integratsioonid kirjutavad väikese proxy: kohaliku funktsiooni nimega __tcfapi kaadri sees, mis tõlgib kutsed sõnumiteks. Ülemise akna jaoks kirjutatud kood töötab siis kaadris muutmata kujul.
Event listenerid üle kaadrite
Kutse addEventListener, mis saadetakse postMessage kaudu, ei ole ühekordne päring. CMP postitab tagastussõnumi iga kord, kui nõusoleku olek muutub, kõik sama callId-ga. Teie dispetšer peab seega selle callback'i registreerituna hoidma, mitte kustutama pärast esimest vastust. Selle unustamine on klassikaline viga: raamitud skript loeb nõusoleku ühe korra ega märka hilisemat tagasivõtmist.
Turvakaalutlused
- Valideerige sõnumi kuju. Ignoreerige iga sõnumit, mis ei sisalda oodatud omadust, ja parsige stringikoormaid ettevaatlikult, kuna mõned teostused saadavad objektide asemel JSON-stringe.
- Ärge usaldage pimesi. Iga leht võib teie kaadrile sõnumeid postitada. Käsitlege vastuseid austatavate nõusolekusignaalidena, mitte autenditud andmetena, ning ärge kunagi laske neil käivitada privilegeeritud toiminguid.
- Kasutage võimaluse korral kindlaid sihtpäritolusid. Kui CMP päritolu on teada, postitage sellele, mitte igale päritolule.
Kus muster ei ulatu
Mõned reklaamikeskkonnad isoleerivad kreatiive rangemalt. SafeFrame'i konteinerid, liivakasti iframe'id ilma õigete õigusteta ja eraldi dokumentides renderdatud kreatiivid ei pruugi suuta kaadripuud läbida ega sõnumeid vastu võtta. Neil juhtudel tuleb nõusolekusignaal tavaliselt selgesõnaliselt edasi anda, näiteks reklaamipäringu parameetritena või väärtustena, mille reklaamiserver kreatiivile annab, nagu parameetrid gdpr ja gdpr_consent, mida paljud reklaamitagid toetavad.
Silumise kontrollnimekiri
- Ülemise akna DevToolsis veenduge, et locator-kaadrid on paneelil Elements olemas.
- Lülitage konsooli kontekst iframe'ile ja kontrollige, kas locator on sealt kättesaadav.
- Logige mõlemas aknas sissetulevad message sündmused, et kinnitada kutsete ja tagastuste liikumist.
- Muutke bännerist nõusolekut ja kontrollige, et raamitud listenerid saavad uuenduse.
- Testige hilja laaditud CMP-ga, et veenduda, et raamitud kood proovib uuesti või ootab, mitte ei anna kohe alla.
Peamised järeldused
- Erineva päritoluga kaadrid jõuavad CMP-ni kaadrite __tcfapiLocator ja __gppLocator kaudu.
- Kutsed ja tagastused kasutavad postMessage'i märkidega __tcfapiCall/__tcfapiReturn või GPP vasteid, mis sobitatakse callId järgi.
- Hoidke listener-callback'id registreerituna, et hilisemad nõusoleku muudatused kohale jõuaksid.
- Valideerige iga sõnumit ja ärge käsitlege seda usaldusväärse sisendina.
- Kus kaadrid on täielikult isoleeritud, andke nõusolek selgesõnaliselt edasi reklaamipäringus.