ជំហាន 1: បែងចែកជាបួនក្រុម (ផ្ទុក / config / framework / ការបង្ហាញ)
ទោះ «ឆាតមិនមក» របស់អ្នកជាអ្វី, បង្រួមឱ្យនៅបួនក្រុមជាមុន — នេះក៏សន្សំការវង្វេងភាគច្រើន. ដ្យាក្រាមលំហូរធ្វើឱ្យការសម្រេចច្បាស់: ពិនិត្យថា script ផ្ទុកពិតឬអត់ (meiqia.js ក្នុង F12), បន្ទាប់មកថាជា config, framework ឬបញ្ហាស្រទាប់បង្ហាញ. សម្រាប់មូលដ្ឋានមើល មគ្គុទ្ទេសក៍រួមបញ្ចូលគេហទំព័រ 美洽.
ការរួមបញ្ចូលដំណើរការយ៉ាងណា: ហេតុអ្វីការចាក់ JS នេះបរាជ័យ / ត្រូវទប់ស្កាត់
ប្រយោគមួយក៏គ្រប់គ្រាន់: widget គេហទំព័រ 美洽 មិនមែនសមាសភាគឋិតិវន្តក្នុងទំព័រអ្នក — វាជា meiqia.js ដែលផ្ទុកអសមកាលពីដែនក្រៅរបស់ 美洽 ចាក់ container ឆាត (DOM / iframe) ដោយថាមវន្ត ហើយបើកការតភ្ជាប់ cross-origin យូរអង្វែង. ដើម្បីការចាក់ជោគជ័យត្រូវ «script ផ្ទុក (ទីតាំងល្អ, គ្មាន adblock), container មិនត្រូវ CSS / plugin ផ្សេងគ្រប, entId និង domain ត្រូវគ្នា, និង mount ឡើងវិញបន្ទាប់ផ្លាស់ route SPA». ដ្យាក្រាមខាងក្រោមគូរខ្សែសង្វាក់នេះ និងបួនចំណុចទប់ស្កាត់ — ដូច្នេះកូដដូចគ្នាដំណើរការលើគេហទំព័រ / framework មួយប៉ុន្តែមិននៅមួយផ្សេង.
កូដដាក់ត្រឹមត្រូវប៉ុន្តែនៅមិនបង្ហាញ: រត់ panel ត្រួតពិនិត្យខ្លួនឯងការរួមបញ្ចូល
បើទីតាំង, meiqia.js 200 និង entId បានបញ្ជាក់ទាំងអស់ប៉ុន្តែនៅមិនបង្ហាញ, ជាមូលដ្ឋានជា «adblock» ឬ «framework / ការដាក់ត្រួត». panel ខាងក្រោមរៀបតាមសារៈសំខាន់: បៃតងជាធម្មតាល្អ, ក្រហម (adblock, ការដាក់ត្រួត SPA / plugin ភាគីទីបី) ជាអន្ទាក់ញឹកញាប់. ពិនិត្យម្ដងមួយរកបានលឿន.
តារាងរោគសញ្ញាពេញលេញ (ឥរិយាបថ / ទីតាំងផ្លូវការ · មូលហេតុឫស L2)
តារាងខាងក្រោមរាយរោគសញ្ញាមិនបង្ហាញ / កំហុសទូទៅក្នុងពេលតែមួយ, នីមួយៗជាមួយទីតាំងផ្លូវការ និងមូលហេតុឫស L2. ប្រអប់ស្វែងរកខាងលើដំណើរការដោយទិន្នន័យតារាងនេះ — ស្វែងរកពាក្យគន្លឹះដែលអ្នកជួប.
| រោគសញ្ញា | ក្រុម | ឥរិយាបថ L1 / ទីតាំងផ្លូវការ | មូលហេតុឫស L2 |
|---|---|---|---|
| បង្អួច / ពពុះឆាតមិនបង្ហាញទាល់តែសោះ | បរាជ័យផ្ទុក | widget គេហទំព័រ 美洽 ផ្ទុកបង្អួចឆាតអណ្ដែតដោយ snippet JS តែមួយដែលបិទភ្ជាប់; បញ្ជាក់ថាកូដបង្កប់ត្រឹមត្រូវ ហើយគេហទំព័ររួមបញ្ចូលកំណត់ក្នុង console. | widget ជា meiqia.js ដែលចាក់ចូល DOM បន្ទាប់ផ្ទុកអសមកាល, ដូច្នេះ «គ្មានអ្វីទាល់តែសោះ» ជាញឹកញាប់មានន័យ «script មិនដែលផ្ទុក»: ខុសទីតាំង, ត្រូវ adblock / cache ទប់ស្កាត់, ឬ domain / entId មិនត្រូវ, ដូច្នេះការចាក់មិនដែលដំណើរការ. |
| script ផ្ទុកប៉ុន្តែបាត់ប៊ូតុងឆាត | បញ្ហាការបង្ហាញ | កូដ widget សម្របទៅគេហទំព័រ ហើយបង្ហាញប៊ូតុងឆាត; បើការបង្ហាញបរាជ័យ ពិនិត្យថាត្រូវលាក់ដោយរចនាបថ ឬ init ត្រូវរំខាន. | បើ script ផ្ទុកប៉ុន្តែបាត់ប៊ូតុង, ជាញឹកញាប់បញ្ហា «ស្រទាប់បង្ហាញ»: CSS ទូទាំងគេហទំព័រ override ទីតាំងប៊ូតុង / កំណត់ display:none, z-index ចាញ់, ឬធាតុថេរផ្សេងគ្រប; កំហុស JS ផ្សេងក៏អាចបញ្ឈប់ init. |
| meiqia.js ត្រូវផ្នែកបន្ថែម adblock ទប់ស្កាត់ | បរាជ័យផ្ទុក | script ឆាត 美洽 មកពី domain ភាគីទីបី; បើផ្នែកបន្ថែមទប់ស្កាត់ដំឡើង វាអាចចាត់ទុកជាផ្សាយ / អ្នកតាមដាន ហើយរារាំងការផ្ទុក — បិទការទប់ស្កាត់ ឬ whitelist. | ERR_BLOCKED_BY_CLIENT មានន័យថាផ្នែកបន្ថែម browser (AdBlock / uBlock / AdGuard) ទប់ស្កាត់សំណើតាមបញ្ជីត្រង. script 美洽 ជា «ភាគីទីបីក្រៅដែន + ទំនាក់ទំនងពេលវេលាពិត», ដែលច្បាប់បែបនេះច្រើនយល់ច្រឡំជាផ្សាយ / អ្នកតាមដាន, បង្កបរាជ័យក្លែងក្លាយ «console ល្អ, ខាងអ្នកប្រើបាត់». |
| meiqia.js 404 / ស្ថានភាពអាក្រក់ / មាតិកាចម្រុះ | បរាជ័យផ្ទុក | បន្ទាប់ deploy, ស្វែងរក meiqia.js ក្នុង panel Network; ស្ថានភាព 200 មានន័យថា script ដាក់ត្រឹមត្រូវ ហើយផ្ទុក. | មូលហេតុមិន-200 ទូទៅ: កូដជាប់ cache ទំព័រ / CDN (មិន refresh បន្ទាប់បោះពុម្ព), ផ្ទុកលើទំព័រ HTTP / ខ្សែសង្វាក់វិញ្ញាបនបត្រមិនពេញធ្វើឱ្យទប់ស្កាត់មាតិកាចម្រុះ, ឬកូដខូច / ចម្លងមិនពេញ. ជំហាននេះបរាជ័យ ការចាក់ និងការតភ្ជាប់មិនដែលកើតឡើង. |
| កូដខុសកន្លែង (ទប់ស្កាត់ក្នុង head / គ្មានប្រសិទ្ធភាព) | បរាជ័យផ្ទុក | 美洽 ណែនាំឱ្យបិទភ្ជាប់កូដនៅខាងក្រោមទំព័រ, មុន </body>; widget ដំណើរការបន្ទាប់មាតិកាសំខាន់ផ្ទុក. | widget ត្រូវចាក់ container បន្ទាប់ DOM រួចរាល់. ក្នុង <head> វាទប់ស្កាត់ render (អេក្រង់ទទេជាមុនលើបណ្ដាញខ្សោយ) ឬដំណើរការមុន DOM រួចរាល់ហើយបរាជ័យ; ក្នុង async / module scope ខ្លះលំដាប់ផ្ទុកក៏អាចខុស. |
| រចនាបថ បង្អួច / ប៊ូតុង ឆាតខូច | បញ្ហាការបង្ហាញ | widget ចាក់រចនាបថផ្ទាល់ ហើយសម្របទៅគេហទំព័រ; ការប៉ះទង្គិចជាមួយរចនាបថទូទាំងគេហទំព័រអាចបង្កភាពមិនប្រក្រតីមើលឃើញ. | script 美洽 ចាក់ CSS ពេល runtime; បើរចនាបថទូទាំងគេហទំព័រ (selector សកល / ច្បាប់អាទិភាពខ្ពស់ / reset) override class វាជាមុន, ទីតាំង, ការដាក់ត្រួត និង font ខូច — ផលរំខាននៃ «ការចាក់ថាមវន្ត + ចែករំលែកលំហរចនាបថឯកសារតែមួយ». |
| ប៊ូតុងក្រៅអេក្រង់ / ត្រូវគ្រប | បញ្ហាការបង្ហាញ | ប៊ូតុង widget លេចជាអណ្ដែតទីតាំងថេរ; បើត្រូវធាតុថេរផ្សេងគ្រប កែការដាក់ត្រួត ឬទីតាំង. | ធាតុ position:fixed ផ្សេងនៃគេហទំព័រ (ឡើងលើ, ផ្សាយអណ្ដែត, របារគាំទ្រផ្ទាល់) ដោយ z-index ខ្ពស់ជាងគ្របប៊ូតុង 美洽, ឬ theme គណនាកូអរដោនេខុស, ទុកវា «ក្រៅអេក្រង់ / ត្រូវគ្រប». |
| ការប៉ះទង្គិច DOM plugin / analytics ភាគីទីបី | បញ្ហាការបង្ហាញ | script ផ្សេងលើទំព័រដែលកែ DOM ឬស្ទាក់សំណើអាចប៉ះពាល់ការផ្ទុក និងការបង្ហាញធម្មតារបស់ widget. | script heatmap / analytics / conversion សរសេរ DOM ឡើងវិញ, ចាក់ overlay ឬស្ទាក់សំណើ; ដោយវា និង 美洽 ចាក់ចូលឯកសារតែមួយ, ការដាក់ត្រួត / events រំខានគ្នា ហើយ container 美洽 ត្រូវគ្រប ឬ init វារំខាន. |
| widget បាត់បន្ទាប់ផ្លាស់ route SPA | ការរួមបញ្ចូល framework | សម្រាប់កម្មវិធីទំព័រតែមួយ (SPA) ប្រើ route hook របស់ framework ដើម្បីផ្ទុក / init widget 美洽 ឱ្យសមនឹង routing front-end. | SPA ប្ដូរ views តាម routing front-end, បំផ្លាញ / បង្កើត DOM ឡើងវិញ, ប៉ុន្តែ meiqia.js តាមលំនាំដើមចាក់ម្ដងពេលផ្ទុកដំបូង ហើយមិនបង្កើតឡើងវិញដោយខ្លួនឯងពេលផ្លាស់ route, ដូច្នេះ «ប្ដូរទំព័រ, ឆាតបាត់». |
| ត្រូវ init ដោយដៃ (manualInit / init) | ការរួមបញ្ចូល framework | បន្ថែម _MEIQIA('manualInit') បន្ទាប់កូដបង្កប់ 美洽 ដើម្បីបញ្ឈប់ auto-init បន្ទាប់ទាញយក; ហៅ _MEIQIA('init') ដើម្បី init ដោយដៃពេលត្រូវការ. | តាមលំនាំដើម 美洽 auto-init ភ្លាមបន្ទាប់ទាញយក; ពេលអ្នកត្រូវ container រួចរាល់ / បញ្ជូនព័ត៌មានអតិថិជន / route ស្ថិរភាពជាមុន, ពេលនោះ «លឿនពេក» — ប្ដូរទៅ init ដោយដៃដើម្បីគ្រប់គ្រងលំដាប់. |
| entId មិនត្រូវ / ភ្នាក់ងារមិនទទួលឆាត | Config / ការអនុញ្ញាត | លេខបន្ទាប់ entId ក្នុងកូដជា id តែមួយរបស់ក្រុមហ៊ុនអ្នក; មិនត្រូវនឹង workbench ភ្នាក់ងារមិនអាចបម្រើឆាត — រក ID ក្រុមហ៊ុនក្នុង ការកំណត់ - ក្រុម - ស្វែងរក ID. | entId ភ្ជាប់ snippet ទៅគណនីក្រុមហ៊ុនជាក់លាក់. ដោយកូដអ្នកដទៃ / បរិស្ថានផ្សេង, ឬគណនីលាយ, front-end ផ្ទុកបង្អួចប៉ុន្តែសារទៅ «ក្រុមហ៊ុនផ្សេង», ដូច្នេះ workbench នេះមិនទទួលអ្វី — បុរាណ «មើលល្អប៉ុន្តែមិនទទួលអ្វី». |
| domain គេហទំព័រមិនបានអនុញ្ញាតក្នុង console | Config / ការអនុញ្ញាត | console 美洽 អនុញ្ញាត «បន្ថែមគេហទំព័ររួមបញ្ចូល», នីមួយៗមាន config ផ្ទាល់; គេហទំព័រថ្មីត្រូវកំណត់ក្នុង console មុនពេលរួមបញ្ចូលល្អ. | 美洽 គ្រប់គ្រងគេហទំព័រច្រើនជា «គេហទំព័ររួមបញ្ចូល»; domain ត្រូវចុះបញ្ជី / អនុញ្ញាតក្នុង console ដើម្បីត្រូវស្គាល់. domain production ថ្មីដែលមិនបន្ថែមអាចមិនត្រូវទទួល ឬ map ទៅ config ខុស. |
| ច្រើនគេហទំព័រ / ឆានែលរង (probe) លាយ | Config / ការអនុញ្ញាត | 美洽 គាំទ្រ deploy widget និងតំណឆាតផ្សេងគ្នាក្នុងមួយគេហទំព័រ (ឆានែលរង / probe); ក្រៅពីគេហទំព័រលំនាំដើម អ្នកអាចបន្ថែមទៀត, នីមួយៗមាន config ផ្ទាល់. | ខ្សែអាជីវកម្មផ្សេងត្រូវក្រុមភ្នាក់ងារ / សារ auto ផ្សេង, ប៉ុន្តែបើរាល់គេហទំព័រចែករំលែក snippet លំនាំដើមតែមួយ, ប្រភពមិនអាចបែង ហើយ config លាយ. ឆានែលរង (probe) រចនាសម្រាប់ «ក្រុមហ៊ុនមួយ, ច្រកចូលច្រើន, routed». |
| ឆាតគេហទំព័រទូរស័ព្ទមិនបង្ហាញ / ត្រូវ deploy ដាច់ | ទូរស័ព្ទ / SDK | កូដ widget សម្របទៅគេហទំព័រ; ទូរស័ព្ទ / PC ប្រើ snippet ដូចគ្នាប៉ុន្តែត្រូវ deploy ដាច់ដោយឡែក. | ក្រុមជាច្រើនមានទំព័រ / template PC និងទូរស័ព្ទដាច់ ហើយបិទភ្ជាប់កូដតែក្នុង template PC. snippet ដូចគ្នា ហើយសម្របខ្លួន, ប៉ុន្តែជំហាន «បិទភ្ជាប់» ត្រូវធ្វើក្នុង template ទូរស័ព្ទផង; ខកខាន ទូរស័ព្ទគ្មានឆាត. |
| ការរួមបញ្ចូល SDK native app / AppKey | ទូរស័ព្ទ / SDK | ការរួមបញ្ចូលក្នុង app ត្រូវ AppKey ពី workbench 美洽 (ការកំណត់ - រួមបញ្ចូល - SDK, «បន្ថែម config APP»), ហើយអ្នកអភិវឌ្ឍន៍រួមបញ្ចូល SDK iOS / Android តាមឯកសារ និង demo ផ្លូវការ. | app ប្រើ SDK native, មិនមែន JS web: ដំបូង «បន្ថែម config APP» សម្រាប់ AppKey, បន្ទាប់រួមបញ្ចូល SDK ក្នុងមួយ platform សម្រាប់ UI ឆាត, មិនអាន, push ។ល។ — ផ្លូវខុសពី widget web ទាំងស្រុង. |
| push សារ SDK មិនមកដល់ | ទូរស័ព្ទ / SDK | push SDK 美洽 មានពីររបៀប: «គ្មាន push» សារភ្នាក់ងារទៅដល់តែក្នុង app (បើក app ដើម្បីទទួល); «server push ផ្ទាល់ខ្លួន» អ្នកប្រើទទួល push ទៅទូរស័ព្ទទោះបន្ទាប់ចេញ app. | ខ្វះ «push offline» ជាញឹកញាប់មានន័យរបៀប push «គ្មាន push», ឬគ្មាន server push ផ្ទាល់ខ្លួន / វិញ្ញាបនបត្រ push ក្នុងមួយ platform. ផ្លូវ «美洽 → server app → ទូរស័ព្ទអ្នកប្រើ»; តំណខ្វះទុកការទទួលក្នុង app តែប៉ុណ្ណោះ. |
| លាក់ប៊ូតុងលំនាំដើម / ច្រកចូលផ្ទាល់ខ្លួន | ការហៅ API | ហៅ _MEIQIA('withoutBtn') ដើម្បីមិនបង្ហាញប៊ូតុង native 美洽; បន្ទាប់ init ជោគជ័យ ហៅ _MEIQIA('showPanel') ដើម្បីបើកឆាត. | តាមលំនាំដើម render ប៊ូតុងអណ្ដែត native; សម្រាប់ច្រកចូលអ្នកត្រូវប្រកាស «គ្មានប៊ូតុង native» មុន / ពេល init ហើយចង «បើកឆាត» ទៅធាតុអ្នក — រឿងពេលវេលា API, មិនមែន «ប៊ូតុងខូច». |
| បញ្ជូន / sync ព័ត៌មានអតិថិជនគ្មានប្រសិទ្ធភាព | ការហៅ API | widget គេហទំព័រ 美洽 ផ្ដល់ API «បញ្ជូនព័ត៌មានអតិថិជន», «sync អត្តសញ្ញាណអតិថិជន» និង «បន្ថែមព័ត៌មាន event ផ្ទាល់ខ្លួន» ដើម្បីនាំទិន្នន័យអ្នកទស្សនាចូលឆាត. | API ទាំងនេះត្រូវហៅក្នុងពេល init ត្រឹមត្រូវ: បន្ទាប់ init ជោគជ័យ (ឬក្នុងពេល manualInit + init). លឿន / យឺតពេក, ឬទ្រង់ទ្រាយ field ខុស, ហើយ «កំណត់ប៉ុន្តែគ្មានប្រសិទ្ធភាព». |
美洽 មូលហេតុមិនបង្ហាញ & ការប្រៀបធៀបវិធីរួមបញ្ចូល (ការប៉ាន់ស្មាន 2026)
ខាងក្រោមជា ការប៉ាន់ស្មាន 2026 ដែលសំយោគពីជំនួយផ្លូវការ 美洽 (ឆានែលចូល / API widget គេហទំព័រ JavaScript) និងការដោះស្រាយបញ្ហារួមបញ្ចូលសាធារណៈ (មិនមែនការសន្យារបស់អ្នកលក់ ឬការវាស់វែងផ្ទាល់; សម្រាប់យោង, ប្រែតាមកំណែ និងគោលការណ៍ browser):
| វិមាត្រ | ការប៉ាន់ស្មាន / ការប្រៀបធៀប |
|---|---|
| ការបែងចែកមូលហេតុមិនបង្ហាញ (សហគមន៍ / ticket · ប៉ាន់.) | ទីតាំង / មិនផ្ទុក ~35% > adblock / ផ្នែកបន្ថែម browser ~25% > config / ការអនុញ្ញាត (entId / domain) ~20% > framework (SPA) ~12% > ប៉ះទង្គិចរចនាបថ / plugin ភាគីទីបី ~8% |
| ការរួមបញ្ចូលពិតជាអ្វី | widget web = JS អសមកាលភាគីទីបីក្រៅដែនដែលចាក់ DOM + ការតភ្ជាប់ cross-origin យូរអង្វែង (មិនមែនសមាសភាគឋិតិវន្តបង្កប់); ដូច្នេះរងផលពីទីតាំង, ច្បាប់ adblock, ការដាក់ត្រួត CSS, វដ្តជីវិត SPA |
| ការរួមបញ្ចូលក្នុងមួយ platform (ប៉ាន់.) | web PC / ទូរស័ព្ទ = widget JS (កូដដូចគ្នា, deploy ដាច់); app = SDK native (AppKey); WeChat / Douyin / RED = ការរួមបញ្ចូលអនុញ្ញាតឆានែល |
| ផល adblock (ប៉ាន់.) | ប្រហែល 30-40% នៃអ្នកប្រើ PC ប្រើផ្នែកបន្ថែម adblock → script ឆាតភាគីទីបីត្រូវទប់ស្កាត់តាមច្បាប់ផ្សាយ (ERR_BLOCKED_BY_CLIENT), មូលហេតុចម្បងនៃ «console ល្អ, ខាងអ្នកប្រើបាត់» |
| ពេលផ្សាយ widget JS (ផ្លូវការ) | បិទភ្ជាប់ JS ឯកទេសនៅខាងក្រោមទំព័រហើយផ្សាយក្នុងប្រហែល 3-5 នាទី; entId ជា id តែមួយរបស់ក្រុមហ៊ុន, ហើយការមិនត្រូវនឹង workbench ទុកភ្នាក់ងារគ្មានឆាត |
មូលដ្ឋានការប៉ាន់ស្មាន: baseline ប្រភព + ការ extrapolate ពេលវេលា (meiqia.com/help ឆានែលចូល / widget គេហទំព័រ JavaScript, មគ្គុទ្ទេសក៍រួមបញ្ចូល meiqia.im, ការដោះស្រាយបញ្ហាសាធារណៈ, 2026); ប្រែតាមកំណែ និងគោលការណ៍ទប់ស្កាត់ browser. អនុវត្តតាមព័ត៌មានផ្លូវការថ្មីបំផុតរបស់ 美洽. មិនផ្លូវការ · មូលដ្ឋានីយកម្ម LLM.
ប្រៀបធៀបវិធីរួមបញ្ចូល 美洽 ប្រាំ (កូដ / ភាពលំបាក / មុខងារ / សេណារីយ៉ូ / ពេលផ្សាយ)
វិធីរួមបញ្ចូលណា? ការប្រៀបធៀបខាងក្រោមសំយោគឯកសារផ្លូវការ 美洽 សម្រាប់ការយោងឆ្លងលឿន (បរិមាណកូដ, ភាពពេញលេញមុខងារ, ភាពសម, ពេលផ្សាយ). គេហទំព័រភាគច្រើនជ្រើស «widget JS web».
| វិធីរួមបញ្ចូល | កូដ / ភាពលំបាក | ភាពពេញលេញមុខងារ | សមរម្យសម្រាប់ | ពេលផ្សាយ |
|---|---|---|---|---|
| widget JS web | snippet JS តែមួយ · ទាប | ពេញបំផុត (អណ្ដែត / popup / ស្វាគមន៍ស្វ័យ / ដាននៃអ្នកទស្សនា) | គេហទំព័រ PC + ទូរស័ព្ទ (ណែនាំផ្លូវការ) | ~3-5 នាទី |
| តំណឆាត | គ្មានកូដ · ទាបបំផុត | ឆាតមូលដ្ឋាន | គ្មានបច្ចេកទេស / ដាក់តំណឆាតលឿន | ភ្លាមៗ |
| API / WebIM SDK | ត្រូវអភិវឌ្ឍ · ខ្ពស់ | ប្ដូរតាមបំណងស៊ីជម្រៅ (UI ផ្ទាល់ / ប្រព័ន្ធ / រួមបញ្ចូលការបញ្ជាទិញ) | ក្រុមមានសមត្ថភាព dev សម្រាប់ការលាយស៊ីជម្រៅ | តាម dev |
| SDK native app | រួមបញ្ចូល SDK · ខ្ពស់ | ឆាតក្នុង app + push សារ | app iOS / Android | តាម dev |
| ការកំណត់រហ័ស CMS | plugin / ចុចមួយ · ទាប | ដូច widget JS | គេហទំព័រ WordPress / Fkw / Shopify | នាទី |
ឆានែល / សេណារីយ៉ូ → ផែនទីលទ្ធផលរួមបញ្ចូល
美洽 ដូចគ្នារួមបញ្ចូលខុសគ្នាតាមឆានែល / សេណារីយ៉ូ. ផែនទីខាងក្រោមបង្ហាញឆានែលទូទៅ: បៃតង = បិទភ្ជាប់ហើយដំណើរការ, លឿង = ត្រូវ setup (deploy ដាច់ / init / whitelist), ក្រហម = ប្ដូរវិធីតាមលំនាំដើម (adblock / entId / app ប្រើ SDK).
សំណួរញឹកញាប់
美洽 បង្អួច / ពពុះឆាតមិនបង្ហាញទាល់តែសោះ — ដោះស្រាយយ៉ាងណា?
widget គេហទំព័រ 美洽 ផ្ទុកបង្អួចឆាតអណ្ដែតដោយ snippet JS តែមួយដែលបិទភ្ជាប់; បញ្ជាក់ថាកូដបង្កប់ត្រឹមត្រូវ ហើយគេហទំព័ររួមបញ្ចូលកំណត់ក្នុង console. widget ជា meiqia.js ដែលចាក់ចូល DOM បន្ទាប់ផ្ទុកអសមកាល, ដូច្នេះ «គ្មានអ្វីទាល់តែសោះ» ជាញឹកញាប់មានន័យ «script មិនដែលផ្ទុក»: ខុសទីតាំង, ត្រូវ adblock / cache ទប់ស្កាត់, ឬ domain / entId មិនត្រូវ, ដូច្នេះការចាក់មិនដែលដំណើរការ. F12 → Network, ស្វែងរក meiqia.js: គ្មានសំណើ → កូដគ្មានប្រសិទ្ធភាព (ពិនិត្យទីតាំង / សម្អាត cache); សំណើប៉ុន្តែមិន-200 → ត្រូវទប់ស្កាត់ ឬបញ្ហាផ្លូវ; អ្វីៗល្អប៉ុន្តែនៅលាក់ → ពិនិត្យ entId / ការអនុញ្ញាត domain និងក្រុមខាងក្រោម.
美洽 script ផ្ទុកប៉ុន្តែបាត់ប៊ូតុងឆាត — ដោះស្រាយយ៉ាងណា?
កូដ widget សម្របទៅគេហទំព័រ ហើយបង្ហាញប៊ូតុងឆាត; បើការបង្ហាញបរាជ័យ ពិនិត្យថាត្រូវលាក់ដោយរចនាបថ ឬ init ត្រូវរំខាន. បើ script ផ្ទុកប៉ុន្តែបាត់ប៊ូតុង, ជាញឹកញាប់បញ្ហា «ស្រទាប់បង្ហាញ»: CSS ទូទាំងគេហទំព័រ override ទីតាំងប៊ូតុង / កំណត់ display:none, z-index ចាញ់, ឬធាតុថេរផ្សេងគ្រប; កំហុស JS ផ្សេងក៏អាចបញ្ឈប់ init. F12 → Elements, ស្វែងរក container 美洽 — មាន, លាក់, ឬក្រៅអេក្រង់?; បិទ CSS / script ផ្ទាល់ជាបណ្ដោះអាសន្នដើម្បីសាកម្ដងទៀត; ពិនិត្យ console រកកំហុសដែលបញ្ឈប់ការប្រតិបត្តិ.
美洽 meiqia.js ត្រូវផ្នែកបន្ថែម adblock ទប់ស្កាត់ — ដោះស្រាយយ៉ាងណា?
script ឆាត 美洽 មកពី domain ភាគីទីបី; បើផ្នែកបន្ថែមទប់ស្កាត់ដំឡើង វាអាចចាត់ទុកជាផ្សាយ / អ្នកតាមដាន ហើយរារាំងការផ្ទុក — បិទការទប់ស្កាត់ ឬ whitelist. ERR_BLOCKED_BY_CLIENT មានន័យថាផ្នែកបន្ថែម browser (AdBlock / uBlock / AdGuard) ទប់ស្កាត់សំណើតាមបញ្ជីត្រង. script 美洽 ជា «ភាគីទីបីក្រៅដែន + ទំនាក់ទំនងពេលវេលាពិត», ដែលច្បាប់បែបនេះច្រើនយល់ច្រឡំជាផ្សាយ / អ្នកតាមដាន, បង្កបរាជ័យក្លែងក្លាយ «console ល្អ, ខាងអ្នកប្រើបាត់». សាកម្ដងទៀតក្នុងរបៀបអនាមិក ឬបិទ adblock — បើលេច ការទប់ស្កាត់ជាមូលហេតុ; សុំអ្នកប្រើ whitelist គេហទំព័រ; front-end អាចផ្ទុក script ឆាតយឺត / មានលក្ខខណ្ឌដើម្បីជៀសច្បាប់ auto ខ្លះ.
美洽 meiqia.js 404 / ស្ថានភាពអាក្រក់ / មាតិកាចម្រុះ — ដោះស្រាយយ៉ាងណា?
បន្ទាប់ deploy, ស្វែងរក meiqia.js ក្នុង panel Network; ស្ថានភាព 200 មានន័យថា script ដាក់ត្រឹមត្រូវ ហើយផ្ទុក. មូលហេតុមិន-200 ទូទៅ: កូដជាប់ cache ទំព័រ / CDN (មិន refresh បន្ទាប់បោះពុម្ព), ផ្ទុកលើទំព័រ HTTP / ខ្សែសង្វាក់វិញ្ញាបនបត្រមិនពេញធ្វើឱ្យទប់ស្កាត់មាតិកាចម្រុះ, ឬកូដខូច / ចម្លងមិនពេញ. ជំហាននេះបរាជ័យ ការចាក់ និងការតភ្ជាប់មិនដែលកើតឡើង. សម្អាត cache CDN / browser (ឬអនាមិក) បន្ទាប់បោះពុម្ព; ធានា HTTPS ពេញដោយខ្សែសង្វាក់វិញ្ញាបនបត្រពេញ និងគ្មានមាតិកាចម្រុះ; ផ្ទៀងផ្ទាត់កូដចម្លងពេញ និងមិន escape.
美洽 កូដខុសកន្លែង (ទប់ស្កាត់ក្នុង head / គ្មានប្រសិទ្ធភាព) — ដោះស្រាយយ៉ាងណា?
美洽 ណែនាំឱ្យបិទភ្ជាប់កូដនៅខាងក្រោមទំព័រ, មុន </body>; widget ដំណើរការបន្ទាប់មាតិកាសំខាន់ផ្ទុក. widget ត្រូវចាក់ container បន្ទាប់ DOM រួចរាល់. ក្នុង <head> វាទប់ស្កាត់ render (អេក្រង់ទទេជាមុនលើបណ្ដាញខ្សោយ) ឬដំណើរការមុន DOM រួចរាល់ហើយបរាជ័យ; ក្នុង async / module scope ខ្លះលំដាប់ផ្ទុកក៏អាចខុស. ដាក់ JS 美洽 ក្នុង footer រួមនៃរាល់ទំព័រ, មុន </body>; សម្រាប់ SPA មើលធាតុ «route SPA» ហើយប្រើ manualInit; ធានា bundler មិនលុបវាតាម tree-shaking.
美洽 រចនាបថ បង្អួច / ប៊ូតុង ឆាតខូច — ដោះស្រាយយ៉ាងណា?
widget ចាក់រចនាបថផ្ទាល់ ហើយសម្របទៅគេហទំព័រ; ការប៉ះទង្គិចជាមួយរចនាបថទូទាំងគេហទំព័រអាចបង្កភាពមិនប្រក្រតីមើលឃើញ. script 美洽 ចាក់ CSS ពេល runtime; បើរចនាបថទូទាំងគេហទំព័រ (selector សកល / ច្បាប់អាទិភាពខ្ពស់ / reset) override class វាជាមុន, ទីតាំង, ការដាក់ត្រួត និង font ខូច — ផលរំខាននៃ «ការចាក់ថាមវន្ត + ចែករំលែកលំហរចនាបថឯកសារតែមួយ». F12 ដើម្បីមើលច្បាប់គេហទំព័រណា override container 美洽; បង្រួមរចនាបថទូទាំងគេហទំព័រ / កាត់បន្ថយផលលើ class ទូទៅ; បើចាំបាច់សុំ 美洽 កែការដាក់ត្រួត container.
美洽 ប៊ូតុងក្រៅអេក្រង់ / ត្រូវគ្រប — ដោះស្រាយយ៉ាងណា?
ប៊ូតុង widget លេចជាអណ្ដែតទីតាំងថេរ; បើត្រូវធាតុថេរផ្សេងគ្រប កែការដាក់ត្រួត ឬទីតាំង. ធាតុ position:fixed ផ្សេងនៃគេហទំព័រ (ឡើងលើ, ផ្សាយអណ្ដែត, របារគាំទ្រផ្ទាល់) ដោយ z-index ខ្ពស់ជាងគ្របប៊ូតុង 美洽, ឬ theme គណនាកូអរដោនេខុស, ទុកវា «ក្រៅអេក្រង់ / ត្រូវគ្រប». ជ្រើស container 美洽 ក្នុង F12 ដើម្បីមើលកូអរដោនេ / z-index ពិត; លើកវាឡើង ឬបន្ថយ z-index ធាតុដែលគ្រប; ជៀសការដាក់ត្រួតអណ្ដែតថេរច្រើនក្នុងជ្រុងតែមួយ.
美洽 ការប៉ះទង្គិច DOM plugin / analytics ភាគីទីបី — ដោះស្រាយយ៉ាងណា?
script ផ្សេងលើទំព័រដែលកែ DOM ឬស្ទាក់សំណើអាចប៉ះពាល់ការផ្ទុក និងការបង្ហាញធម្មតារបស់ widget. script heatmap / analytics / conversion សរសេរ DOM ឡើងវិញ, ចាក់ overlay ឬស្ទាក់សំណើ; ដោយវា និង 美洽 ចាក់ចូលឯកសារតែមួយ, ការដាក់ត្រួត / events រំខានគ្នា ហើយ container 美洽 ត្រូវគ្រប ឬ init វារំខាន. បិទ plugin សង្ស័យម្ដងមួយដើម្បីរក conflict; កែលំដាប់ផ្ទុក / ការដាក់ត្រួត container; ឱ្យ heatmap ។ល។ ជៀសតំបន់ container 美洽.
美洽 widget បាត់បន្ទាប់ផ្លាស់ route SPA — ដោះស្រាយយ៉ាងណា?
សម្រាប់កម្មវិធីទំព័រតែមួយ (SPA) ប្រើ route hook របស់ framework ដើម្បីផ្ទុក / init widget 美洽 ឱ្យសមនឹង routing front-end. SPA ប្ដូរ views តាម routing front-end, បំផ្លាញ / បង្កើត DOM ឡើងវិញ, ប៉ុន្តែ meiqia.js តាមលំនាំដើមចាក់ម្ដងពេលផ្ទុកដំបូង ហើយមិនបង្កើតឡើងវិញដោយខ្លួនឯងពេលផ្លាស់ route, ដូច្នេះ «ប្ដូរទំព័រ, ឆាតបាត់». ប្រើ _MEIQIA('manualInit') ដើម្បីបញ្ឈប់ auto-init ហើយហៅ _MEIQIA('init') ក្នុង route hook (React useEffect / Vue mounted / router afterEach) ដើម្បី mount ឡើងវិញតាមត្រូវការ; ជៀស init instance ច្រើន.
美洽 ត្រូវ init ដោយដៃ (manualInit / init) — ដោះស្រាយយ៉ាងណា?
បន្ថែម _MEIQIA('manualInit') បន្ទាប់កូដបង្កប់ 美洽 ដើម្បីបញ្ឈប់ auto-init បន្ទាប់ទាញយក; ហៅ _MEIQIA('init') ដើម្បី init ដោយដៃពេលត្រូវការ. តាមលំនាំដើម 美洽 auto-init ភ្លាមបន្ទាប់ទាញយក; ពេលអ្នកត្រូវ container រួចរាល់ / បញ្ជូនព័ត៌មានអតិថិជន / route ស្ថិរភាពជាមុន, ពេលនោះ «លឿនពេក» — ប្ដូរទៅ init ដោយដៃដើម្បីគ្រប់គ្រងលំដាប់. បន្ថែម _MEIQIA('manualInit') បន្ទាប់កូដ; ហៅ _MEIQIA('init') ពេលលក្ខខណ្ឌរួចរាល់ (DOM / session / route); ហៅ API ព័ត៌មានតាមលំដាប់ក្នុងពេល init តាមឯកសារ.
ការ setup រួមបញ្ចូលបន្ថែម: រួមបញ្ចូលគេហទំព័រ 美洽, រួមបញ្ចូល SDK APP; ដើម្បីចាប់ផ្ដើម: មគ្គុទ្ទេសក៍ 美洽. កំណែពេញលេញស្វែងរកបាន (រួមឧបករណ៍នេះ) ក៏នៅ ការដោះស្រាយបញ្ហារួមបញ្ចូល 美洽 (GitHub Pages).