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

  1. Alustage praegusest aknast. Kui __tcfapi on kohapeal olemas, kasutage seda otse — skript ei ole kaadris või kaader jagab CMP-d.
  2. 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.
  3. 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:

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

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

Peamised järeldused

← Blogi Loe kõike →