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-ஐ எவ்வாறு கண்டறிகிறது

  1. தற்போதைய சாளரத்திலிருந்து தொடங்குங்கள். __tcfapi உள்ளூரில் இருந்தால் நேரடியாகப் பயன்படுத்துங்கள் — ஸ்கிரிப்ட் ஃபிரேமில் இல்லை, அல்லது ஃபிரேம் CMP-ஐப் பகிர்கிறது.
  2. இல்லையெனில் மேல்நோக்கி loop செய்யுங்கள்: தற்போதைய சாளரத்தில் __tcfapiLocator என்ற பெயரிலான ஃபிரேம் உள்ளதா எனப் பாருங்கள்; இல்லையெனில் window.parent-க்குச் சென்று மீண்டும் பாருங்கள், மேல்நிலைச் சாளரத்தில் நிறுத்துங்கள்.
  3. locator கிடைத்ததும், அதைக் கொண்டுள்ள சாளரமே CMP-இன் சாளரம். தொடர்பு இப்போது postMessage வழியாக நடைபெறுகிறது.

ஒவ்வொரு அணுகலையும் try/catch-இல் சுற்றுங்கள், ஏனெனில் சில உலாவிகள் அல்லது sandbox அமைப்புகள் cross-origin பண்பு அணுகலில் பிழையை எழுப்பும், window.parent தற்போதைய சாளரத்துக்குச் சமமானதும் loop-ஐ நிறுத்துங்கள்.

செய்தி வடிவம்

TCF-க்கு, ஃபிரேம் ஸ்கிரிப்ட் __tcfapiCall பண்புடைய ஆப்ஜெக்ட் கொண்ட செய்தியை CMP சாளரத்துக்கு அனுப்புகிறது. அதற்குள் நான்கு புலங்கள் உள்ளன:

CMP இந்தச் செய்திகளைக் கேட்டு, கட்டளையை இயக்கி, returnValue, success மற்றும் அதே callId கொண்ட __tcfapiReturn பண்புடைய ஆப்ஜெக்டைத் திருப்பி அனுப்புகிறது. அழைப்பவர் callId மூலம் குறிக்கப்பட்ட நிலுவையிலுள்ள callback-களின் வரைபடத்தை வைத்து, message நிகழ்வுகளைக் கவனித்து, ஒவ்வொரு return-ஐயும் சரியான callback-க்கு அனுப்புகிறார். GPP இதே வடிவத்தை __gppCall மற்றும் __gppReturn உடன் பின்பற்றுகிறது.

பல ஒருங்கிணைப்புகள் ஒரு சிறிய proxy-ஐ எழுதுகின்றன: ஃபிரேமுக்குள் அழைப்புகளைச் செய்திகளாக மாற்றும் __tcfapi என்ற உள்ளூர் செயல்பாடு. மேல்நிலைச் சாளரத்துக்கு எழுதப்பட்ட குறியீடு அப்போது ஃபிரேமுக்குள் மாற்றமின்றி வேலை செய்கிறது.

ஃபிரேம்கள் முழுவதும் நிகழ்வு listener-கள்

postMessage வழியாக அனுப்பப்படும் addEventListener அழைப்பு ஒருமுறை கோரிக்கை அல்ல. ஒப்புதல் நிலை மாறும் ஒவ்வொரு முறையும் CMP ஒரு return செய்தியை அனுப்பும், அனைத்தும் ஒரே callId உடன். எனவே உங்கள் dispatcher அந்த callback-ஐ முதல் பதிலுக்குப் பின் நீக்காமல் பதிவில் வைத்திருக்க வேண்டும். இதை மறப்பது ஒரு பாரம்பரியப் பிழை: ஃபிரேம் ஸ்கிரிப்ட் ஒப்புதலை ஒருமுறை படிக்கிறது, பின்னர் வரும் திரும்பப் பெறுதலை ஒருபோதும் கவனிப்பதில்லை.

பாதுகாப்புக் கருத்துகள்

இந்த வடிவம் எட்டாத இடங்கள்

சில விளம்பரச் சூழல்கள் creative-களை இன்னும் கடுமையாகத் தனிமைப்படுத்துகின்றன. SafeFrame கொள்கலன்கள், சரியான அனுமதிகள் இல்லாத sandbox செய்யப்பட்ட iframe-கள், தனி ஆவணங்களில் ரெண்டர் ஆகும் creative-கள் ஃபிரேம் மரத்தில் ஏற அல்லது செய்திகளைப் பெற முடியாமல் போகலாம். அந்த நிலைகளில் ஒப்புதல் சிக்னல் பொதுவாக வெளிப்படையாக அனுப்பப்பட வேண்டும், எடுத்துக்காட்டாக விளம்பரக் கோரிக்கையின் அளவுருக்களாக அல்லது பல விளம்பரக் குறிச்சொற்கள் ஆதரிக்கும் gdpr மற்றும் gdpr_consent அளவுருக்கள் போல, விளம்பர சேவையகம் creative-க்கு வழங்கும் மதிப்புகளாக.

டிபக்கிங் சரிபார்ப்புப் பட்டியல்

முக்கிய குறிப்புகள்

← வலைப்பதிவு அனைத்தையும் படிக்க →