کراس اوریجن iframes کے اندر رضامندی: __tcfapiLocator اور __gppLocator کا نمونہ

مسئلہ: رضامندی ٹاپ ونڈو میں رہتی ہے

CMP آپ کے صفحے پر، ٹاپ لیول ونڈو میں چلتا ہے۔ آپ کی بہت سی اشتہاری سرگرمی ایسا نہیں کرتی۔ ڈسپلے کریٹیوز، ریچ میڈیا، header bidding رینڈررز اور بہت سے تیسرے فریق کے ویجٹس iframes کے اندر چلتے ہیں، اکثر کسی مختلف origin پر۔ کراس اوریجن iframe میں موجود کوڈ پیرنٹ صفحے پر کسی فنکشن کو براہِ راست کال نہیں کر سکتا، لہٰذا وہ محض __tcfapi یا __gpp کو کال کر کے وزیٹر کا انتخاب نہیں پڑھ سکتا۔

IAB فریم ورکس اس کو ایک چھوٹی، اچھی طرح متعین میسجنگ روایت سے حل کرتے ہیں۔ اگر آپ ایسی اشتہاری مصنوعات، ایمبیڈز یا پیمائش کی اسکرپٹس بناتے ہیں جو فریمز میں چلتی ہیں، یا ایسے ایڈ اسٹیکس کو ڈیبگ کرتے ہیں جو ایسا کرتے ہیں، تو یہ جاننا مفید ہے کہ یہ بالکل کیسے کام کرتا ہے۔

Locator فریم

JavaScript API کے ساتھ ساتھ TCF CMP ٹاپ لیول صفحے میں __tcfapiLocator نامی ایک خالی، غیر مرئی iframe شامل کرتا ہے۔ GPP CMP __gppLocator نامی فریم کے ساتھ یہی کرتا ہے۔ ان فریمز میں کوئی مواد نہیں ہوتا۔ ان کا واحد کام ڈھونڈے جانے کے قابل ہونا ہے: کوئی بھی اسکرپٹ، کسی بھی تہہ دار فریم میں، ونڈو ہائرارکی میں اوپر چڑھ سکتی ہے اور ہر سطح پر چیک کر سکتی ہے کہ آیا اس نام کا فریم موجود ہے۔

چونکہ فریم کے نام window.frames کے ذریعے origins کے پار نظر آتے ہیں، گہرائی میں تہہ دار کراس اوریجن iframe کی اسکرپٹ اس ونڈو کو تلاش کر سکتی ہے جو CMP کی میزبانی کرتی ہے، اس صفحے پر کسی اور چیز تک رسائی کے بغیر۔

فریم میں موجود اسکرپٹ CMP کو کیسے ڈھونڈتی ہے

  1. موجودہ ونڈو سے شروع کریں۔ اگر __tcfapi مقامی طور پر موجود ہے تو اسے براہِ راست استعمال کریں — اسکرپٹ فریم میں نہیں ہے، یا فریم CMP شیئر کرتا ہے۔
  2. ورنہ اوپر کی طرف لوپ کریں: چیک کریں کہ آیا موجودہ ونڈو میں __tcfapiLocator نامی فریم ہے؛ اگر نہیں تو window.parent پر جائیں اور دوبارہ چیک کریں، اور ٹاپ ونڈو پر رک جائیں۔
  3. جب locator مل جائے تو جس ونڈو میں وہ ہے وہی CMP کی ونڈو ہے۔ اب رابطہ postMessage کے ذریعے ہوتا ہے۔

ہر رسائی کو try/catch میں لپیٹیں، کیونکہ بعض براؤزرز یا sandboxing سیٹنگز کراس اوریجن پراپرٹی تک رسائی پر ایرر پھینکتی ہیں، اور جب window.parent موجودہ ونڈو کے برابر ہو تو لوپ روک دیں۔

پیغام کی ساخت

TCF کے لیے فریم کی اسکرپٹ CMP ونڈو کو ایک پیغام بھیجتی ہے جس میں __tcfapiCall پراپرٹی والا آبجیکٹ ہوتا ہے۔ اس کے اندر چار فیلڈز ہیں:

CMP ان پیغامات کو سنتا ہے، کمانڈ چلاتا ہے، اور __tcfapiReturn پراپرٹی والا آبجیکٹ واپس پوسٹ کرتا ہے جس میں returnValue، success اور وہی callId ہوتے ہیں۔ کال کرنے والا زیرِ التوا callbacks کا نقشہ callId کی کلید کے ساتھ رکھتا ہے، message ایونٹس سنتا ہے، اور ہر واپسی کو درست callback تک پہنچاتا ہے۔ GPP یہی نمونہ __gppCall اور __gppReturn کے ساتھ اپناتا ہے۔

بہت سی انٹیگریشنز ایک چھوٹا proxy لکھتی ہیں: فریم کے اندر __tcfapi نامی مقامی فنکشن جو کالز کو پیغامات میں بدلتا ہے۔ تب ٹاپ ونڈو کے لیے لکھا گیا کوڈ فریم کے اندر بغیر تبدیلی کے کام کرتا ہے۔

فریمز کے پار ایونٹ لسنرز

postMessage کے ذریعے بھیجی گئی addEventListener کال ایک بار کی درخواست نہیں ہے۔ CMP ہر بار جب رضامندی کی حالت بدلے ایک واپسی کا پیغام پوسٹ کرے گا، سب ایک ہی callId کے ساتھ۔ لہٰذا آپ کے ڈسپیچر کو اس callback کو پہلے جواب کے بعد حذف کرنے کی بجائے رجسٹرڈ رکھنا چاہیے۔ اسے بھول جانا کلاسیکی بگ ہے: فریم کی اسکرپٹ رضامندی ایک بار پڑھتی ہے اور بعد کی واپسی کو کبھی محسوس نہیں کرتی۔

سیکیورٹی کے تحفظات

جہاں یہ نمونہ نہیں پہنچتا

بعض اشتہاری ماحول کریٹیوز کو زیادہ سختی سے الگ کرتے ہیں۔ SafeFrame کنٹینرز، صحیح اجازتوں کے بغیر sandboxed iframes، اور الگ دستاویزات میں رینڈر ہونے والے کریٹیوز فریم ٹری پر چلنے یا پیغامات وصول کرنے سے قاصر ہو سکتے ہیں۔ ان صورتوں میں رضامندی کا سگنل عموماً صراحت سے دینا پڑتا ہے، مثلاً اشتہاری درخواست پر پیرامیٹرز کے طور پر یا ایڈ سرور کی کریٹیو کو دی گئی قدروں کے طور پر، جیسے gdpr اور gdpr_consent پیرامیٹرز جنہیں بہت سے اشتہاری ٹیگز سپورٹ کرتے ہیں۔

ڈیبگنگ چیک لسٹ

اہم نکات

← بلاگ سب پڑھیں →