Cross-origin iframe-களுக்குள் ஒப்புதல்: __tcfapiLocator மற்றும் __gppLocator வடிவம்
சிக்கல்: ஒப்புதல் மேல்நிலைச் சாளரத்தில் இருக்கிறது
CMP உங்கள் பக்கத்தில், மேல்நிலைச் சாளரத்தில் இயங்குகிறது. உங்கள் விளம்பரங்களில் பெரும்பகுதி அங்கு இயங்குவதில்லை. காட்சி creative-கள், rich media, ஹெடர் பிடிங் renderer-கள் மற்றும் பல மூன்றாம் தரப்பு விட்ஜெட்கள் iframe-களுக்குள் இயங்குகின்றன, பெரும்பாலும் வேறு origin-இல். Cross-origin iframe-இல் உள்ள குறியீடு பெற்றோர் பக்கத்தின் செயல்பாட்டை நேரடியாக அழைக்க முடியாது, எனவே அது நேரடியாக __tcfapi அல்லது __gpp-ஐ அழைத்து பார்வையாளரின் தேர்வைப் படிக்க முடியாது.
IAB கட்டமைப்புகள் இதை சிறிய, நன்கு வரையறுக்கப்பட்ட செய்தியனுப்பும் மரபு மூலம் தீர்க்கின்றன. ஃபிரேம்களில் இயங்கும் விளம்பரத் தயாரிப்புகள், embed-கள் அல்லது அளவீட்டு ஸ்கிரிப்டுகளை உருவாக்கினால், அல்லது அவற்றை இயக்கும் விளம்பர ஸ்டாக்குகளை டிபக் செய்தால், இது சரியாக எவ்வாறு செயல்படுகிறது என்பதை அறிவது பயனுள்ளது.
Locator ஃபிரேம்
JavaScript API-க்கு அருகில், TCF CMP மேல்நிலைப் பக்கத்தில் __tcfapiLocator என்ற பெயரிலான வெற்று, கண்ணுக்குத் தெரியாத iframe-ஐச் சேர்க்கிறது. GPP CMP __gppLocator என்ற பெயரிலான ஃபிரேமுடன் இதையே செய்கிறது. இந்த ஃபிரேம்களில் உள்ளடக்கம் இல்லை. கண்டறியப்படுவதே அவற்றின் ஒரே பணி: எந்த உள்ளமைந்த ஃபிரேமிலுள்ள எந்த ஸ்கிரிப்டும் சாளர அடுக்கில் மேலே சென்று ஒவ்வொரு மட்டத்திலும் அந்தப் பெயரில் ஃபிரேம் உள்ளதா எனச் சரிபார்க்கலாம்.
ஃபிரேம் பெயர்கள் window.frames வழியாக origin-களுக்கு அப்பாலும் தெரிவதால், ஆழமாக உள்ளமைந்த cross-origin iframe-இல் உள்ள ஸ்கிரிப்ட், அந்தப் பக்கத்தில் வேறு எதையும் அணுகாமலேயே CMP-ஐ ஹோஸ்ட் செய்யும் சாளரத்தைக் கண்டறிய முடியும்.
ஃபிரேமில் உள்ள ஸ்கிரிப்ட் CMP-ஐ எவ்வாறு கண்டறிகிறது
- தற்போதைய சாளரத்திலிருந்து தொடங்குங்கள். __tcfapi உள்ளூரில் இருந்தால் நேரடியாகப் பயன்படுத்துங்கள் — ஸ்கிரிப்ட் ஃபிரேமில் இல்லை, அல்லது ஃபிரேம் CMP-ஐப் பகிர்கிறது.
- இல்லையெனில் மேல்நோக்கி loop செய்யுங்கள்: தற்போதைய சாளரத்தில் __tcfapiLocator என்ற பெயரிலான ஃபிரேம் உள்ளதா எனப் பாருங்கள்; இல்லையெனில் window.parent-க்குச் சென்று மீண்டும் பாருங்கள், மேல்நிலைச் சாளரத்தில் நிறுத்துங்கள்.
- locator கிடைத்ததும், அதைக் கொண்டுள்ள சாளரமே CMP-இன் சாளரம். தொடர்பு இப்போது postMessage வழியாக நடைபெறுகிறது.
ஒவ்வொரு அணுகலையும் try/catch-இல் சுற்றுங்கள், ஏனெனில் சில உலாவிகள் அல்லது sandbox அமைப்புகள் cross-origin பண்பு அணுகலில் பிழையை எழுப்பும், window.parent தற்போதைய சாளரத்துக்குச் சமமானதும் loop-ஐ நிறுத்துங்கள்.
செய்தி வடிவம்
TCF-க்கு, ஃபிரேம் ஸ்கிரிப்ட் __tcfapiCall பண்புடைய ஆப்ஜெக்ட் கொண்ட செய்தியை CMP சாளரத்துக்கு அனுப்புகிறது. அதற்குள் நான்கு புலங்கள் உள்ளன:
- command — எடுத்துக்காட்டாக getTCData, ping அல்லது addEventListener;
- parameter — கட்டளைக்குத் தேவையான ஏதேனும் argument, அல்லது null;
- version — API பதிப்பு, TCF v2-க்கு 2;
- callId — அழைப்பவர் உருவாக்கும் தனித்துவ மதிப்பு.
CMP இந்தச் செய்திகளைக் கேட்டு, கட்டளையை இயக்கி, returnValue, success மற்றும் அதே callId கொண்ட __tcfapiReturn பண்புடைய ஆப்ஜெக்டைத் திருப்பி அனுப்புகிறது. அழைப்பவர் callId மூலம் குறிக்கப்பட்ட நிலுவையிலுள்ள callback-களின் வரைபடத்தை வைத்து, message நிகழ்வுகளைக் கவனித்து, ஒவ்வொரு return-ஐயும் சரியான callback-க்கு அனுப்புகிறார். GPP இதே வடிவத்தை __gppCall மற்றும் __gppReturn உடன் பின்பற்றுகிறது.
பல ஒருங்கிணைப்புகள் ஒரு சிறிய proxy-ஐ எழுதுகின்றன: ஃபிரேமுக்குள் அழைப்புகளைச் செய்திகளாக மாற்றும் __tcfapi என்ற உள்ளூர் செயல்பாடு. மேல்நிலைச் சாளரத்துக்கு எழுதப்பட்ட குறியீடு அப்போது ஃபிரேமுக்குள் மாற்றமின்றி வேலை செய்கிறது.
ஃபிரேம்கள் முழுவதும் நிகழ்வு listener-கள்
postMessage வழியாக அனுப்பப்படும் addEventListener அழைப்பு ஒருமுறை கோரிக்கை அல்ல. ஒப்புதல் நிலை மாறும் ஒவ்வொரு முறையும் CMP ஒரு return செய்தியை அனுப்பும், அனைத்தும் ஒரே callId உடன். எனவே உங்கள் dispatcher அந்த callback-ஐ முதல் பதிலுக்குப் பின் நீக்காமல் பதிவில் வைத்திருக்க வேண்டும். இதை மறப்பது ஒரு பாரம்பரியப் பிழை: ஃபிரேம் ஸ்கிரிப்ட் ஒப்புதலை ஒருமுறை படிக்கிறது, பின்னர் வரும் திரும்பப் பெறுதலை ஒருபோதும் கவனிப்பதில்லை.
பாதுகாப்புக் கருத்துகள்
- செய்தியின் வடிவத்தைச் சரிபாருங்கள். எதிர்பார்க்கும் பண்பு இல்லாத எந்தச் செய்தியையும் புறக்கணியுங்கள், string payload-களை எச்சரிக்கையுடன் parse செய்யுங்கள், ஏனெனில் சில செயலாக்கங்கள் ஆப்ஜெக்ட்களுக்குப் பதிலாக JSON string-களை அனுப்புகின்றன.
- கண்மூடித்தனமாக நம்பாதீர்கள். எந்தப் பக்கமும் உங்கள் ஃபிரேமுக்குச் செய்திகளை அனுப்பலாம். பதில்களை மதிக்க வேண்டிய ஒப்புதல் சிக்னல்களாகக் கருதுங்கள், அங்கீகரிக்கப்பட்ட தரவாக அல்ல, அவற்றை ஒருபோதும் சிறப்புரிமைச் செயல்களைத் தூண்ட விடாதீர்கள்.
- முடிந்தவரை குறிப்பிட்ட target origin-ஐப் பயன்படுத்துங்கள். CMP-இன் origin தெரிந்தால், எல்லா origin-களுக்கும் அனுப்பாமல் அதற்கே அனுப்புங்கள்.
இந்த வடிவம் எட்டாத இடங்கள்
சில விளம்பரச் சூழல்கள் creative-களை இன்னும் கடுமையாகத் தனிமைப்படுத்துகின்றன. SafeFrame கொள்கலன்கள், சரியான அனுமதிகள் இல்லாத sandbox செய்யப்பட்ட iframe-கள், தனி ஆவணங்களில் ரெண்டர் ஆகும் creative-கள் ஃபிரேம் மரத்தில் ஏற அல்லது செய்திகளைப் பெற முடியாமல் போகலாம். அந்த நிலைகளில் ஒப்புதல் சிக்னல் பொதுவாக வெளிப்படையாக அனுப்பப்பட வேண்டும், எடுத்துக்காட்டாக விளம்பரக் கோரிக்கையின் அளவுருக்களாக அல்லது பல விளம்பரக் குறிச்சொற்கள் ஆதரிக்கும் gdpr மற்றும் gdpr_consent அளவுருக்கள் போல, விளம்பர சேவையகம் creative-க்கு வழங்கும் மதிப்புகளாக.
டிபக்கிங் சரிபார்ப்புப் பட்டியல்
- மேல்நிலைச் சாளரத்தின் DevTools-இல், Elements பலகத்தில் locator ஃபிரேம்கள் உள்ளனவா என உறுதிசெய்யுங்கள்.
- கன்சோல் சூழலை iframe-க்கு மாற்றி, அங்கிருந்து locator-ஐ அடைய முடிகிறதா எனப் பாருங்கள்.
- அழைப்புகளும் returns-உம் பாய்கின்றனவா என உறுதிசெய்ய இரு சாளரங்களிலும் வரும் message நிகழ்வுகளைப் பதிவு செய்யுங்கள்.
- பேனரில் ஒப்புதலை மாற்றி, ஃபிரேம் listener-கள் புதுப்பிப்பைப் பெறுகின்றனவா எனச் சரிபாருங்கள்.
- CMP தாமதமாக ஏற்றப்படும் நிலையில் சோதியுங்கள், ஃபிரேம் குறியீடு உடனே கைவிடாமல் மீண்டும் முயல்கிறதா அல்லது காத்திருக்கிறதா என உறுதிசெய்ய.
முக்கிய குறிப்புகள்
- Cross-origin ஃபிரேம்கள் __tcfapiLocator மற்றும் __gppLocator ஃபிரேம்கள் வழியாக CMP-ஐ அடைகின்றன.
- அழைப்புகளும் returns-உம் __tcfapiCall/__tcfapiReturn அல்லது GPP இணைகளுடன் postMessage-ஐப் பயன்படுத்துகின்றன, callId மூலம் பொருத்தப்படுகின்றன.
- பின்னர் வரும் ஒப்புதல் மாற்றங்கள் வந்து சேர listener callback-களைப் பதிவில் வைத்திருங்கள்.
- ஒவ்வொரு செய்தியையும் சரிபாருங்கள், நம்பகமான உள்ளீடாகக் கருதாதீர்கள்.
- ஃபிரேம்கள் முழுமையாகத் தனிமைப்படுத்தப்பட்ட இடங்களில், விளம்பரக் கோரிக்கையில் ஒப்புதலை வெளிப்படையாக அனுப்புங்கள்.