အဆင့် 1: လေးအုပ်စုခွဲ (load / config / framework / ပြသ)
သင့် «chat မလာ» ဘာဖြစ်ဖြစ်, အရင် လေးအုပ်စုကျဉ်းပါ — ၎င်းကပင် ပတ်လမ်းအများစုချွေ. flowchart က ဆုံးဖြတ်ချက်ရှင်းစေ: script တကယ် load ဖြစ်မဖြစ် (F12 တွင် meiqia.js), ပြီးနောက် config, framework သို့မဟုတ် ပြသ-layer ပြဿနာ. အခြေခံအတွက် 美洽 ဝက်ဘ်ပေါင်းစပ်လမ်းညွှန် ကြည့်.
ပေါင်းစပ်ခြင်း ဘယ်လိုအလုပ်လုပ်: ဤ JS injection ဘာကြောင့်မအောင်မြင် / ပိတ်ဆို့
ဝါကျတစ်ကြောင်းပင်လုံလောက်: 美洽 ဝက်ဘ် widget သည် သင့်စာမျက်နှာ၏ static component မဟုတ် — ၎င်းသည် 美洽 ၏ off-domain မှ အချိန်မကိုက် load ဖြစ်သော meiqia.js ဖြစ်ပြီး chat container (DOM / iframe) ကို dynamic inject လုပ်ကာ ရှည်လျား cross-origin connection ဖွင့်. injection အောင်မြင်ရန် «script load (တည်နေရာကောင်း, adblock မရှိ), container ကို CSS / အခြား plugin မဖုံး, entId နှင့် domain ကိုက်, SPA route ပြောင်းပြီးနောက် ပြန် mount» လို. အောက်ပါပုံက ဤကွင်းဆက်နှင့် block point လေးခုကိုဆွဲ — ၍ code တူက ဆိုဒ် / framework တစ်ခုတွင်အလုပ်လုပ်ပေမယ့် အခြားတစ်ခုတွင်မလုပ်.
code မှန်ထားပေမယ့် မပေါ်သေး: ပေါင်းစပ် self-check panel run
တည်နေရာ, meiqia.js 200, entId အားလုံးအတည်ပြုပေမယ့် မပေါ်သေးလျှင် အခြေခံအားဖြင့် «adblock» သို့မဟုတ် «framework / stacking». အောက်ပါ panel က အရေးပါမှုအလိုက်စီ: အစိမ်းများသောအားဖြင့်ကောင်း, အနီ (adblock, SPA / တတိယပါတီ plugin stacking) က မကြာခဏကြုံရသော ထောင်ချောက်. တစ်ခုချင်းစစ်လျှင်အမြန်တည်နေရာသိ.
လက္ခဏာ ဇယားအပြည့်အစုံ (အပြုအမူ / တရားဝင်ရပ်တည်ချက် · L2 အရင်းခံအကြောင်းရင်း)
အောက်ပါဇယားက အများသုံး မပေါ် / အမှား လက္ခဏာများကို တစ်ပြိုင်တည်းစာရင်းပြု, တစ်ခုစီတွင် တရားဝင်ရပ်တည်ချက်နှင့် L2 အရင်းခံအကြောင်းရင်း. အပေါ်က search box က ဤဇယား data ဖြင့် run — သင်ကြုံတွေ့သော keyword ရှာ.
| လက္ခဏာ | အုပ်စု | L1 အပြုအမူ / တရားဝင်ရပ်တည်ချက် | L2 အရင်းခံအကြောင်းရင်း |
|---|---|---|---|
| chat window / bubble လုံးဝမပေါ် | Load မအောင်မြင် | 美洽 ဝက်ဘ် widget သည် ကူးထည့်သော JS snippet တစ်ခုဖြင့် floating chat window load လုပ်; code မှန်ကန်စွာမြှုပ်ထားကြောင်းနှင့် ပေါင်းစပ်ဆိုဒ်ကို console တွင် config လုပ်ထားကြောင်းသေချာပါ. | widget သည် အချိန်မကိုက် load ပြီးနောက် DOM ထဲ inject ဖြစ်သော meiqia.js ဖြစ်၍ «လုံးဝဘာမှမရှိ» က များသောအားဖြင့် «script ဘယ်တော့မှ load မဖြစ်» — နေရာမှား, adblock / cache ဖြင့်ပိတ်ဆို့, သို့မဟုတ် domain / entId မကိုက်, ၍ injection ဘယ်တော့မှ run မဖြစ်. |
| script load ဖြစ်ပေမယ့် chat ခလုတ်ပျောက် | ပြသခြင်းပြဿနာ | widget code က ဆိုဒ်နှင့်လိုက်လျောညီထွေဖြစ်ပြီး chat ခလုတ်ပြ; ပြသမအောင်မြင်လျှင် style ဖြင့်ပုန်းနေလား init ပြတ်တောက်လားစစ်ပါ. | script load ဖြစ်ပြီး ခလုတ်ပျောက်လျှင် များသောအားဖြင့် «ပြသ layer» ပြဿနာ: ဆိုဒ်တစ်ခုလုံး CSS က ခလုတ်တည်နေရာ override / display:none, z-index ရှုံး, သို့မဟုတ် အခြား fixed element ဖုံး; အခြား JS error ကလည်း init ပြတ်စေနိုင်. |
| meiqia.js ကို adblock extension ပိတ်ဆို့ | Load မအောင်မြင် | 美洽 chat script က တတိယပါတီ domain မှလာ; ပိတ်ဆို့ extension တပ်ဆင်ထားလျှင် ၎င်းကို ကြော်ငြာ / tracker အဖြစ်ယူဆ၍ load တားနိုင် — ပိတ်ဆို့ခြင်းပိတ် သို့မဟုတ် whitelist. | ERR_BLOCKED_BY_CLIENT ဆိုသည်မှာ browser extension (AdBlock / uBlock / AdGuard) က filter စာရင်းဖြင့် request ပိတ်ဆို့. 美洽 script က «တတိယပါတီ off-domain + real-time communication» ဖြစ်၍ ထိုစည်းမျဉ်းများက ကြော်ငြာ / tracker အဖြစ်မှားယွင်းယူဆတတ်, «console ကောင်း, အသုံးပြုသူဘက်ပျောက်» false failure ဖြစ်စေ. |
| meiqia.js 404 / status ဆိုး / mixed content | Load မအောင်မြင် | deploy ပြီးနောက် Network panel တွင် meiqia.js ရှာ; status 200 ဆိုသည်မှာ script မှန်ကန်စွာထား၍ load ဖြစ်. | non-200 အကြောင်းရင်းများ: code က page / CDN cache တွင်ပိတ်မိ (ထုတ်ဝေပြီး refresh မဖြစ်), HTTP page တွင် load / certificate chain မပြည့်စုံ၍ mixed-content ပိတ်ဆို့ ဖြစ်, သို့မဟုတ် code ပျက် / တစ်ပိုင်းတစ်စကူး. ဤအဆင့်မအောင်မြင်လျှင် injection နှင့် connection ဘယ်တော့မှမဖြစ်. |
| code နေရာမှား (head ပိတ်ဆို့ / အကျိုးမသက်) | Load မအောင်မြင် | 美洽 က code ကို page အောက်, </body> ရှေ့ကူးထည့်ရန်အကြံပြု; widget က main content load ပြီးနောက် run. | widget က DOM အဆင်သင့်ဖြစ်ပြီးနောက် container inject လုပ်ရ. <head> တွင် ၎င်းက render ပိတ်ဆို့ (network အားနည်းလျှင် page အလွတ်အရင်) သို့မဟုတ် DOM အဆင်သင့်မဖြစ်မီ run ၍မအောင်မြင်; async / module scope အချို့တွင် load order လည်းမှားနိုင်. |
| chat window / ခလုတ် style ပျက် | ပြသခြင်းပြဿနာ | widget က ကိုယ်ပိုင် style inject လုပ်ပြီး ဆိုဒ်နှင့်လိုက်လျောညီထွေ; ဆိုဒ်တစ်ခုလုံး style နှင့်ပဋိပက္ခက visual ချွတ်ယွင်းစေနိုင်. | 美洽 script က runtime တွင် CSS inject; ဆိုဒ်တစ်ခုလုံး style (universal selector / high-priority rule / reset) က ၎င်း class အရင် override လျှင် တည်နေရာ, stacking, font ပျက် — «dynamic injection + document style space တစ်ခုမျှဝေ» ၏ ဘေးထွက်ဆိုးကျိုး. |
| ခလုတ် screen ပြင်ပ / ဖုံး | ပြသခြင်းပြဿနာ | widget ခလုတ်က fixed-position floating အဖြစ်ပေါ်; အခြား fixed element ဖုံးလျှင် stacking သို့မဟုတ် တည်နေရာချိန်ညှိ. | ဆိုဒ်၏ အခြား position:fixed element (အပေါ်သို့, floating ကြော်ငြာ, ကိုယ်ပိုင် support bar) က z-index မြင့်ဖြင့် 美洽 ခလုတ်ဖုံး, သို့မဟုတ် theme က coordinate မှားတွက်၍ «screen ပြင်ပ / ဖုံး» ထား. |
| တတိယပါတီ plugin / analytics DOM ပဋိပက္ခ | ပြသခြင်းပြဿနာ | DOM ပြောင်းသော သို့မဟုတ် request ကြားဖြတ်သော page ၏ အခြား script များက widget ၏ ပုံမှန် load နှင့် ပြသခြင်းကို သက်ရောက်နိုင်. | heatmap / analytics / conversion script များက DOM ပြန်ရေး, overlay inject သို့မဟုတ် request ကြားဖြတ်; ၎င်းတို့နှင့် 美洽 က document တစ်ခုတည်းတွင် inject ဖြစ်၍ stacking / event နှောင့်ယှက်ကာ 美洽 container ဖုံး သို့မဟုတ် ၎င်း init ပြတ်. |
| SPA route ပြောင်းပြီးနောက် widget ပျောက် | Framework ပေါင်းစပ် | single-page app (SPA) အတွက် framework route hook သုံး၍ 美洽 widget load / init လုပ်, frontend routing နှင့်လိုက်လျောညီထွေ. | SPA က frontend routing ဖြင့် view ပြောင်း, DOM ဖျက် / ပြန်တည်ဆောက်, ပေမယ့် meiqia.js က default အရ ပထမ load တွင်တစ်ကြိမ် inject ပြီး route ပြောင်းချိန် အလိုအလျောက်ပြန်မတည်ဆောက်, ၍ «page ပြောင်း, chat ပျောက်». |
| manual init လို (manualInit / init) | Framework ပေါင်းစပ် | ဒေါင်းလုဒ်ပြီးနောက် auto-init ရပ်ရန် 美洽 embed code နောက်တွင် _MEIQIA('manualInit') ထည့်; လိုအပ်လျှင် manual init ရန် _MEIQIA('init') ခေါ်. | default အရ 美洽 က ဒေါင်းလုဒ်ပြီးချက်ချင်း init; container အဆင်သင့် / customer info ပို့ / route တည်ငြိမ်ကို အရင်လိုသောအခါ ထို timing က «စောလွန်း» — order ထိန်းရန် manual init သို့ပြောင်း. |
| entId မကိုက် / agent များ chat မရ | Config / ခွင့်ပြုချက် | code ထဲ entId နောက်ဂဏန်းသည် သင့်ကုမ္ပဏီ၏ သီးသန့် id; workbench နှင့်မကိုက်လျှင် agent များ chat မကိုင်တွယ်နိုင် — settings - team - ID ရှာ တွင် company ID ရှာ. | entId က snippet ကို သတ်မှတ်ကုမ္ပဏီ account နှင့်ချည်နှောင်. သူများ / အခြား environment code, သို့မဟုတ် account ရောထွေးလျှင် frontend က window load ပေမယ့် message «အခြားကုမ္ပဏီ» သို့သွား, ၍ ဤ workbench ဘာမှမရ — classic «ကောင်းပေါ်ပေမယ့်ဘာမှမရ». |
| ဆိုဒ် domain ကို console တွင်ခွင့်မပြု | Config / ခွင့်ပြုချက် | 美洽 console က «ပေါင်းစပ်ဆိုဒ်ထည့်ရန်» ခွင့်ပြု, တစ်ခုစီတွင် ကိုယ်ပိုင် config; ဆိုဒ်အသစ်ကို ပေါင်းစပ်ကောင်းမီ console တွင် config လုပ်ရ. | 美洽 က ဆိုဒ်များစွာကို «ပေါင်းစပ်ဆိုဒ်» အဖြစ်စီမံ; domain ကို မှတ်မိရန် console တွင် register / ခွင့်ပြုရ. မထည့်ရသေးသော production domain အသစ်ကို လက်မခံ သို့မဟုတ် config မှားသို့ map နိုင်. |
| multi-site / sub-channel (probe) ရောထွေး | Config / ခွင့်ပြုချက် | 美洽 က ဆိုဒ်တစ်ခုစီအတွက် မတူသော widget နှင့် chat link deploy ထောက်ပံ့ (sub-channel / probe); default ဆိုဒ်အပြင် ပိုထည့်နိုင်, တစ်ခုစီတွင် ကိုယ်ပိုင် config. | မတူသော business line များက မတူသော agent group / auto-message လို, ပေမယ့် ဆိုဒ်တိုင်းက default snippet တစ်ခုမျှဝေလျှင် source မခွဲနိုင်ပြီး config ရော. sub-channel (probe) က «ကုမ္ပဏီတစ်ခု, entry များစွာ, routed» အတွက်ဒီဇိုင်း. |
| mobile ဝက်ဘ် chat မပေါ် / သီးခြား deploy လို | Mobile / SDK | widget code က ဆိုဒ်နှင့်လိုက်လျောညီထွေ; mobile / PC က snippet တူသုံးပေမယ့် သီးခြား deploy ရ. | team များစွာတွင် သီးခြား PC နှင့် mobile page / template ရှိ၍ code ကို PC template တွင်သာကူးထည့်. snippet တူ၍ self-adapt, ပေမယ့် «ကူးထည့်» အဆင့်ကို mobile template တွင်လည်းလုပ်ရ; ကျန်လျှင် mobile တွင် chat မရှိ. |
| native app SDK ပေါင်းစပ် / AppKey | Mobile / SDK | in-app ပေါင်းစပ်က 美洽 workbench မှ AppKey လို (settings - ပေါင်းစပ် - SDK, «APP config ထည့်»), developer များက တရားဝင် doc နှင့် demo အတိုင်း iOS / Android SDK ပေါင်းစပ်. | app က web JS မဟုတ်, native SDK သုံး: အရင် AppKey အတွက် «APP config ထည့်», ပြီးနောက် chat UI, မဖတ်ရသေး, push စသည်အတွက် platform တစ်ခုစီတွင် SDK ပေါင်းစပ် — web widget နှင့်လုံးဝမတူသောလမ်းကြောင်း. |
| SDK message push မရောက် | Mobile / SDK | 美洽 SDK push တွင် mode နှစ်ခု: «push မရှိ» ဖြင့် agent message များ app ထဲသာရောက် (ရရန် app ဖွင့်); «custom push server» ဖြင့် အသုံးပြုသူ app ထွက်ပြီးနောက်လည်း ဖုန်းသို့ push ရ. | «offline push» မရှိခြင်းက များသောအားဖြင့် push mode «push မရှိ», သို့မဟုတ် custom push server / platform တစ်ခုစီ push certificate မရှိ. လမ်းကြောင်း «美洽 → app server → user ဖုန်း»; ပျောက်နေသော link က in-app ရရှိမှုသာချန်. |
| default ခလုတ်ဖုံး / custom entry | API ခေါ်ဆိုမှု | 美洽 native chat ခလုတ်မပြရန် _MEIQIA('withoutBtn') ခေါ်; init အောင်မြင်ပြီးနောက် chat ဖွင့်ရန် _MEIQIA('showPanel') ခေါ်. | default အရ native floating ခလုတ် render; ကိုယ်ပိုင် entry အတွက် init ရှေ့ / အတွင်း «native ခလုတ်မရှိ» ကြေညာပြီး «chat ဖွင့်» ကို ကိုယ့် element နှင့်ချည်ရ — API timing ကိစ္စ, «ခလုတ်ပျက်» မဟုတ်. |
| customer info ပို့ / sync အကျိုးမသက် | API ခေါ်ဆိုမှု | 美洽 ဝက်ဘ် widget က visitor data ကို chat ထဲယူရန် «customer info ပို့», «customer identity sync», «custom event info ထည့်» API များပေး. | ဤ API များကို မှန်ကန်သော init timing တွင်ခေါ်ရ: init အောင်မြင်ပြီးနောက် (သို့မဟုတ် manualInit + init timing). စော / နောက်ကျလွန်း, သို့မဟုတ် field format မှားလျှင် «set ဖြစ်ပေမယ့်အကျိုးမသက်». |
美洽 မပေါ်ရခြင်းအကြောင်းရင်း & ပေါင်းစပ်နည်းနှိုင်းယှဉ်ချက် (2026 ခန့်မှန်း)
အောက်ပါတို့သည် 美洽 တရားဝင်အကူအညီ (access channel / JavaScript ဝက်ဘ် widget API) နှင့် အများသုံးပေါင်းစပ် troubleshooting မှပေါင်းစပ်ထားသော 2026 ခန့်မှန်းချက်များ (vendor ကတိ သို့မဟုတ် တိုက်ရိုက်တိုင်းတာမှုမဟုတ်; ကိုးကားရန်, version နှင့် browser policy အလိုက်ပြောင်း):
| အတိုင်းအတာ | ခန့်မှန်း / နှိုင်းယှဉ် |
|---|---|
| မပေါ်ရခြင်းအကြောင်းရင်း ဖြန့်ဝေ (community / ticket · ခန့်.) | တည်နေရာ / load မဖြစ် ~35% > adblock / browser extension ~25% > config / ခွင့်ပြုချက် (entId / domain) ~20% > framework (SPA) ~12% > style / တတိယပါတီ plugin ပဋိပက္ခ ~8% |
| ပေါင်းစပ်ခြင်းဆိုသည် တကယ်ဘာလဲ | web widget = DOM inject လုပ်သော တတိယပါတီ off-domain အချိန်မကိုက် JS + ရှည်လျား cross-origin connection (မြှုပ်ထား static component မဟုတ်); ၍ တည်နေရာ, adblock rule, CSS stacking, SPA lifecycle တို့ကသက်ရောက် |
| platform တစ်ခုစီ ပေါင်းစပ် (ခန့်.) | PC / mobile web = JS widget (code တူ, သီးခြား deploy); app = native SDK (AppKey); WeChat / Douyin / RED = channel-ခွင့်ပြု ပေါင်းစပ် |
| adblock သက်ရောက်မှု (ခန့်.) | PC အသုံးပြုသူ 30-40% ခန့်က adblock extension သုံး → တတိယပါတီ chat script ကို ကြော်ငြာ rule ဖြင့်ပိတ်ဆို့ (ERR_BLOCKED_BY_CLIENT), «console ကောင်း, အသုံးပြုသူဘက်ပျောက်» ၏ အဓိကအကြောင်းရင်း |
| JS widget live အချိန် (တရားဝင်) | dedicated JS ကို page အောက်ကူးထည့်လျှင် 3-5 မိနစ် ခန့်တွင် live; entId က ကုမ္ပဏီ၏ သီးသန့် id, workbench နှင့်မကိုက်ခြင်းက agent များ chat မရဘဲချန် |
ခန့်မှန်းအခြေခံ: source baseline + အချိန် extrapolation (meiqia.com/help access channel / JavaScript ဝက်ဘ် widget, meiqia.im ပေါင်းစပ်လမ်းညွှန်, အများသုံး troubleshooting, 2026); version နှင့် browser ပိတ်ဆို့ policy အလိုက်ပြောင်း. 美洽 ၏ နောက်ဆုံးတရားဝင်အချက်အလက်လိုက်နာ. တရားဝင်မဟုတ် · LLM ဒေသန္တရပြုခြင်း.
美洽 ပေါင်းစပ်နည်းငါးမျိုး နှိုင်းယှဉ်ချက် (code / ခက်ခဲမှု / features / scenario / live အချိန်)
ဘယ်ပေါင်းစပ်နည်း? အောက်ပါနှိုင်းယှဉ်ချက်က အမြန် cross-reference အတွက် 美洽 တရားဝင် doc ပေါင်းစပ် (code ပမာဏ, feature ပြည့်စုံမှု, အသင့်လျော်ဆုံး, live အချိန်). ဆိုဒ်အများစုက «web JS widget» ရွေး.
| ပေါင်းစပ်နည်း | code / ခက်ခဲမှု | feature ပြည့်စုံမှု | သင့်လျော် | live အချိန် |
|---|---|---|---|---|
| web JS widget | JS snippet တစ်ခု · နိမ့် | အပြည့်စုံဆုံး (floating / popup / auto-ကြိုဆို / visitor trail) | PC + mobile ဆိုဒ် (တရားဝင်အကြံပြု) | ~3-5 မိနစ် |
| chat link | code မရှိ · အနိမ့်ဆုံး | အခြေခံ chat | technic မလို / chat link အမြန်ထား | ချက်ချင်း |
| API / WebIM SDK | develop လို · မြင့် | နက်ရှိုင်း customization (ကိုယ်ပိုင် UI / system / order ပေါင်းစပ်) | နက်ရှိုင်းပေါင်းစပ်ရန် dev စွမ်းရည်ရှိသော team | dev အလိုက် |
| native app SDK | SDK ပေါင်းစပ် · မြင့် | in-app chat + message push | iOS / Android app | dev အလိုက် |
| CMS အမြန် setup | plugin / one-click · နိမ့် | JS widget ကဲ့သို့ | WordPress / Fkw / Shopify ဆိုဒ် | မိနစ် |
channel / scenario → ပေါင်းစပ်ရလဒ် map
美洽 တူက channel / scenario အလိုက် မတူပေါင်းစပ်. အောက်ပါ map က အများသုံး channel ပြ: အစိမ်း = ကူးထည့်လျှင်အလုပ်လုပ်, ဝါ = setup လို (သီးခြား deploy / init / whitelist), အနီ = default အလိုက်နည်းပြောင်း (adblock / entId / app က SDK သုံး).
မေးလေ့ရှိသောမေးခွန်းများ
美洽 chat window / bubble လုံးဝမပေါ် — ဘယ်လိုဖြေရှင်းမလဲ?
美洽 ဝက်ဘ် widget သည် ကူးထည့်သော JS snippet တစ်ခုဖြင့် floating chat window load လုပ်; code မှန်ကန်စွာမြှုပ်ထားကြောင်းနှင့် ပေါင်းစပ်ဆိုဒ်ကို console တွင် config လုပ်ထားကြောင်းသေချာပါ. widget သည် အချိန်မကိုက် load ပြီးနောက် DOM ထဲ inject ဖြစ်သော meiqia.js ဖြစ်၍ «လုံးဝဘာမှမရှိ» က များသောအားဖြင့် «script ဘယ်တော့မှ load မဖြစ်» — နေရာမှား, adblock / cache ဖြင့်ပိတ်ဆို့, သို့မဟုတ် domain / entId မကိုက်, ၍ injection ဘယ်တော့မှ run မဖြစ်. F12 → Network, meiqia.js ရှာ: request မရှိ → code အကျိုးမသက် (နေရာစစ် / cache ရှင်း); request ပေမယ့် non-200 → ပိတ်ဆို့ သို့မဟုတ် path ပြဿနာ; အားလုံးကောင်းပေမယ့် ပုန်းနေ → entId / domain ခွင့်ပြုချက်နှင့် အောက်ပါအုပ်စုစစ်.
美洽 script load ဖြစ်ပေမယ့် chat ခလုတ်ပျောက် — ဘယ်လိုဖြေရှင်းမလဲ?
widget code က ဆိုဒ်နှင့်လိုက်လျောညီထွေဖြစ်ပြီး chat ခလုတ်ပြ; ပြသမအောင်မြင်လျှင် style ဖြင့်ပုန်းနေလား init ပြတ်တောက်လားစစ်ပါ. script load ဖြစ်ပြီး ခလုတ်ပျောက်လျှင် များသောအားဖြင့် «ပြသ layer» ပြဿနာ: ဆိုဒ်တစ်ခုလုံး CSS က ခလုတ်တည်နေရာ override / display:none, z-index ရှုံး, သို့မဟုတ် အခြား fixed element ဖုံး; အခြား JS error ကလည်း init ပြတ်စေနိုင်. F12 → Elements, 美洽 container ရှာ — ရှိ, ပုန်း, screen ပြင်ပ?; ပြန်စမ်းရန် custom CSS / အခြား script ယာယီပိတ်; execution ရပ်စေသော error အတွက် console စစ်.
美洽 meiqia.js ကို adblock extension ပိတ်ဆို့ — ဘယ်လိုဖြေရှင်းမလဲ?
美洽 chat script က တတိယပါတီ domain မှလာ; ပိတ်ဆို့ extension တပ်ဆင်ထားလျှင် ၎င်းကို ကြော်ငြာ / tracker အဖြစ်ယူဆ၍ load တားနိုင် — ပိတ်ဆို့ခြင်းပိတ် သို့မဟုတ် whitelist. ERR_BLOCKED_BY_CLIENT ဆိုသည်မှာ browser extension (AdBlock / uBlock / AdGuard) က filter စာရင်းဖြင့် request ပိတ်ဆို့. 美洽 script က «တတိယပါတီ off-domain + real-time communication» ဖြစ်၍ ထိုစည်းမျဉ်းများက ကြော်ငြာ / tracker အဖြစ်မှားယွင်းယူဆတတ်, «console ကောင်း, အသုံးပြုသူဘက်ပျောက်» false failure ဖြစ်စေ. incognito တွင် သို့မဟုတ် adblock ပိတ်၍ပြန်စမ်း — ပေါ်လျှင် ပိတ်ဆို့ခြင်းကအကြောင်းရင်း; အသုံးပြုသူများကို ဆိုဒ် whitelist ခိုင်း; frontend က auto စည်းမျဉ်းအချို့ရှောင်ရန် chat script ကို delay / conditional load လုပ်နိုင်.
美洽 meiqia.js 404 / status ဆိုး / mixed content — ဘယ်လိုဖြေရှင်းမလဲ?
deploy ပြီးနောက် Network panel တွင် meiqia.js ရှာ; status 200 ဆိုသည်မှာ script မှန်ကန်စွာထား၍ load ဖြစ်. non-200 အကြောင်းရင်းများ: code က page / CDN cache တွင်ပိတ်မိ (ထုတ်ဝေပြီး refresh မဖြစ်), HTTP page တွင် load / certificate chain မပြည့်စုံ၍ mixed-content ပိတ်ဆို့ ဖြစ်, သို့မဟုတ် code ပျက် / တစ်ပိုင်းတစ်စကူး. ဤအဆင့်မအောင်မြင်လျှင် injection နှင့် connection ဘယ်တော့မှမဖြစ်. ထုတ်ဝေပြီး CDN / browser cache ရှင်း (သို့မဟုတ် incognito); certificate chain ပြည့်စုံသော HTTPS အပြည့်နှင့် mixed content မပါဘဲသေချာ; ကူးသော code ပြည့်စုံ၍ escape မဖြစ်ကြောင်းအတည်ပြု.
美洽 code နေရာမှား (head ပိတ်ဆို့ / အကျိုးမသက်) — ဘယ်လိုဖြေရှင်းမလဲ?
美洽 က code ကို page အောက်, </body> ရှေ့ကူးထည့်ရန်အကြံပြု; widget က main content load ပြီးနောက် run. widget က DOM အဆင်သင့်ဖြစ်ပြီးနောက် container inject လုပ်ရ. <head> တွင် ၎င်းက render ပိတ်ဆို့ (network အားနည်းလျှင် page အလွတ်အရင်) သို့မဟုတ် DOM အဆင်သင့်မဖြစ်မီ run ၍မအောင်မြင်; async / module scope အချို့တွင် load order လည်းမှားနိုင်. 美洽 JS ကို page တိုင်း၏ shared footer, </body> ရှေ့ထား; SPA အတွက် «SPA route» entry ကြည့်ပြီး manualInit သုံး; bundler က tree-shaking ဖြင့်မဖယ်ကြောင်းသေချာ.
美洽 chat window / ခလုတ် style ပျက် — ဘယ်လိုဖြေရှင်းမလဲ?
widget က ကိုယ်ပိုင် style inject လုပ်ပြီး ဆိုဒ်နှင့်လိုက်လျောညီထွေ; ဆိုဒ်တစ်ခုလုံး style နှင့်ပဋိပက္ခက visual ချွတ်ယွင်းစေနိုင်. 美洽 script က runtime တွင် CSS inject; ဆိုဒ်တစ်ခုလုံး style (universal selector / high-priority rule / reset) က ၎င်း class အရင် override လျှင် တည်နေရာ, stacking, font ပျက် — «dynamic injection + document style space တစ်ခုမျှဝေ» ၏ ဘေးထွက်ဆိုးကျိုး. ဘယ်ဆိုဒ် rule က 美洽 container override သည်ကို F12 ဖြင့်ကြည့်; ဆိုဒ်တစ်ခုလုံး style ကျဉ်း / common class အပေါ်အကျိုးသက်ရောက်မှုလျှော့; လိုအပ်လျှင် container stacking ချိန်ညှိရန် 美洽 ကိုခိုင်း.
美洽 ခလုတ် screen ပြင်ပ / ဖုံး — ဘယ်လိုဖြေရှင်းမလဲ?
widget ခလုတ်က fixed-position floating အဖြစ်ပေါ်; အခြား fixed element ဖုံးလျှင် stacking သို့မဟုတ် တည်နေရာချိန်ညှိ. ဆိုဒ်၏ အခြား position:fixed element (အပေါ်သို့, floating ကြော်ငြာ, ကိုယ်ပိုင် support bar) က z-index မြင့်ဖြင့် 美洽 ခလုတ်ဖုံး, သို့မဟုတ် theme က coordinate မှားတွက်၍ «screen ပြင်ပ / ဖုံး» ထား. တကယ် coordinate / z-index ကြည့်ရန် F12 တွင် 美洽 container ရွေး; ၎င်းကိုမြှင့် သို့မဟုတ် ဖုံးသော element z-index လျှော့; ထောင့်တစ်ခုတွင် fixed floating များစုပုံခြင်းရှောင်.
美洽 တတိယပါတီ plugin / analytics DOM ပဋိပက္ခ — ဘယ်လိုဖြေရှင်းမလဲ?
DOM ပြောင်းသော သို့မဟုတ် request ကြားဖြတ်သော page ၏ အခြား script များက widget ၏ ပုံမှန် load နှင့် ပြသခြင်းကို သက်ရောက်နိုင်. heatmap / analytics / conversion script များက DOM ပြန်ရေး, overlay inject သို့မဟုတ် request ကြားဖြတ်; ၎င်းတို့နှင့် 美洽 က document တစ်ခုတည်းတွင် inject ဖြစ်၍ stacking / event နှောင့်ယှက်ကာ 美洽 container ဖုံး သို့မဟုတ် ၎င်း init ပြတ်. ပဋိပက္ခရှာရန် သံသယ plugin များတစ်ခုချင်းပိတ်; load order / container stacking ချိန်; heatmap စသည်တို့ကို 美洽 container ဧရိယာရှောင်စေ.
美洽 SPA route ပြောင်းပြီးနောက် widget ပျောက် — ဘယ်လိုဖြေရှင်းမလဲ?
single-page app (SPA) အတွက် framework route hook သုံး၍ 美洽 widget load / init လုပ်, frontend routing နှင့်လိုက်လျောညီထွေ. SPA က frontend routing ဖြင့် view ပြောင်း, DOM ဖျက် / ပြန်တည်ဆောက်, ပေမယ့် meiqia.js က default အရ ပထမ load တွင်တစ်ကြိမ် inject ပြီး route ပြောင်းချိန် အလိုအလျောက်ပြန်မတည်ဆောက်, ၍ «page ပြောင်း, chat ပျောက်». auto-init ရပ်ရန် _MEIQIA('manualInit') သုံးပြီး လိုအပ်လျှင် ပြန် mount ရန် route hook (React useEffect / Vue mounted / router afterEach) တွင် _MEIQIA('init') ခေါ်; multiple instance init ရှောင်.
美洽 manual init လို (manualInit / init) — ဘယ်လိုဖြေရှင်းမလဲ?
ဒေါင်းလုဒ်ပြီးနောက် auto-init ရပ်ရန် 美洽 embed code နောက်တွင် _MEIQIA('manualInit') ထည့်; လိုအပ်လျှင် manual init ရန် _MEIQIA('init') ခေါ်. default အရ 美洽 က ဒေါင်းလုဒ်ပြီးချက်ချင်း init; container အဆင်သင့် / customer info ပို့ / route တည်ငြိမ်ကို အရင်လိုသောအခါ ထို timing က «စောလွန်း» — order ထိန်းရန် manual init သို့ပြောင်း. code နောက် _MEIQIA('manualInit') ထည့်; condition အဆင်သင့်လျှင် (DOM / session / route) _MEIQIA('init') ခေါ်; info API များကို doc အတိုင်း init timing တွင် order အလိုက်ခေါ်.
ပေါင်းစပ် setup ထပ်: 美洽 ဝက်ဘ်ပေါင်းစပ်, APP SDK ပေါင်းစပ်; စတင်ရန်: 美洽 လမ်းညွှန်. ရှာဖွေနိုင်သော version အပြည့်အစုံ (ဤ tool အပါအဝင်) ကို 美洽 ပေါင်းစပ် troubleshooting (GitHub Pages) တွင်လည်း.