مرحلہ 1: چار گروہوں میں بانٹیں (لوڈ / کنفیگ / فریم ورک / ڈسپلے)
آپ کا «چیٹ نہیں آئی» جو بھی ہو، پہلے چار گروہوں تک تنگ کریں — یہی زیادہ تر چکر بچاتا ہے۔ فلو چارٹ فیصلہ واضح کرتا ہے: اسکرپٹ لوڈ ہوا (F12 میں meiqia.js)، پھر کنفیگ، فریم ورک یا ڈسپلے پرت مسئلہ۔ بنیاد کے لیے دیکھیں 美洽 ویب انٹیگریشن گائیڈ۔
انٹیگریشن کیسے کام کرتی ہے: یہ JS انجیکشن کیوں ناکام / بلاک ہوتا ہے
ایک جملہ کافی ہے: 美洽 ویب ویجٹ آپ کے صفحے میں جامد جزو نہیں — یہ meiqia.js ہے جو 美洽 کے آف-ڈومین سے غیر متزامن لوڈ ہوتا، متحرک طور پر چیٹ کنٹینر (DOM / iframe) انجیکٹ کرتا اور طویل کراس-اوریجن کنکشن کھولتا ہے۔ انجیکشن کامیاب ہونے کو «اسکرپٹ لوڈ (اچھا مقام، adblock نہیں)، کنٹینر CSS / دیگر پلگ ان سے نہ ڈھکا، entId اور ڈومین مطابق، اور SPA روٹ تبدیلی کے بعد دوبارہ ماؤنٹ» چاہیے۔ نیچے خاکہ یہ سلسلہ اور چار بلاک پوائنٹ کھینچتا ہے — اسی لیے ایک ہی کوڈ ایک سائٹ / فریم ورک پر چلتا مگر دوسرے پر نہیں۔
کوڈ درست رکھا مگر اب بھی ظاہر نہیں: انٹیگریشن سیلف-چیک پینل چلائیں
اگر مقام، meiqia.js 200 اور entId سب تصدیق شدہ مگر اب بھی ظاہر نہ ہو، بنیادی طور پر «adblock» یا «فریم ورک / اسٹیکنگ»۔ نیچے پینل اہمیت کے لحاظ سے ترتیب: سبز عموماً ٹھیک، سرخ (adblock، SPA / تھرڈ پارٹی پلگ ان اسٹیکنگ) اکثر آنے والے جال۔ ایک ایک چیک تیزی سے مقام بتاتا ہے۔
مکمل علامات جدول (رویہ / سرکاری مقام · L2 بنیادی وجہ)
نیچے جدول عام ظاہر نہ ہونے / خرابی علامات ایک ساتھ درج کرتا ہے، ہر ایک کے سرکاری مقام اور L2 بنیادی وجہ کے ساتھ۔ اوپر تلاش باکس اس جدول کے ڈیٹا سے چلتا ہے — اپنا ملا کلیدی لفظ تلاش کریں۔
| علامت | گروہ | L1 رویہ / سرکاری مقام | L2 بنیادی وجہ |
|---|---|---|---|
| چیٹ ونڈو / ببل بالکل ظاہر نہیں ہوتا | لوڈ ناکامی | 美洽 ویب ویجٹ ایک چسپاں شدہ JS اسنپٹ سے تیرتی چیٹ ونڈو لوڈ کرتا ہے؛ تصدیق کریں کہ کوڈ درست سرایت شدہ ہے اور انٹیگریشن سائٹ کنسول میں کنفیگر ہے۔ | ویجٹ غیر متزامن لوڈ کے بعد DOM میں انجیکٹ ہونے والا meiqia.js ہے، لہٰذا «بالکل کچھ نہیں» عموماً «اسکرپٹ کبھی لوڈ نہیں ہوا» — غلط مقام، adblock / کیشے سے بلاک، یا غیر مطابق ڈومین / entId، لہٰذا انجیکشن کبھی نہیں چلا۔ |
| اسکرپٹ لوڈ مگر چیٹ بٹن غائب | ڈسپلے مسائل | ویجٹ کوڈ سائٹ کے مطابق ہو کر چیٹ بٹن دکھاتا ہے؛ ڈسپلے ناکام ہو تو چیک کریں کہ اسٹائلز سے چھپا یا ابتدائیہ رکا۔ | اگر اسکرپٹ لوڈ ہو مگر بٹن غائب ہو، عموماً «ڈسپلے پرت» مسئلہ: سائٹ-وسیع CSS بٹن مقام اوور رائیڈ / display:none، z-index ہارتا، یا کوئی اور مقررہ عنصر ڈھانپتا ہے؛ کوئی اور JS خرابی بھی ابتدائیہ روک سکتی ہے۔ |
| meiqia.js adblock ایکسٹینشن سے بلاک | لوڈ ناکامی | 美洽 چیٹ اسکرپٹ تھرڈ پارٹی ڈومین سے آتا ہے؛ بلاکنگ ایکسٹینشن نصب ہو تو اسے اشتہار / ٹریکر سمجھ کر لوڈ روک سکتا ہے — بلاکنگ بند کریں یا وائٹ لسٹ کریں۔ | ERR_BLOCKED_BY_CLIENT یعنی براؤزر ایکسٹینشن (AdBlock / uBlock / AdGuard) نے فلٹر فہرستوں سے درخواست بلاک کی۔ 美洽 اسکرپٹ «تھرڈ پارٹی آف-ڈومین + ریئل ٹائم رابطہ» ہے، جسے ایسے اصول اکثر اشتہار / ٹریکر سمجھ بیٹھتے ہیں، «کنسول ٹھیک، صارف طرف غائب» جھوٹی ناکامی پیدا کرتے ہیں۔ |
| meiqia.js 404 / بری حیثیت / مخلوط مواد | لوڈ ناکامی | تعیناتی کے بعد Network پینل میں meiqia.js تلاش کریں؛ 200 حیثیت یعنی اسکرپٹ درست رکھا اور لوڈ ہوا۔ | عام غیر-200 وجوہات: کوڈ صفحہ / CDN کیشے میں پھنسا (اشاعت کے بعد ریفریش نہیں)، HTTP صفحے پر لوڈ / نامکمل سرٹیفکیٹ چین مخلوط-مواد بلاکنگ متحرک کرتی، یا ٹوٹا / جزوی کاپی کوڈ۔ یہ مرحلہ ناکام ہو تو انجیکشن اور کنکشن کبھی نہیں ہوتے۔ |
| کوڈ غلط مقام پر (head بلاکنگ / بے اثر) | لوڈ ناکامی | 美洽 کوڈ کو صفحے کے نیچے، </body> سے پہلے چسپاں کرنے کی سفارش کرتا ہے؛ ویجٹ مرکزی مواد لوڈ ہونے کے بعد چلتا ہے۔ | ویجٹ کو DOM تیار ہونے کے بعد کنٹینر انجیکٹ کرنا ہوتا ہے۔ <head> میں یہ رینڈر بلاک کرتا ہے (کمزور نیٹ ورک پر پہلے خالی اسکرین) یا DOM تیار ہونے سے پہلے چل کر ناکام ہوتا ہے؛ کچھ async / module scope میں لوڈ ترتیب بھی بگڑ سکتی ہے۔ |
| چیٹ ونڈو / بٹن اسٹائل ٹوٹا | ڈسپلے مسائل | ویجٹ اپنے اسٹائلز انجیکٹ کر کے سائٹ کے مطابق ہوتا ہے؛ سائٹ-وسیع اسٹائلز سے تصادم بصری خرابی کر سکتا ہے۔ | 美洽 اسکرپٹ رن ٹائم پر CSS انجیکٹ کرتا ہے؛ سائٹ-وسیع اسٹائلز (یونیورسل سلیکٹرز / اعلیٰ ترجیحی اصول / reset) پہلے اس کی کلاسز اوور رائیڈ کریں تو مقام، اسٹیکنگ اور فونٹ ٹوٹتے ہیں — «متحرک انجیکشن + ایک دستاویز اسٹائل اسپیس شیئر» کا ضمنی اثر۔ |
| بٹن اسکرین سے باہر / ڈھکا | ڈسپلے مسائل | ویجٹ بٹن مقررہ مقام تیرتے کے طور پر ظاہر ہوتا ہے؛ دیگر مقررہ عناصر سے ڈھکا ہو تو اسٹیکنگ یا مقام ایڈجسٹ کریں۔ | سائٹ کے دیگر position:fixed عناصر (اوپر جائیں، تیرتے اشتہار، اپنا سپورٹ بار) زیادہ z-index سے 美洽 بٹن ڈھانپتے ہیں، یا تھیم اس کے کوآرڈینیٹس غلط حساب کرتا ہے، «اسکرین سے باہر / ڈھکا» چھوڑتا ہے۔ |
| تھرڈ پارٹی پلگ ان / اینالیٹکس DOM تصادم | ڈسپلے مسائل | صفحے کے دیگر اسکرپٹ جو DOM بدلتے یا درخواستیں روکتے ہیں ویجٹ کی عام لوڈنگ اور ڈسپلے کو متاثر کر سکتے ہیں۔ | ہیٹ میپ / اینالیٹکس / کنورژن اسکرپٹ DOM دوبارہ لکھتے، اوورلے انجیکٹ یا درخواستیں روکتے ہیں؛ وہ اور 美洽 ایک ہی دستاویز میں انجیکٹ ہونے سے اسٹیکنگ / ایونٹس مداخلت کرتے ہیں اور 美洽 کنٹینر ڈھک جاتا یا اس کا init رک جاتا ہے۔ |
| SPA روٹ تبدیلی کے بعد ویجٹ غائب | فریم ورک انٹیگریشن | واحد صفحہ ایپس (SPA) کے لیے فریم ورک روٹ ہکس سے 美洽 ویجٹ لوڈ / init کریں تاکہ فرنٹ اینڈ روٹنگ سے مطابق ہو۔ | SPA فرنٹ اینڈ روٹنگ سے ویوز بدلتا، DOM تباہ / دوبارہ بناتا ہے، مگر meiqia.js پہلے سے طے شدہ پہلے لوڈ پر ایک بار انجیکٹ کرتا اور روٹ تبدیلی پر خود دوبارہ نہیں بنتا، لہٰذا «صفحہ بدلو، چیٹ غائب»۔ |
| دستی init درکار (manualInit / init) | فریم ورک انٹیگریشن | ڈاؤن لوڈ کے بعد auto-init روکنے کو 美洽 ایمبیڈ کوڈ کے بعد _MEIQIA('manualInit') شامل کریں؛ ضرورت پر دستی init کو _MEIQIA('init') کال کریں۔ | پہلے سے طے شدہ 美洽 ڈاؤن لوڈ کے فوراً بعد init ہوتا ہے؛ جب آپ کو پہلے کنٹینر تیار / کسٹمر معلومات بھیجی / روٹ مستحکم چاہیے، وہ وقت «بہت جلدی» — ترتیب کنٹرول کو دستی init پر جائیں۔ |
| entId غیر مطابق / ایجنٹس کو چیٹ نہیں ملتیں | کنفیگ / اجازت | کوڈ میں entId کے بعد کا نمبر آپ کی کمپنی کی منفرد ID ہے؛ ورک بینچ سے عدم مطابقت پر ایجنٹس چیٹ سنبھال نہیں سکتے — ترتیبات - ٹیم - ID تلاش میں کمپنی ID تلاش کریں۔ | entId اسنپٹ کو ایک مخصوص کمپنی اکاؤنٹ سے باندھتا ہے۔ کسی اور کے / دوسرے ماحول کے کوڈ، یا ملے اکاؤنٹس سے فرنٹ اینڈ ونڈو لوڈ کرتا ہے مگر پیغامات «دوسری کمپنی» جاتے ہیں، لہٰذا یہ ورک بینچ کچھ نہیں پاتا — کلاسک «ٹھیک لگتا مگر کچھ نہیں پاتا»۔ |
| سائٹ ڈومین کنسول میں غیر مجاز | کنفیگ / اجازت | 美洽 کنسول «انٹیگریشن سائٹ شامل کریں» کی اجازت دیتا ہے، ہر ایک کی اپنی کنفیگ؛ نئی سائٹ کو اچھی انٹیگریشن سے پہلے کنسول میں کنفیگر کرنا ہوگا۔ | 美洽 کئی سائٹس کو «انٹیگریشن سائٹس» کے طور پر منظم کرتا ہے؛ ڈومین کو پہچان کے لیے کنسول میں رجسٹر / مجاز ہونا چاہیے۔ غیر شامل نیا پروڈکشن ڈومین قبول نہ ہو یا غلط کنفیگ سے میپ ہو سکتا ہے۔ |
| ملٹی سائٹ / ذیلی چینل (پروب) ملا جلا | کنفیگ / اجازت | 美洽 ہر سائٹ کے لیے الگ ویجٹ اور چیٹ لنک تعیناتی کی حمایت کرتا ہے (ذیلی چینل / پروب)؛ پہلے سے طے شدہ سائٹ کے علاوہ مزید شامل کر سکتے ہیں، ہر ایک کی اپنی کنفیگ۔ | مختلف کاروباری لائنوں کو مختلف ایجنٹ گروپ / auto-پیغام چاہیے، مگر ہر سائٹ ایک پہلے سے طے شدہ اسنپٹ شیئر کرے تو ذرائع الگ نہیں ہوتے اور کنفیگز ملتی ہیں۔ ذیلی چینل (پروب) «ایک کمپنی، کئی داخلے، روٹڈ» کے لیے بنے ہیں۔ |
| موبائل ویب چیٹ ظاہر نہیں ہوتی / الگ تعیناتی درکار | موبائل / SDK | ویجٹ کوڈ سائٹ کے مطابق ہوتا ہے؛ موبائل / PC ایک ہی اسنپٹ استعمال کرتے مگر الگ تعینات ہونے چاہئیں۔ | بہت سی ٹیموں کے الگ PC اور موبائل صفحات / ٹیمپلیٹ ہوتے ہیں اور کوڈ صرف PC ٹیمپلیٹ میں چسپاں کیا۔ اسنپٹ ایک ہی اور خود مطابق، مگر «چسپاں» مرحلہ موبائل ٹیمپلیٹ میں بھی کرنا ہوگا؛ چھوٹ جائے تو موبائل پر چیٹ نہیں۔ |
| نیٹو ایپ SDK انٹیگریشن / AppKey | موبائل / SDK | ان-ایپ انٹیگریشن کو 美洽 ورک بینچ سے AppKey چاہیے (ترتیبات - انٹیگریشن - SDK، «APP کنفیگ شامل کریں»)، اور ڈویلپرز سرکاری دستاویز اور ڈیمو کے مطابق iOS / Android SDK انٹیگریٹ کرتے ہیں۔ | ایپ ویب JS نہیں، نیٹو SDK استعمال کرتی ہے: پہلے AppKey کو «APP کنفیگ شامل کریں»، پھر چیٹ UI، اَن پڑھ، پش وغیرہ کو ہر پلیٹ فارم پر SDK انٹیگریٹ — ویب ویجٹ سے بالکل مختلف راستہ۔ |
| SDK پیغام پش نہیں آتا | موبائل / SDK | 美洽 SDK پش کے دو موڈ: «کوئی پش نہیں» سے ایجنٹ پیغامات صرف ایپ میں پہنچتے (پانے کو ایپ کھولیں)؛ «کسٹم پش سرور» سے صارفین ایپ چھوڑنے کے بعد بھی فون پر پش پاتے ہیں۔ | «آف لائن پش» نہ ہونا عموماً پش موڈ «کوئی پش نہیں»، یا کوئی کسٹم پش سرور / فی پلیٹ فارم پش سرٹیفکیٹ نہیں۔ راستہ «美洽 → ایپ سرور → صارف فون»؛ غائب کڑی صرف ان-ایپ وصولی چھوڑتی ہے۔ |
| ڈیفالٹ بٹن چھپائیں / کسٹم داخلہ | API کالز | 美洽 نیٹو چیٹ بٹن نہ دکھانے کو _MEIQIA('withoutBtn') کال کریں؛ init کامیاب ہونے پر چیٹ کھولنے کو _MEIQIA('showPanel') کال کریں۔ | پہلے سے طے شدہ نیٹو تیرتا بٹن رینڈر ہوتا ہے؛ اپنے داخلے کو init سے پہلے / دوران «کوئی نیٹو بٹن نہیں» اعلان کر کے «چیٹ کھولیں» اپنے عنصر سے باندھنا ہوگا — API وقت کا معاملہ، «ٹوٹا بٹن» نہیں۔ |
| کسٹمر معلومات بھیجنا / مطابقت بے اثر | API کالز | 美洽 ویب ویجٹ وزیٹر ڈیٹا چیٹ میں لانے کو «کسٹمر معلومات بھیجیں»، «کسٹمر شناخت مطابق کریں» اور «کسٹم ایونٹ معلومات شامل کریں» API دیتا ہے۔ | یہ API درست init وقت میں کال کرنے ہیں: init کامیاب ہونے کے بعد (یا manualInit + init وقت میں)۔ بہت جلدی / دیر، یا غلط فیلڈ فارمیٹ، تو «سیٹ مگر بے اثر»۔ |
美洽 ظاہر نہ ہونے کی وجوہات & انٹیگریشن طریقوں کا موازنہ (2026 تخمینہ)
درج ذیل 美洽 کی سرکاری مدد (رسائی چینلز / JavaScript ویب ویجٹ API) اور عوامی انٹیگریشن مسئلہ حل سے ترکیب شدہ 2026 تخمینے ہیں (وینڈر وعدہ یا براہ راست پیمائش نہیں؛ حوالے کے لیے، ورژن اور براؤزر پالیسی سے بدلتے ہیں):
| پہلو | تخمینہ / موازنہ |
|---|---|
| ظاہر نہ ہونے کی وجوہات کی تقسیم (کمیونٹی / ٹکٹ · تخ.) | مقام / لوڈ نہیں ~35% > adblock / براؤزر ایکسٹینشن ~25% > کنفیگ / اجازت (entId / ڈومین) ~20% > فریم ورک (SPA) ~12% > اسٹائل / تھرڈ پارٹی پلگ ان تصادم ~8% |
| انٹیگریشن دراصل کیا ہے | ویب ویجٹ = DOM انجیکٹ کرنے والا تھرڈ پارٹی آف-ڈومین غیر متزامن JS + طویل کراس-اوریجن کنکشن (سرایت شدہ جامد جزو نہیں)؛ لہٰذا مقام، adblock اصول، CSS اسٹیکنگ، SPA لائف سائیکل سے متاثر |
| فی پلیٹ فارم انٹیگریشن (تخ.) | PC / موبائل ویب = JS ویجٹ (ایک ہی کوڈ، الگ تعینات)؛ ایپ = نیٹو SDK (AppKey)؛ WeChat / Douyin / RED = چینل-مجاز انٹیگریشن |
| adblock اثر (تخ.) | تقریباً 30-40% PC صارفین adblock ایکسٹینشن استعمال کرتے ہیں ← تھرڈ پارٹی چیٹ اسکرپٹ اشتہار اصولوں سے بلاک (ERR_BLOCKED_BY_CLIENT)، «کنسول ٹھیک، صارف طرف غائب» کی بڑی وجہ |
| JS ویجٹ لائیو وقت (سرکاری) | مخصوص JS صفحے کے نیچے چسپاں کریں تو تقریباً 3-5 منٹ میں لائیو؛ entId کمپنی کی منفرد ID ہے، اور ورک بینچ سے عدم مطابقت ایجنٹس کو بغیر چیٹ چھوڑتی ہے |
تخمینہ بنیاد: ماخذ بیس لائن + وقت ایکسٹراپولیشن (meiqia.com/help رسائی چینلز / JavaScript ویب ویجٹ، meiqia.im انٹیگریشن گائیڈ، عوامی مسئلہ حل، 2026)؛ ورژن اور براؤزر بلاکنگ پالیسی سے بدلتا ہے۔ 美洽 کی تازہ ترین سرکاری معلومات پر عمل کریں۔ غیر سرکاری · LLM مقامی کاری۔
پانچ 美洽 انٹیگریشن طریقوں کا موازنہ (کوڈ / مشکل / خصوصیات / منظرنامہ / لائیو وقت)
کون سا انٹیگریشن طریقہ؟ نیچے موازنہ تیز کراس-حوالے کو 美洽 سرکاری دستاویز ترکیب کرتا ہے (کوڈ مقدار، خصوصیات مکملیت، بہترین موزونیت، لائیو وقت)۔ زیادہ تر سائٹس «ویب JS ویجٹ» منتخب کرتی ہیں۔
| انٹیگریشن طریقہ | کوڈ / مشکل | خصوصیات مکمل | موزوں | لائیو وقت |
|---|---|---|---|---|
| ویب JS ویجٹ | ایک JS اسنپٹ · کم | سب سے مکمل (تیرتا / پاپ اپ / خودکار خیرمقدم / وزیٹر ٹریل) | PC + موبائل سائٹس (سرکاری سفارش) | ~3-5 منٹ |
| چیٹ لنک | کوڈ نہیں · کم سے کم | بنیادی چیٹ | ٹیکنیک کے بغیر / تیز چیٹ لنک رکھنا | فوری |
| API / WebIM SDK | ڈویلپمنٹ درکار · اعلیٰ | گہری تخصیص (اپنا UI / سسٹم / آرڈر انٹیگریشن) | گہرے ملاپ کو dev صلاحیت والی ٹیمیں | dev کے مطابق |
| نیٹو ایپ SDK | SDK انٹیگریٹ · اعلیٰ | ان-ایپ چیٹ + پیغام پش | iOS / Android ایپس | dev کے مطابق |
| CMS تیز سیٹ اپ | پلگ ان / ایک کلک · کم | JS ویجٹ جیسا | WordPress / Fkw / Shopify سائٹس | منٹ |
چینل / منظرنامہ → انٹیگریشن نتیجہ نقشہ
ایک ہی 美洽 چینل / منظرنامے کے مطابق مختلف انٹیگریٹ ہوتا ہے۔ نیچے نقشہ عام چینل دکھاتا ہے: سبز = چسپاں کرو تو چلے، عنبر = سیٹ اپ چاہیے (الگ تعیناتی / init / وائٹ لسٹ)، سرخ = پہلے سے طے شدہ طریقہ بدلیں (adblock / entId / ایپ SDK استعمال کرتی)۔
اکثر پوچھے گئے سوالات
美洽 چیٹ ونڈو / ببل بالکل ظاہر نہیں ہوتا — کیسے ٹھیک کریں؟
美洽 ویب ویجٹ ایک چسپاں شدہ JS اسنپٹ سے تیرتی چیٹ ونڈو لوڈ کرتا ہے؛ تصدیق کریں کہ کوڈ درست سرایت شدہ ہے اور انٹیگریشن سائٹ کنسول میں کنفیگر ہے۔ ویجٹ غیر متزامن لوڈ کے بعد DOM میں انجیکٹ ہونے والا meiqia.js ہے، لہٰذا «بالکل کچھ نہیں» عموماً «اسکرپٹ کبھی لوڈ نہیں ہوا» — غلط مقام، adblock / کیشے سے بلاک، یا غیر مطابق ڈومین / entId، لہٰذا انجیکشن کبھی نہیں چلا۔ F12 → Network، meiqia.js تلاش کریں: کوئی درخواست نہیں ← کوڈ بے اثر (مقام چیک کریں / کیشے صاف کریں)؛ درخواست مگر غیر-200 ← بلاک یا راستے کا مسئلہ؛ سب ٹھیک مگر اب بھی چھپا ← entId / ڈومین اجازت اور نیچے گروہ چیک کریں۔
美洽 اسکرپٹ لوڈ مگر چیٹ بٹن غائب — کیسے ٹھیک کریں؟
ویجٹ کوڈ سائٹ کے مطابق ہو کر چیٹ بٹن دکھاتا ہے؛ ڈسپلے ناکام ہو تو چیک کریں کہ اسٹائلز سے چھپا یا ابتدائیہ رکا۔ اگر اسکرپٹ لوڈ ہو مگر بٹن غائب ہو، عموماً «ڈسپلے پرت» مسئلہ: سائٹ-وسیع CSS بٹن مقام اوور رائیڈ / display:none، z-index ہارتا، یا کوئی اور مقررہ عنصر ڈھانپتا ہے؛ کوئی اور JS خرابی بھی ابتدائیہ روک سکتی ہے۔ F12 → Elements، 美洽 کنٹینر تلاش کریں — موجود، چھپا، یا اسکرین سے باہر؟؛ دوبارہ جانچ کو عارضی طور پر کسٹم CSS / دیگر اسکرپٹ بند کریں؛ عمل روکنے والی خرابی کو کنسول میں دیکھیں۔
美洽 meiqia.js adblock ایکسٹینشن سے بلاک — کیسے ٹھیک کریں؟
美洽 چیٹ اسکرپٹ تھرڈ پارٹی ڈومین سے آتا ہے؛ بلاکنگ ایکسٹینشن نصب ہو تو اسے اشتہار / ٹریکر سمجھ کر لوڈ روک سکتا ہے — بلاکنگ بند کریں یا وائٹ لسٹ کریں۔ ERR_BLOCKED_BY_CLIENT یعنی براؤزر ایکسٹینشن (AdBlock / uBlock / AdGuard) نے فلٹر فہرستوں سے درخواست بلاک کی۔ 美洽 اسکرپٹ «تھرڈ پارٹی آف-ڈومین + ریئل ٹائم رابطہ» ہے، جسے ایسے اصول اکثر اشتہار / ٹریکر سمجھ بیٹھتے ہیں، «کنسول ٹھیک، صارف طرف غائب» جھوٹی ناکامی پیدا کرتے ہیں۔ اِنکوگنیٹو میں یا adblock بند کر کے دوبارہ جانچیں — ظاہر ہو تو بلاکنگ ہی وجہ؛ صارفین سے سائٹ وائٹ لسٹ کرائیں؛ فرنٹ اینڈ کچھ auto اصول بچانے کو چیٹ اسکرپٹ تاخیر سے / مشروط لوڈ کر سکتا ہے۔
美洽 meiqia.js 404 / بری حیثیت / مخلوط مواد — کیسے ٹھیک کریں؟
تعیناتی کے بعد Network پینل میں meiqia.js تلاش کریں؛ 200 حیثیت یعنی اسکرپٹ درست رکھا اور لوڈ ہوا۔ عام غیر-200 وجوہات: کوڈ صفحہ / CDN کیشے میں پھنسا (اشاعت کے بعد ریفریش نہیں)، HTTP صفحے پر لوڈ / نامکمل سرٹیفکیٹ چین مخلوط-مواد بلاکنگ متحرک کرتی، یا ٹوٹا / جزوی کاپی کوڈ۔ یہ مرحلہ ناکام ہو تو انجیکشن اور کنکشن کبھی نہیں ہوتے۔ اشاعت کے بعد CDN / براؤزر کیشے صاف کریں (یا اِنکوگنیٹو)؛ مکمل سرٹیفکیٹ چین کے ساتھ مکمل HTTPS اور مخلوط مواد کے بغیر یقینی بنائیں؛ کاپی کوڈ مکمل اور escape سے پاک تصدیق کریں۔
美洽 کوڈ غلط مقام پر (head بلاکنگ / بے اثر) — کیسے ٹھیک کریں؟
美洽 کوڈ کو صفحے کے نیچے، </body> سے پہلے چسپاں کرنے کی سفارش کرتا ہے؛ ویجٹ مرکزی مواد لوڈ ہونے کے بعد چلتا ہے۔ ویجٹ کو DOM تیار ہونے کے بعد کنٹینر انجیکٹ کرنا ہوتا ہے۔ <head> میں یہ رینڈر بلاک کرتا ہے (کمزور نیٹ ورک پر پہلے خالی اسکرین) یا DOM تیار ہونے سے پہلے چل کر ناکام ہوتا ہے؛ کچھ async / module scope میں لوڈ ترتیب بھی بگڑ سکتی ہے۔ 美洽 JS کو ہر صفحے کے مشترکہ فوٹر میں، </body> سے پہلے رکھیں؛ SPA کے لیے «SPA روٹ» اندراج دیکھیں اور manualInit استعمال کریں؛ یقینی بنائیں bundler اسے tree-shaking سے نہ ہٹائے۔
美洽 چیٹ ونڈو / بٹن اسٹائل ٹوٹا — کیسے ٹھیک کریں؟
ویجٹ اپنے اسٹائلز انجیکٹ کر کے سائٹ کے مطابق ہوتا ہے؛ سائٹ-وسیع اسٹائلز سے تصادم بصری خرابی کر سکتا ہے۔ 美洽 اسکرپٹ رن ٹائم پر CSS انجیکٹ کرتا ہے؛ سائٹ-وسیع اسٹائلز (یونیورسل سلیکٹرز / اعلیٰ ترجیحی اصول / reset) پہلے اس کی کلاسز اوور رائیڈ کریں تو مقام، اسٹیکنگ اور فونٹ ٹوٹتے ہیں — «متحرک انجیکشن + ایک دستاویز اسٹائل اسپیس شیئر» کا ضمنی اثر۔ F12 سے دیکھیں کون سا سائٹ اصول 美洽 کنٹینر اوور رائیڈ کرتا ہے؛ سائٹ-وسیع اسٹائلز تنگ کریں / عمومی کلاسز پر اثر کم کریں؛ ضرورت ہو تو کنٹینر اسٹیکنگ ایڈجسٹ کرنے کو 美洽 سے کہیں۔
美洽 بٹن اسکرین سے باہر / ڈھکا — کیسے ٹھیک کریں؟
ویجٹ بٹن مقررہ مقام تیرتے کے طور پر ظاہر ہوتا ہے؛ دیگر مقررہ عناصر سے ڈھکا ہو تو اسٹیکنگ یا مقام ایڈجسٹ کریں۔ سائٹ کے دیگر position:fixed عناصر (اوپر جائیں، تیرتے اشتہار، اپنا سپورٹ بار) زیادہ z-index سے 美洽 بٹن ڈھانپتے ہیں، یا تھیم اس کے کوآرڈینیٹس غلط حساب کرتا ہے، «اسکرین سے باہر / ڈھکا» چھوڑتا ہے۔ حقیقی کوآرڈینیٹس / z-index دیکھنے کو F12 میں 美洽 کنٹینر منتخب کریں؛ اسے اونچا کریں یا ڈھانپنے والے عنصر کا z-index کم کریں؛ ایک کونے میں کئی مقررہ تیرتے ڈھیر نہ کریں۔
美洽 تھرڈ پارٹی پلگ ان / اینالیٹکس DOM تصادم — کیسے ٹھیک کریں؟
صفحے کے دیگر اسکرپٹ جو DOM بدلتے یا درخواستیں روکتے ہیں ویجٹ کی عام لوڈنگ اور ڈسپلے کو متاثر کر سکتے ہیں۔ ہیٹ میپ / اینالیٹکس / کنورژن اسکرپٹ DOM دوبارہ لکھتے، اوورلے انجیکٹ یا درخواستیں روکتے ہیں؛ وہ اور 美洽 ایک ہی دستاویز میں انجیکٹ ہونے سے اسٹیکنگ / ایونٹس مداخلت کرتے ہیں اور 美洽 کنٹینر ڈھک جاتا یا اس کا init رک جاتا ہے۔ تصادم تلاش کرنے کو مشکوک پلگ ان ایک ایک بند کریں؛ لوڈ ترتیب / کنٹینر اسٹیکنگ ایڈجسٹ کریں؛ ہیٹ میپ وغیرہ کو 美洽 کنٹینر علاقے سے بچائیں۔
美洽 SPA روٹ تبدیلی کے بعد ویجٹ غائب — کیسے ٹھیک کریں؟
واحد صفحہ ایپس (SPA) کے لیے فریم ورک روٹ ہکس سے 美洽 ویجٹ لوڈ / init کریں تاکہ فرنٹ اینڈ روٹنگ سے مطابق ہو۔ SPA فرنٹ اینڈ روٹنگ سے ویوز بدلتا، DOM تباہ / دوبارہ بناتا ہے، مگر meiqia.js پہلے سے طے شدہ پہلے لوڈ پر ایک بار انجیکٹ کرتا اور روٹ تبدیلی پر خود دوبارہ نہیں بنتا، لہٰذا «صفحہ بدلو، چیٹ غائب»۔ auto-init روکنے کو _MEIQIA('manualInit') استعمال کریں اور ضرورت پر دوبارہ ماؤنٹ کو روٹ ہک (React useEffect / Vue mounted / router afterEach) میں _MEIQIA('init') کال کریں؛ کئی انسٹینس init سے بچیں۔
美洽 دستی init درکار (manualInit / init) — کیسے ٹھیک کریں؟
ڈاؤن لوڈ کے بعد auto-init روکنے کو 美洽 ایمبیڈ کوڈ کے بعد _MEIQIA('manualInit') شامل کریں؛ ضرورت پر دستی init کو _MEIQIA('init') کال کریں۔ پہلے سے طے شدہ 美洽 ڈاؤن لوڈ کے فوراً بعد init ہوتا ہے؛ جب آپ کو پہلے کنٹینر تیار / کسٹمر معلومات بھیجی / روٹ مستحکم چاہیے، وہ وقت «بہت جلدی» — ترتیب کنٹرول کو دستی init پر جائیں۔ کوڈ کے بعد _MEIQIA('manualInit') شامل کریں؛ شرائط تیار ہونے پر (DOM / سیشن / روٹ) _MEIQIA('init') کال کریں؛ معلومات API دستاویز کے مطابق init وقت میں ترتیب سے کال کریں۔
مزید انٹیگریشن سیٹ اپ: 美洽 ویب انٹیگریشن، APP SDK انٹیگریشن؛ شروع کرنے کو: 美洽 گائیڈ۔ تلاش کے قابل مکمل ورژن (اس ٹول سمیت) یہاں بھی 美洽 انٹیگریشن مسئلہ حل (GitHub Pages)۔