Idhini Ndani ya Iframe za Cross-Origin: Mfumo wa __tcfapiLocator na __gppLocator

Tatizo: Idhini Inaishi kwenye Dirisha la Juu

CMP huendeshwa kwenye ukurasa wako, katika dirisha la ngazi ya juu. Sehemu kubwa ya matangazo yako haiendeshwi hapo. Kreatifu za maonyesho, rich media, vionyeshi vya header bidding na wijeti nyingi za wahusika wengine huendeshwa ndani ya iframe, mara nyingi kwenye origin tofauti. Msimbo ulio kwenye iframe ya cross-origin hauwezi kuita kitendakazi kwenye ukurasa wa juu moja kwa moja, kwa hiyo hauwezi kuita tu __tcfapi au __gpp na kusoma chaguo la mgeni.

Mifumo ya IAB hutatua hili kwa utaratibu mdogo, uliofafanuliwa vizuri wa kutuma ujumbe. Ikiwa unajenga bidhaa za matangazo, embed au hati za kupima zinazoendeshwa kwenye fremu, au unatatua mifumo ya matangazo inayofanya hivyo, inafaa kujua hasa jinsi inavyofanya kazi.

Fremu ya Locator

Pamoja na JavaScript API, CMP ya TCF huongeza iframe tupu isiyoonekana iitwayo __tcfapiLocator kwenye ukurasa wa ngazi ya juu. CMP ya GPP hufanya vivyo hivyo kwa fremu iitwayo __gppLocator. Fremu hizi hazina maudhui. Kazi yake pekee ni kuweza kupatikana: hati yoyote katika fremu yoyote iliyoingizwa ndani inaweza kupanda juu kwenye mpangilio wa madirisha na kuangalia kama fremu yenye jina hilo ipo katika kila ngazi.

Kwa kuwa majina ya fremu yanaonekana kati ya origin kupitia window.frames, hati iliyo kwenye iframe ya cross-origin iliyoingizwa ndani kabisa inaweza kupata dirisha linalopangisha CMP bila kuwa na ufikiaji wa kitu kingine chochote kwenye ukurasa huo.

Jinsi Hati Iliyo kwenye Fremu Inavyoipata CMP

  1. Anza na dirisha la sasa. Ikiwa __tcfapi ipo kwa ndani, itumie moja kwa moja — hati haiko kwenye fremu, au fremu inashiriki CMP.
  2. Vinginevyo, zunguka kwenda juu: angalia kama dirisha la sasa lina fremu iitwayo __tcfapiLocator; ikiwa halina, nenda kwa window.parent na uangalie tena, ukisimama kwenye dirisha la juu.
  3. Locator inapopatikana, dirisha linalolibeba ndilo dirisha la CMP. Mawasiliano sasa hufanyika kupitia postMessage.

Funika kila ufikiaji kwa try/catch, kwa sababu vivinjari au mipangilio fulani ya sandbox hutoa hitilafu kwenye ufikiaji wa sifa za cross-origin, na simamisha mzunguko wakati window.parent ni sawa na dirisha la sasa.

Muundo wa Ujumbe

Kwa TCF, hati iliyo kwenye fremu hutuma ujumbe kwa dirisha la CMP wenye kitu chenye sifa ya __tcfapiCall. Ndani yake kuna sehemu nne:

CMP husikiliza ujumbe huu, huendesha amri, na hutuma nyuma kitu chenye sifa ya __tcfapiReturn kinachobeba returnValue, success na callId ileile. Mwitaji huhifadhi ramani ya callback zinazosubiri zenye ufunguo wa callId, husikiliza matukio ya message, na hupeleka kila jibu kwa callback sahihi. GPP hufuata mfumo huohuo kwa __gppCall na __gppReturn.

Miunganisho mingi huandika proxy ndogo: kitendakazi cha ndani kiitwacho __tcfapi ndani ya fremu kinachotafsiri miito kuwa ujumbe. Msimbo ulioandikwa kwa dirisha la juu kisha hufanya kazi bila mabadiliko ndani ya fremu.

Wasikilizaji wa Matukio Kati ya Fremu

Mwito wa addEventListener uliotumwa kupitia postMessage si ombi la mara moja. CMP itatuma ujumbe wa jibu kila mara hali ya idhini inapobadilika, yote yakiwa na callId ileile. Kwa hiyo mpeleka-majibu wako lazima aendelee kuhifadhi callback hiyo badala ya kuifuta baada ya jibu la kwanza. Kusahau hili ni hitilafu ya kawaida: hati iliyo kwenye fremu inasoma idhini mara moja na haitambui kamwe kuondolewa kwa idhini baadaye.

Mambo ya Usalama

Mahali Ambapo Mfumo Huu Haufiki

Mazingira mengine ya matangazo hutenga kreatifu kwa ukali zaidi. Kontena za SafeFrame, iframe zilizowekwa kwenye sandbox bila ruhusa sahihi, na kreatifu zinazoonyeshwa kwenye hati tofauti zinaweza kushindwa kupitia mti wa fremu au kupokea ujumbe. Katika hali hizo, ishara ya idhini kwa kawaida lazima ipitishwe kwa uwazi, kwa mfano kama vigezo kwenye ombi la tangazo au thamani anazopewa kreatifu na seva ya matangazo, kama vigezo vya gdpr na gdpr_consent ambavyo lebo nyingi za matangazo huviunga mkono.

Orodha ya Ukaguzi wa Kutatua Hitilafu

Mambo Muhimu ya Kukumbuka

← Blogu Soma Zote →