Suostumus cross-origin-iframeissa: __tcfapiLocator- ja __gppLocator-malli

Ongelma: suostumus asuu ylimmässä ikkunassa

CMP toimii sivullasi, ylimmän tason ikkunassa. Suuri osa mainonnastasi ei. Display-kreatiivit, rich media, header biddingin renderöijät ja monet kolmannen osapuolen widgetit toimivat iframeissa, usein eri originissa. Cross-origin-iframessa oleva koodi ei voi kutsua funktiota suoraan vanhempisivulla, joten se ei voi vain kutsua __tcfapi- tai __gpp-rajapintaa ja lukea kävijän valintaa.

IAB:n kehykset ratkaisevat tämän pienellä, hyvin määritellyllä viestintäkäytännöllä. Jos rakennat mainostuotteita, upotuksia tai mittausskriptejä, jotka toimivat kehyksissä, tai debuggaat mainospinoja, jotka tekevät niin, on syytä tietää tarkalleen, miten se toimii.

Locator-kehys

JavaScript-rajapinnan rinnalla TCF-CMP lisää ylimmän tason sivulle tyhjän, näkymättömän iframen nimeltä __tcfapiLocator. GPP-CMP tekee saman kehyksellä nimeltä __gppLocator. Kehyksissä ei ole sisältöä. Niiden ainoa tehtävä on olla löydettävissä: mikä tahansa skripti missä tahansa sisäkkäisessä kehyksessä voi kulkea ylös ikkunahierarkiassa ja tarkistaa jokaisella tasolla, onko sillä nimellä kehystä.

Koska kehysten nimet näkyvät originien yli window.frames-rajapinnan kautta, syvällä sisäkkäisessä cross-origin-iframessa oleva skripti voi paikantaa ikkunan, joka isännöi CMP:tä, ilman pääsyä mihinkään muuhun kyseisellä sivulla.

Miten kehystetty skripti löytää CMP:n

  1. Aloita nykyisestä ikkunasta. Jos __tcfapi on olemassa paikallisesti, käytä sitä suoraan — skripti ei ole kehyksessä tai kehys jakaa CMP:n.
  2. Muussa tapauksessa kierrä ylöspäin: tarkista, sisältääkö nykyinen ikkuna kehyksen nimeltä __tcfapiLocator; jos ei, siirry kohtaan window.parent ja tarkista uudelleen, pysähtyen ylimpään ikkunaan.
  3. Kun locator löytyy, sen sisältävä ikkuna on CMP:n ikkuna. Viestintä tapahtuu nyt postMessage-rajapinnan kautta.

Kääri jokainen käyttö try/catchiin, koska jotkin selaimet tai hiekkalaatikon asetukset heittävät virheen cross-origin-ominaisuuden käytössä, ja lopeta silmukka, kun window.parent on yhtä kuin nykyinen ikkuna.

Viestin muoto

TCF:ssä kehystetty skripti lähettää CMP-ikkunalle viestin, joka sisältää objektin, jossa on ominaisuus __tcfapiCall. Sen sisällä on neljä kenttää:

CMP kuuntelee näitä viestejä, suorittaa komennon ja lähettää takaisin objektin, jossa on ominaisuus __tcfapiReturn, joka sisältää returnValue, success ja saman callId:n. Kutsuja pitää kartan odottavista callbackeista avaimenaan callId, kuuntelee message-tapahtumia ja ohjaa jokaisen paluuarvon oikealle callbackille. GPP noudattaa samaa mallia ominaisuuksilla __gppCall ja __gppReturn.

Monet integraatiot kirjoittavat pienen proxyn: paikallisen funktion nimeltä __tcfapi kehyksen sisälle, joka muuntaa kutsut viesteiksi. Ylimmälle ikkunalle kirjoitettu koodi toimii silloin kehyksessä muuttumattomana.

Event listenerit kehysten yli

Kutsu addEventListener postMessagen kautta ei ole kertaluontoinen pyyntö. CMP lähettää paluuviestin aina, kun suostumustila muuttuu, kaikki samalla callId:llä. Dispatcherisi on siksi pidettävä tämä callback rekisteröitynä sen sijaan, että poistaisi sen ensimmäisen vastauksen jälkeen. Sen unohtaminen on klassinen virhe: kehystetty skripti lukee suostumuksen kerran eikä koskaan huomaa myöhempää peruutusta.

Tietoturvanäkökohdat

Missä malli ei ylety

Jotkin mainosympäristöt eristävät kreatiivit tiukemmin. SafeFrame-säiliöt, hiekkalaatikko-iframet ilman oikeita oikeuksia ja erillisissä dokumenteissa renderöidyt kreatiivit eivät ehkä pysty kulkemaan kehyspuuta tai vastaanottamaan viestejä. Näissä tapauksissa suostumussignaali on yleensä välitettävä erikseen, esimerkiksi mainospyynnön parametreina tai arvoina, jotka mainospalvelin antaa kreatiiville, kuten gdpr- ja gdpr_consent-parametrit, joita monet mainostagit tukevat.

Debuggauksen tarkistuslista

Keskeiset opit

← Blogi Lue kaikki →