براؤزر کنسول میں IAB GPP سٹرنگ کی ڈیبگنگ: مرحلہ وار ٹیوٹوریل
GPP کے مسائل پکڑنا مشکل کیوں ہے
جب کوئی امریکی وزیٹر اپنے ڈیٹا کی فروخت یا شیئرنگ سے آپٹ آؤٹ کرتا ہے تو اس انتخاب کو صفحے کے ہر اشتہاری پارٹنر تک پہنچنا چاہیے۔ IAB Global Privacy Platform (GPP) کے ساتھ یہ ایک مختصر سٹرنگ اور سیکشن IDs کی فہرست کی شکل میں سفر کرتا ہے۔ اگر ان میں سے کوئی بھی غلط ہو — غائب، پرانا یا غلط سیکشن لیے ہوئے — تو بظاہر کچھ نہیں ٹوٹتا۔ اشتہارات پھر بھی لوڈ ہوتے ہیں، بینر پھر بھی ٹھیک نظر آتا ہے، اور مسئلہ بعد میں اس صورت میں ظاہر ہوتا ہے کہ پارٹنرز آپٹ آؤٹ کو نظر انداز کرتے ہیں یا آپ کے انوینٹری پر کم بولی لگاتے ہیں۔
اچھی خبر یہ ہے کہ آپ تقریباً ہر چیز کا براؤزر کنسول سے معائنہ کر سکتے ہیں۔ یہ ٹیوٹوریل جانچوں کو اسی ترتیب سے بیان کرتا ہے جس میں ہم انہیں لائیو صفحے پر چلاتے ہیں۔
مرحلہ 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 — وہ سیکشن IDs جو اس وقت اس وزیٹر پر لاگو ہوتے ہیں۔
- gppString — انکوڈ شدہ سٹرنگ خود۔
اگر __gpp غیر متعین ہے تو 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 ایونٹ آنا چاہیے۔ اگر آپ کا header bidding wrapper یا ایڈ سرور انٹیگریشن سٹرنگ صرف signalStatus کے “ready” ہونے سے پہلے پڑھتی ہے تو وہ خالی یا پرانی قدر بھیج سکتی ہے۔
مرحلہ 6: سٹرنگ کو اشتہاری درخواستوں تک فالو کریں
آخر میں Network ٹیب کھولیں اور اپنی اشتہاری درخواستوں کو فلٹر کریں۔ بہت سے اشتہاری endpoints gpp اور gpp_sid پیرامیٹرز (سٹرنگ اور قابلِ اطلاق سیکشن IDs) قبول کرتے ہیں۔ چیک کریں کہ:
- دونوں پیرامیٹرز امریکی وزیٹرز کی درخواستوں میں موجود ہیں؛
- سٹرنگ درخواست کے وقت ping کی واپس کردہ سٹرنگ سے مماثل ہے؛
- آپٹ آؤٹ کے بعد بعد کی درخواستیں کیشڈ سٹرنگ کی بجائے نئی سٹرنگ لے جاتی ہیں۔
اگر آپ Prebid.js استعمال کرتے ہیں تو تصدیق کریں کہ اس کا کنسینٹ مینجمنٹ ماڈیول GPP کے لیے ترتیب دیا گیا ہے، اور wrapper سے نکلنے والی بِڈ درخواستوں کے ساتھ ساتھ حتمی ایڈ سرور کال کا بھی معائنہ کریں۔
ناکامی کے عام نمونے
- stub اشتہاری ٹیگز کے بعد لوڈ ہوتا ہے — پارٹنرز کو کوئی CMP نظر ہی نہیں آتا۔
- علاقے کے لیے غلط سیکشن — امریکی ٹریفک کے لیے EU سیکشن بھیجا جاتا ہے، یا کوئی سیکشن بالکل نہیں۔
- UI اور سگنل ہم آہنگ نہیں — ٹوگل بدلتا ہے، سٹرنگ نہیں۔
- GPC نظر انداز — براؤزر سگنل کبھی آپٹ آؤٹ نہیں بنتا۔
- درخواستوں میں پرانی سٹرنگز — wrapper پہلی دیکھی ہوئی قدر کیش کر لیتا ہے۔
اہم نکات
- ping سے شروع کریں: ورژن، حالت، قابلِ اطلاق سیکشنز اور سٹرنگ زیادہ تر کہانی بتا دیتے ہیں۔
- آپٹ آؤٹ فیلڈز پڑھنے کے لیے getSection استعمال کریں؛ 1 کا مطلب آپٹ آؤٹ، 2 کا مطلب آپٹ آؤٹ نہیں۔
- آپٹ آؤٹ لنک اور GPC کو الگ الگ ٹیسٹ کریں اور تصدیق کریں کہ دونوں سگنل بدلتے ہیں۔
- ایونٹس سنیں اور اشتہاری درخواستوں کے سٹرنگ پڑھنے سے پہلے “ready” سگنل کا انتظار کریں۔
- آپٹ آؤٹ سے پہلے اور بعد میں اصل نیٹ ورک درخواستوں میں gpp اور gpp_sid کی تصدیق کریں۔