ক্রস-অরিজিন iframe-এর ভেতরে সম্মতি: __tcfapiLocator ও __gppLocator প্যাটার্ন

সমস্যা: সম্মতি থাকে টপ উইন্ডোতে

CMP আপনার পেজে, টপ-লেভেল উইন্ডোতে চলে। আপনার বিজ্ঞাপনের বড় অংশ সেখানে চলে না। ডিসপ্লে ক্রিয়েটিভ, রিচ মিডিয়া, হেডার বিডিং রেন্ডারার এবং অনেক তৃতীয়-পক্ষ উইজেট iframe-এর ভেতরে চলে, প্রায়ই ভিন্ন অরিজিনে। ক্রস-অরিজিন iframe-এর কোড প্যারেন্ট পেজের কোনো ফাংশন সরাসরি কল করতে পারে না, তাই সে সরাসরি __tcfapi বা __gpp কল করে ভিজিটরের পছন্দ পড়তে পারে না।

IAB ফ্রেমওয়ার্কগুলো একটি ছোট, সুসংজ্ঞায়িত বার্তা-আদান-প্রদানের রীতি দিয়ে এর সমাধান করে। আপনি যদি ফ্রেমে চলা অ্যাড প্রোডাক্ট, এমবেড বা পরিমাপ স্ক্রিপ্ট তৈরি করেন, বা সেগুলো চালানো অ্যাড স্ট্যাক ডিবাগ করেন, তাহলে এটি ঠিক কীভাবে কাজ করে তা জানা কাজের।

Locator ফ্রেম

JavaScript API-র পাশাপাশি TCF CMP টপ-লেভেল পেজে __tcfapiLocator নামের একটি ফাঁকা, অদৃশ্য iframe যোগ করে। GPP CMP একই কাজ করে __gppLocator নামের ফ্রেম দিয়ে। এই ফ্রেমগুলোতে কোনো কনটেন্ট থাকে না। এদের একমাত্র কাজ খুঁজে পাওয়া যাওয়া: যেকোনো নেস্টেড ফ্রেমের যেকোনো স্ক্রিপ্ট উইন্ডো স্তরক্রমে উপরে উঠে প্রতিটি স্তরে পরীক্ষা করতে পারে ওই নামের ফ্রেম আছে কি না।

ফ্রেমের নাম window.frames-এর মাধ্যমে অরিজিন পেরিয়ে দৃশ্যমান হওয়ায় গভীরভাবে নেস্টেড ক্রস-অরিজিন iframe-এর স্ক্রিপ্ট ওই পেজের অন্য কিছুতে অ্যাক্সেস ছাড়াই CMP-র হোস্ট উইন্ডো খুঁজে পেতে পারে।

ফ্রেমের স্ক্রিপ্ট CMP কীভাবে খুঁজে পায়

  1. বর্তমান উইন্ডো দিয়ে শুরু করুন। __tcfapi স্থানীয়ভাবে থাকলে সরাসরি ব্যবহার করুন — স্ক্রিপ্ট ফ্রেমে নেই, বা ফ্রেম CMP ভাগ করে নিচ্ছে।
  2. নইলে উপরের দিকে লুপ চালান: বর্তমান উইন্ডোতে __tcfapiLocator নামের ফ্রেম আছে কি না দেখুন; না থাকলে window.parent-এ যান এবং আবার দেখুন, টপ উইন্ডোতে থেমে।
  3. locator পাওয়া গেলে যে উইন্ডোতে সেটি আছে সেটিই CMP-র উইন্ডো। যোগাযোগ এখন postMessage-এর মাধ্যমে হয়।

প্রতিটি অ্যাক্সেস try/catch-এ মুড়ে নিন, কারণ কিছু ব্রাউজার বা স্যান্ডবক্সিং সেটিং ক্রস-অরিজিন প্রপার্টি অ্যাক্সেসে এরর ছোড়ে, এবং window.parent বর্তমান উইন্ডোর সমান হলে লুপ থামান।

বার্তার ফরম্যাট

TCF-এর জন্য ফ্রেমের স্ক্রিপ্ট CMP উইন্ডোতে __tcfapiCall প্রপার্টিযুক্ত একটি অবজেক্টসহ বার্তা পোস্ট করে। এর ভেতরে চারটি ফিল্ড থাকে:

CMP এই বার্তাগুলো শোনে, কমান্ড চালায়, এবং returnValue, success ও একই callId সহ __tcfapiReturn প্রপার্টিযুক্ত একটি অবজেক্ট ফেরত পোস্ট করে। কলার callId দিয়ে চিহ্নিত অপেক্ষমাণ callback-এর একটি ম্যাপ রাখে, message ইভেন্ট শোনে, এবং প্রতিটি রিটার্ন সঠিক callback-এ পাঠায়। GPP একই প্যাটার্ন অনুসরণ করে __gppCall ও __gppReturn দিয়ে।

অনেক ইন্টিগ্রেশন একটি ছোট প্রক্সি লেখে: ফ্রেমের ভেতরে __tcfapi নামের একটি স্থানীয় ফাংশন, যা কলগুলোকে বার্তায় রূপান্তর করে। টপ উইন্ডোর জন্য লেখা কোড তখন ফ্রেমের ভেতরে অপরিবর্তিত কাজ করে।

ফ্রেমজুড়ে ইভেন্ট listener

postMessage-এর মাধ্যমে পাঠানো addEventListener কল একবারের অনুরোধ নয়। সম্মতির অবস্থা বদলালেই CMP একটি রিটার্ন বার্তা পোস্ট করবে, সবগুলোতে একই callId থাকবে। তাই আপনার dispatcher-কে প্রথম উত্তরের পর সেটি মুছে না ফেলে callback নিবন্ধিত রাখতে হবে। এটি ভুলে যাওয়া একটি চিরাচরিত বাগ: ফ্রেমের স্ক্রিপ্ট একবার সম্মতি পড়ে এবং পরবর্তী প্রত্যাহার কখনও টের পায় না।

নিরাপত্তা বিবেচনা

যেখানে এই প্যাটার্ন পৌঁছায় না

কিছু অ্যাড পরিবেশ ক্রিয়েটিভকে আরও কঠোরভাবে আলাদা করে। SafeFrame কন্টেইনার, সঠিক অনুমতি ছাড়া স্যান্ডবক্স করা iframe এবং আলাদা ডকুমেন্টে রেন্ডার হওয়া ক্রিয়েটিভ ফ্রেম ট্রি বেয়ে উঠতে বা বার্তা পেতে অক্ষম হতে পারে। সেসব ক্ষেত্রে সম্মতি সিগন্যাল সাধারণত স্পষ্টভাবে পাঠাতে হয়, উদাহরণস্বরূপ বিজ্ঞাপন অনুরোধের প্যারামিটার হিসেবে বা অ্যাড সার্ভার ক্রিয়েটিভকে যে মান দেয় সেভাবে, যেমন অনেক অ্যাড ট্যাগ সমর্থন করা gdpr ও gdpr_consent প্যারামিটার।

ডিবাগিং চেকলিস্ট

মূল কথা

← ব্লগ সবগুলো পড়ুন →