உலாவி கன்சோலில் IAB GPP ஸ்ட்ரிங்கை டிபக் செய்தல்: படிப்படியான பயிற்சி
GPP சிக்கல்களைக் கண்டறிவது ஏன் கடினம்
அமெரிக்கப் பார்வையாளர் தனது தரவின் விற்பனை அல்லது பகிர்விலிருந்து விலகும்போது, அந்தத் தேர்வு பக்கத்திலுள்ள ஒவ்வொரு விளம்பரக் கூட்டாளியையும் சென்றடைய வேண்டும். IAB Global Privacy Platform (GPP)-இல் அது ஒரு சுருக்கமான ஸ்ட்ரிங்காகவும் பிரிவு ID-களின் பட்டியலாகவும் பயணிக்கிறது. இவற்றில் ஏதேனும் தவறாக இருந்தால் — காணாமல், பழையதாக அல்லது தவறான பிரிவைக் கொண்டிருந்தால் — கண்ணுக்குத் தெரியும்படி எதுவும் உடைவதில்லை. விளம்பரங்கள் இன்னும் ஏற்றப்படுகின்றன, பேனர் இன்னும் சரியாகத் தெரிகிறது, கூட்டாளிகள் விலகல்களைப் புறக்கணிக்கும்போதோ உங்கள் இன்வெண்டரியில் குறைவாக ஏலம் கேட்கும்போதோ தான் பிரச்சனை பின்னர் வெளிப்படுகிறது.
நல்ல செய்தி என்னவென்றால், கிட்டத்தட்ட அனைத்தையும் உலாவி கன்சோலிலிருந்தே ஆய்வு செய்யலாம். நேரலைப் பக்கத்தில் நாங்கள் இயக்கும் வரிசையில் இந்தப் பயிற்சி சோதனைகளை விளக்குகிறது.
படி 1: API இருக்கிறதா, தயாராக இருக்கிறதா என உறுதிசெய்யுங்கள்
GPP-இணக்கமான CMP ஒரு உலகளாவிய __gpp செயல்பாட்டை வெளிப்படுத்துகிறது. உங்கள் பக்கத்தில் DevTools-ஐத் திறந்து ping கட்டளையை இயக்குங்கள்:
__gpp('ping', function (data) { console.log(data); });
திரும்பும் ஆப்ஜெக்ட் ஒரே பார்வையில் நிறைய சொல்கிறது:
- gppVersion — தற்போதைய செயலாக்கங்களுக்கு 1.1 எனக் காட்ட வேண்டும்.
- cmpStatus — CMP ஏற்றப்பட்டதா அல்லது பிழையைச் சந்தித்ததா.
- cmpDisplayStatus — இந்தப் பார்வையாளருக்கு பேனர் தெரிகிறதா, மறைக்கப்பட்டதா அல்லது முடக்கப்பட்டதா.
- signalStatus — CMP ஒப்புதல் நிலையை முடிவு செய்தவுடன் “ready”, இன்னும் முடிவெடுக்கும்போது “not ready”.
- supportedAPIs — CMP உருவாக்கக்கூடிய பிரிவுகள்.
- applicableSections — இந்தப் பார்வையாளருக்கு இப்போது பொருந்தும் பிரிவு ID-கள்.
- gppString — குறியாக்கப்பட்ட ஸ்ட்ரிங் தானே.
__gpp undefined எனில், CMP stub காணவில்லை அல்லது மிகத் தாமதமாக ஏற்றப்படுகிறது. அதை எதிர்பார்க்கும் எந்த விளம்பர ஸ்கிரிப்டுக்கும் முன்பே stub இடத்தில் இருக்க வேண்டும், இல்லையெனில் அந்த ஸ்கிரிப்டுகள் CMP-ஐப் பார்க்காது, காத்திருக்கும் அல்லது சிக்னல் இல்லாமல் தொடரும்.
படி 2: பொருந்தும் பிரிவைச் சரிபார்க்கவும்
GPP-இல் ஒவ்வொரு தனியுரிமைக் கட்டமைப்புக்கும் ஒரு எண் பிரிவு ID உள்ளது. வெளியீட்டாளர்கள் பெரும்பாலும் சந்திப்பவை 2 (EU TCF v2), 5 (கனடிய TCF), 7 (US National, “usnat”), மேலும் கலிபோர்னியா, வர்ஜீனியா, கொலராடோ, யூட்டா, கனெக்டிகட் போன்ற தனிப்பட்ட மாநிலப் பிரிவுகளுக்கு 8 முதல். அமெரிக்க மாநிலத்தைச் சேர்ந்த பார்வையாளருக்கு applicableSections-இல் பொதுவாக தேசியப் பிரிவு அல்லது தொடர்புடைய மாநிலப் பிரிவு தெரிய வேண்டும், EU பிரிவு அல்ல.
பல இடங்களிலிருந்து சோதியுங்கள். பொதுவான பிழை என்னவென்றால், CMP பேனருக்கு புவியியலைச் சரியாகக் கண்டறிகிறது ஆனால் எப்படியிருந்தாலும் ஸ்ட்ரிங்கில் இயல்புநிலைப் பிரிவை எழுதுகிறது, அல்லது தலைகீழாக. VPN அல்லது உங்கள் CMP-இன் முன்னோட்டக் கருவிகளைப் பயன்படுத்தி, பேனர் காட்டுவதை applicableSections தெரிவிப்பதுடன் ஒப்பிடுங்கள்.
படி 3: பிரிவுத் தரவைப் படியுங்கள்
ஸ்ட்ரிங்கைக் கையால் டிகோட் செய்வதற்குப் பதிலாக, பகுப்பாய்வு செய்யப்பட்ட பிரிவை CMP-இடம் கேளுங்கள்:
__gpp('getSection', function (data, success) { console.log(data, success); }, 'usnat');
US National பிரிவில், விலகல் புலங்கள் எளிய மரபைப் பயன்படுத்துகின்றன: 0 என்றால் பொருந்தாது, 1 என்றால் பயனர் விலகினார், 2 என்றால் பயனர் விலகவில்லை. முதலில் இந்தப் புலங்களில் கவனம் செலுத்துங்கள்:
- SaleOptOut மற்றும் SharingOptOut
- TargetedAdvertisingOptOut
- ஒவ்வொரு நடைமுறைக்கும் பார்வையாளருக்கு அறிவிப்பு வழங்கப்பட்டதா எனப் பதிவு செய்யும் தொடர்புடைய notice புலங்கள்
இப்போது பக்கத்தில் விலகலைச் செய்யுங்கள் — உங்கள் “Do Not Sell or Share” இணைப்பைக் கிளிக் செய்யுங்கள் அல்லது விருப்பத்தேர்வு மையத்தில் அமைப்பை மாற்றுங்கள் — மீண்டும் getSection-ஐ இயக்குங்கள். விலகல் புலங்கள் 2-இலிருந்து 1-க்கு மாற வேண்டும். மாறவில்லை எனில், UI-யும் சிக்னலும் ஒத்திசைவில் இல்லை.
படி 4: Global Privacy Control பாதையைச் சோதியுங்கள்
பல மாநிலச் சட்டங்கள் Global Privacy Control சிக்னலை விலகலாகக் கருத வணிகங்களைக் கோருகின்றன. அதை ஆதரிக்கும் உலாவி அல்லது நீட்டிப்பில் GPC-ஐ இயக்கி, கன்சோலில் navigator.globalPrivacyControl true எனத் திரும்புவதை உறுதிசெய்து, பிறகு புதிய அமர்வில் பக்கத்தை ஏற்றுங்கள். பார்வையாளர் பேனரைத் தொடாமலேயே தொடர்புடைய விலகல் புலங்கள் ஏற்கனவே 1 எனக் காட்ட வேண்டும். சில பிரிவுகளில் தேர்வு GPC சிக்னலிலிருந்து வந்தது என்பதைக் குறிக்கும் புலமும் உள்ளது.
படி 5: ஸ்னாப்ஷாட்கள் மட்டுமல்ல, நிகழ்வுகளையும் கவனியுங்கள்
விளம்பர ஸ்கிரிப்டுகள் பக்க ஏற்றத்தில் ஒருமுறை ஸ்ட்ரிங்கைப் படித்து மறந்துவிடக் கூடாது. கூட்டாளிகள் பார்ப்பதைக் காண ஒரு listener-ஐப் பதிவு செய்யுங்கள்:
__gpp('addEventListener', function (evt) { console.log(evt.eventName, evt.pingData); });
listenerRegistered, signalStatus, sectionChange போன்ற நிகழ்வுகளை நீங்கள் காண வேண்டும். பார்வையாளர் தேர்வை மாற்றும்போது, புதுப்பிக்கப்பட்ட ஸ்ட்ரிங்குடன் sectionChange நிகழ்வு தொடர வேண்டும். உங்கள் ஹெடர் பிடிங் wrapper அல்லது விளம்பர சேவையக ஒருங்கிணைப்பு signalStatus “ready” ஆவதற்கு முன்பே ஸ்ட்ரிங்கைப் படித்தால், அது வெற்று அல்லது காலாவதியான மதிப்பை அனுப்பலாம்.
படி 6: ஸ்ட்ரிங்கை விளம்பரக் கோரிக்கைகளில் பின்தொடருங்கள்
இறுதியாக Network தாவலைத் திறந்து உங்கள் விளம்பரக் கோரிக்கைகளை வடிகட்டுங்கள். பல விளம்பர எண்ட்பாயிண்டுகள் gpp மற்றும் gpp_sid அளவுருக்களை (ஸ்ட்ரிங்கும் பொருந்தும் பிரிவு ID-களும்) ஏற்கின்றன. இவற்றைச் சரிபார்க்கவும்:
- அமெரிக்கப் பார்வையாளர்களின் கோரிக்கைகளில் இரண்டு அளவுருக்களும் உள்ளன;
- ஸ்ட்ரிங், கோரிக்கையின் நேரத்தில் ping திருப்பியளித்ததுடன் பொருந்துகிறது;
- விலகலுக்குப் பிறகான கோரிக்கைகள் தேக்கிய ஸ்ட்ரிங்கிற்கு பதிலாக புதிய ஸ்ட்ரிங்கைக் கொண்டுள்ளன.
Prebid.js பயன்படுத்தினால், அதன் ஒப்புதல் மேலாண்மை தொகுதி GPP-க்காக உள்ளமைக்கப்பட்டுள்ளதா என உறுதிசெய்து, wrapper-இலிருந்து வெளியேறும் ஏலக் கோரிக்கைகளையும் இறுதி விளம்பர சேவையக அழைப்பையும் ஆய்வு செய்யுங்கள்.
பொதுவான தோல்வி வடிவங்கள்
- stub விளம்பரக் குறிச்சொற்களுக்குப் பிறகு ஏற்றப்படுகிறது — கூட்டாளிகள் CMP-ஐயே பார்ப்பதில்லை.
- பிராந்தியத்துக்குத் தவறான பிரிவு — அமெரிக்க ட்ராஃபிக்குக்கு EU பிரிவு அனுப்பப்படுகிறது, அல்லது பிரிவே இல்லை.
- UI-யும் சிக்னலும் ஒத்திசைவில் இல்லை — டாகிள் மாறுகிறது, ஸ்ட்ரிங் மாறவில்லை.
- GPC புறக்கணிக்கப்படுகிறது — உலாவி சிக்னல் ஒருபோதும் விலகலாக மாறுவதில்லை.
- கோரிக்கைகளில் காலாவதியான ஸ்ட்ரிங்குகள் — wrapper முதலில் பார்த்த மதிப்பைத் தேக்கி வைக்கிறது.
முக்கிய குறிப்புகள்
- ping உடன் தொடங்குங்கள்: பதிப்பு, நிலை, பொருந்தும் பிரிவுகள் மற்றும் ஸ்ட்ரிங் பெரும்பாலான கதையைச் சொல்கின்றன.
- விலகல் புலங்களைப் படிக்க getSection-ஐப் பயன்படுத்துங்கள்; 1 என்றால் விலகினார், 2 என்றால் விலகவில்லை.
- விலகல் இணைப்பையும் GPC-யையும் தனித்தனியாகச் சோதித்து, இரண்டும் சிக்னலை மாற்றுகின்றனவா என உறுதிசெய்யுங்கள்.
- நிகழ்வுகளைக் கவனித்து, விளம்பரக் கோரிக்கைகள் ஸ்ட்ரிங்கைப் படிக்கும் முன் “ready” சிக்னலுக்காகக் காத்திருங்கள்.
- விலகலுக்கு முன்னும் பின்னும் உண்மையான நெட்வொர்க் கோரிக்கைகளில் gpp மற்றும் gpp_sid-ஐச் சரிபாருங்கள்.