ক্রস-অরিজিন iframe-এর ভেতরে সম্মতি: __tcfapiLocator ও __gppLocator প্যাটার্ন
সমস্যা: সম্মতি থাকে টপ উইন্ডোতে
CMP আপনার পেজে, টপ-লেভেল উইন্ডোতে চলে। আপনার বিজ্ঞাপনের বড় অংশ সেখানে চলে না। ডিসপ্লে ক্রিয়েটিভ, রিচ মিডিয়া, হেডার বিডিং রেন্ডারার এবং অনেক তৃতীয়-পক্ষ উইজেট iframe-এর ভেতরে চলে, প্রায়ই ভিন্ন অরিজিনে। ক্রস-অরিজিন iframe-এর কোড প্যারেন্ট পেজের কোনো ফাংশন সরাসরি কল করতে পারে না, তাই সে সরাসরি __tcfapi বা __gpp কল করে ভিজিটরের পছন্দ পড়তে পারে না।
IAB ফ্রেমওয়ার্কগুলো একটি ছোট, সুসংজ্ঞায়িত বার্তা-আদান-প্রদানের রীতি দিয়ে এর সমাধান করে। আপনি যদি ফ্রেমে চলা অ্যাড প্রোডাক্ট, এমবেড বা পরিমাপ স্ক্রিপ্ট তৈরি করেন, বা সেগুলো চালানো অ্যাড স্ট্যাক ডিবাগ করেন, তাহলে এটি ঠিক কীভাবে কাজ করে তা জানা কাজের।
Locator ফ্রেম
JavaScript API-র পাশাপাশি TCF CMP টপ-লেভেল পেজে __tcfapiLocator নামের একটি ফাঁকা, অদৃশ্য iframe যোগ করে। GPP CMP একই কাজ করে __gppLocator নামের ফ্রেম দিয়ে। এই ফ্রেমগুলোতে কোনো কনটেন্ট থাকে না। এদের একমাত্র কাজ খুঁজে পাওয়া যাওয়া: যেকোনো নেস্টেড ফ্রেমের যেকোনো স্ক্রিপ্ট উইন্ডো স্তরক্রমে উপরে উঠে প্রতিটি স্তরে পরীক্ষা করতে পারে ওই নামের ফ্রেম আছে কি না।
ফ্রেমের নাম window.frames-এর মাধ্যমে অরিজিন পেরিয়ে দৃশ্যমান হওয়ায় গভীরভাবে নেস্টেড ক্রস-অরিজিন iframe-এর স্ক্রিপ্ট ওই পেজের অন্য কিছুতে অ্যাক্সেস ছাড়াই CMP-র হোস্ট উইন্ডো খুঁজে পেতে পারে।
ফ্রেমের স্ক্রিপ্ট CMP কীভাবে খুঁজে পায়
- বর্তমান উইন্ডো দিয়ে শুরু করুন। __tcfapi স্থানীয়ভাবে থাকলে সরাসরি ব্যবহার করুন — স্ক্রিপ্ট ফ্রেমে নেই, বা ফ্রেম CMP ভাগ করে নিচ্ছে।
- নইলে উপরের দিকে লুপ চালান: বর্তমান উইন্ডোতে __tcfapiLocator নামের ফ্রেম আছে কি না দেখুন; না থাকলে window.parent-এ যান এবং আবার দেখুন, টপ উইন্ডোতে থেমে।
- locator পাওয়া গেলে যে উইন্ডোতে সেটি আছে সেটিই CMP-র উইন্ডো। যোগাযোগ এখন postMessage-এর মাধ্যমে হয়।
প্রতিটি অ্যাক্সেস try/catch-এ মুড়ে নিন, কারণ কিছু ব্রাউজার বা স্যান্ডবক্সিং সেটিং ক্রস-অরিজিন প্রপার্টি অ্যাক্সেসে এরর ছোড়ে, এবং window.parent বর্তমান উইন্ডোর সমান হলে লুপ থামান।
বার্তার ফরম্যাট
TCF-এর জন্য ফ্রেমের স্ক্রিপ্ট CMP উইন্ডোতে __tcfapiCall প্রপার্টিযুক্ত একটি অবজেক্টসহ বার্তা পোস্ট করে। এর ভেতরে চারটি ফিল্ড থাকে:
- command — যেমন getTCData, ping বা addEventListener;
- parameter — কমান্ডের প্রয়োজনীয় যেকোনো আর্গুমেন্ট, বা null;
- version — API সংস্করণ, TCF v2-এর জন্য 2;
- callId — কলার তৈরি করা একটি অনন্য মান।
CMP এই বার্তাগুলো শোনে, কমান্ড চালায়, এবং returnValue, success ও একই callId সহ __tcfapiReturn প্রপার্টিযুক্ত একটি অবজেক্ট ফেরত পোস্ট করে। কলার callId দিয়ে চিহ্নিত অপেক্ষমাণ callback-এর একটি ম্যাপ রাখে, message ইভেন্ট শোনে, এবং প্রতিটি রিটার্ন সঠিক callback-এ পাঠায়। GPP একই প্যাটার্ন অনুসরণ করে __gppCall ও __gppReturn দিয়ে।
অনেক ইন্টিগ্রেশন একটি ছোট প্রক্সি লেখে: ফ্রেমের ভেতরে __tcfapi নামের একটি স্থানীয় ফাংশন, যা কলগুলোকে বার্তায় রূপান্তর করে। টপ উইন্ডোর জন্য লেখা কোড তখন ফ্রেমের ভেতরে অপরিবর্তিত কাজ করে।
ফ্রেমজুড়ে ইভেন্ট listener
postMessage-এর মাধ্যমে পাঠানো addEventListener কল একবারের অনুরোধ নয়। সম্মতির অবস্থা বদলালেই CMP একটি রিটার্ন বার্তা পোস্ট করবে, সবগুলোতে একই callId থাকবে। তাই আপনার dispatcher-কে প্রথম উত্তরের পর সেটি মুছে না ফেলে callback নিবন্ধিত রাখতে হবে। এটি ভুলে যাওয়া একটি চিরাচরিত বাগ: ফ্রেমের স্ক্রিপ্ট একবার সম্মতি পড়ে এবং পরবর্তী প্রত্যাহার কখনও টের পায় না।
নিরাপত্তা বিবেচনা
- বার্তার গঠন যাচাই করুন। প্রত্যাশিত প্রপার্টি নেই এমন যেকোনো বার্তা উপেক্ষা করুন, এবং স্ট্রিং পেলোড সতর্কভাবে পার্স করুন, কারণ কিছু ইমপ্লিমেন্টেশন অবজেক্টের বদলে JSON স্ট্রিং পাঠায়।
- অন্ধভাবে বিশ্বাস করবেন না। যেকোনো পেজ আপনার ফ্রেমে বার্তা পোস্ট করতে পারে। রেসপন্সকে সম্মান করার মতো সম্মতি সিগন্যাল হিসেবে দেখুন, প্রমাণীকৃত ডেটা হিসেবে নয়, এবং এগুলোকে কখনও বিশেষাধিকারপ্রাপ্ত কাজ চালু করতে দেবেন না।
- যেখানে সম্ভব নির্দিষ্ট টার্গেট অরিজিন ব্যবহার করুন। CMP-র অরিজিন জানা থাকলে সব অরিজিনে না পাঠিয়ে সেটিতেই পোস্ট করুন।
যেখানে এই প্যাটার্ন পৌঁছায় না
কিছু অ্যাড পরিবেশ ক্রিয়েটিভকে আরও কঠোরভাবে আলাদা করে। SafeFrame কন্টেইনার, সঠিক অনুমতি ছাড়া স্যান্ডবক্স করা iframe এবং আলাদা ডকুমেন্টে রেন্ডার হওয়া ক্রিয়েটিভ ফ্রেম ট্রি বেয়ে উঠতে বা বার্তা পেতে অক্ষম হতে পারে। সেসব ক্ষেত্রে সম্মতি সিগন্যাল সাধারণত স্পষ্টভাবে পাঠাতে হয়, উদাহরণস্বরূপ বিজ্ঞাপন অনুরোধের প্যারামিটার হিসেবে বা অ্যাড সার্ভার ক্রিয়েটিভকে যে মান দেয় সেভাবে, যেমন অনেক অ্যাড ট্যাগ সমর্থন করা gdpr ও gdpr_consent প্যারামিটার।
ডিবাগিং চেকলিস্ট
- টপ উইন্ডোর DevTools-এ Elements প্যানেলে নিশ্চিত করুন locator ফ্রেম আছে।
- কনসোলের প্রসঙ্গ iframe-এ বদলান এবং দেখুন সেখান থেকে locator-এ পৌঁছানো যায় কি না।
- দুটি উইন্ডোতেই আসা message ইভেন্ট লগ করুন, কল ও রিটার্ন প্রবাহিত হচ্ছে কি না নিশ্চিত করতে।
- ব্যানারে সম্মতি বদলান এবং যাচাই করুন ফ্রেমের listener হালনাগাদ পায়।
- CMP দেরিতে লোড হওয়ার অবস্থায় পরীক্ষা করুন, ফ্রেমের কোড সঙ্গে সঙ্গে হাল না ছেড়ে পুনরায় চেষ্টা করে বা অপেক্ষা করে কি না নিশ্চিত করতে।
মূল কথা
- ক্রস-অরিজিন ফ্রেম __tcfapiLocator ও __gppLocator ফ্রেমের মাধ্যমে CMP-তে পৌঁছায়।
- কল ও রিটার্ন __tcfapiCall/__tcfapiReturn বা GPP-র সমতুল্যসহ postMessage ব্যবহার করে, callId দিয়ে মেলানো হয়।
- listener callback নিবন্ধিত রাখুন যাতে পরবর্তী সম্মতি পরিবর্তন পৌঁছায়।
- প্রতিটি বার্তা যাচাই করুন এবং একে বিশ্বস্ত ইনপুট ধরবেন না।
- যেখানে ফ্রেম সম্পূর্ণ বিচ্ছিন্ন, সেখানে বিজ্ঞাপন অনুরোধে সম্মতি স্পষ্টভাবে পাঠান।