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
- Anza na dirisha la sasa. Ikiwa __tcfapi ipo kwa ndani, itumie moja kwa moja — hati haiko kwenye fremu, au fremu inashiriki CMP.
- 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.
- 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:
- command — kwa mfano getTCData, ping au addEventListener;
- parameter — hoja yoyote ambayo amri inahitaji, au null;
- version — toleo la API, 2 kwa TCF v2;
- callId — thamani ya kipekee inayozalishwa na mwitaji.
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
- Thibitisha umbo la ujumbe. Puuza ujumbe wowote usio na sifa inayotarajiwa, na changanua mizigo ya mifuatano kwa tahadhari, kwa kuwa utekelezaji mwingine hutuma mifuatano ya JSON badala ya vitu.
- Usiamini kwa upofu. Ukurasa wowote unaweza kutuma ujumbe kwenye fremu yako. Chukulia majibu kama ishara za idhini za kuheshimiwa, si data iliyothibitishwa, na usiziruhusu kamwe kuamsha vitendo vya kipekee.
- Tumia origin lengwa mahususi inapowezekana. Origin ya CMP inapojulikana, tuma kwake badala ya kila origin.
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
- Kwenye DevTools ya dirisha la juu, thibitisha kuwa fremu za locator zipo kwenye paneli ya Elements.
- Badilisha muktadha wa konsoli hadi iframe na uangalie kama locator inafikika kutoka hapo.
- Rekodi matukio ya message yanayoingia kwenye madirisha yote mawili ili kuthibitisha kuwa miito na majibu yanatiririka.
- Badilisha idhini kwenye bango na uthibitishe kuwa wasikilizaji walio kwenye fremu wanapokea sasisho.
- Jaribu CMP ikipakiwa kuchelewa, ili kuhakikisha msimbo ulio kwenye fremu unajaribu tena au kusubiri badala ya kukata tamaa mara moja.
Mambo Muhimu ya Kukumbuka
- Fremu za cross-origin huifikia CMP kupitia fremu za __tcfapiLocator na __gppLocator.
- Miito na majibu hutumia postMessage pamoja na __tcfapiCall/__tcfapiReturn au vinavyolingana navyo vya GPP, vinavyolinganishwa kwa callId.
- Weka callback za wasikilizaji zikiwa zimesajiliwa ili mabadiliko ya idhini ya baadaye yafike.
- Thibitisha kila ujumbe na uepuke kuuchukulia kama pembejeo inayoaminika.
- Pale fremu zimetengwa kabisa, pitisha idhini kwa uwazi kwenye ombi la tangazo.