گام ۱: به چهار گروه تقسیم کنید (بارگذاری / پیکربندی / فریمورک / نمایش)
هر «گفتگو نیامد» که دارید، ابتدا به چهار گروه محدود کنید — همین بهتنهایی بیشتر دور زدنها را صرفهجویی میکند. فلوچارت تصمیم را روشن میکند: بررسی کنید اسکریپت اصلاً بارگذاری شد (meiqia.js در F12)، سپس پیکربندی، فریمورک یا مشکل لایه نمایش است. برای پایه ببینید راهنمای یکپارچهسازی وب 美洽.
یکپارچهسازی چگونه کار میکند: چرا این تزریق JS ناموفق / مسدود میشود
یک جمله کافی است: ابزارک وب 美洽 یک مؤلفه ایستا در صفحه شما نیست — بلکه meiqia.js است که بهصورت ناهمگام از دامنه بیرونی 美洽 بارگذاری میشود، بهصورت پویا یک ظرف گفتگو (DOM / iframe) تزریق و یک اتصال طولانیمدت میانمبدأ باز میکند. برای موفقیت تزریق به «اسکریپت بارگذاریشده (مکان خوب، بدون adblock)، ظرف نپوشانده با CSS / افزونههای دیگر، entId و دامنه همخوان، و نصب مجدد پس از تغییر مسیر SPA» نیاز است. نمودار زیر این زنجیره و چهار نقطه مسدودسازی را میکشد — به همین دلیل همان کد روی یک سایت / فریمورک کار میکند اما روی دیگری نه.
کد درست گذاشته اما هنوز نمایش داده نمیشود: پنل خودبررسی یکپارچهسازی را اجرا کنید
اگر مکان، meiqia.js 200 و entId همه تأیید شده اما هنوز نمایش داده نمیشود، اساساً «adblock» یا «فریمورک / انباشت» است. پنل زیر بر اساس اهمیت مرتب است: سبز معمولاً سالم، قرمزها (adblock، انباشت SPA / افزونه شخص ثالث) دامهای پرتکرارند. بررسی مورد به مورد آن را سریع موضعی میکند.
جدول کامل علائم (رفتار / موقعیت رسمی · علت ریشهای L2)
جدول زیر یکجا علائم رایج نمایشنشدن / خطا را فهرست میکند، هرکدام با موقعیت رسمی و علت ریشهای L2. کادر جستجوی بالا با داده این جدول کار میکند — کلیدواژهای که دیدهاید را جستجو کنید.
| علامت | گروه | رفتار L1 / موقعیت رسمی | علت ریشهای L2 |
|---|---|---|---|
| پنجره / حباب گفتگو اصلاً نمایش داده نمیشود | شکست بارگذاری | ابزارک وب 美洽 با یک قطعه JS چسباندهشده یک پنجره گفتگوی شناور بارگذاری میکند؛ تأیید کنید کد درست تعبیه شده و سایت یکپارچهسازی در کنسول پیکربندی شده است. | ابزارک همان meiqia.js است که پس از بارگذاری ناهمگام به DOM تزریق میشود، پس «هیچچیز» معمولاً یعنی «اسکریپت هرگز بارگذاری نشد»: مکان اشتباه، مسدود با adblock / حافظه پنهان، یا دامنه / entId ناهمخوان، پس تزریق هرگز اجرا نشد. |
| اسکریپت بارگذاری شده اما دکمه گفتگو نیست | مشکلات نمایش | کد ابزارک با سایت سازگار میشود و دکمه گفتگو نشان میدهد؛ اگر نمایش ناموفق است، بررسی کنید آیا با استایل پنهان شده یا مقداردهی قطع شده. | اگر اسکریپت بارگذاری اما دکمه نیست، معمولاً مشکل «لایه نمایش» است: CSS سراسری موقعیت دکمه را بازنویسی / display:none میکند، z-index بازنده میشود، یا عنصر ثابت دیگری آن را میپوشاند؛ خطای JS دیگر هم میتواند مقداردهی را قطع کند. |
| meiqia.js با افزونه adblock مسدود شده | شکست بارگذاری | اسکریپت گفتگوی 美洽 از دامنه شخص ثالث میآید؛ اگر افزونه مسدودکننده نصب باشد ممکن است آن را تبلیغ / ردیاب بداند و بارگذاری را مانع شود — مسدودسازی را خاموش یا به فهرست سفید بیفزایید. | ERR_BLOCKED_BY_CLIENT یعنی افزونه مرورگر (AdBlock / uBlock / AdGuard) درخواست را با فهرستهای فیلتر مسدود کرده. اسکریپت 美洽 «شخص ثالث خارج از دامنه + ارتباط بیدرنگ» است که این قوانین اغلب با تبلیغ / ردیاب اشتباه میگیرند و شکست کاذب «کنسول سالم، سمت کاربر نیست» میسازند. |
| meiqia.js 404 / وضعیت بد / محتوای مختلط | شکست بارگذاری | پس از استقرار، meiqia.js را در پنل Network جستجو کنید؛ وضعیت ۲۰۰ یعنی اسکریپت درست جایگذاری و بارگذاری شده. | علل رایج غیر ۲۰۰: کد گیرافتاده در حافظه پنهان صفحه / CDN (پس از انتشار تازه نشده)، بارگذاری روی صفحه HTTP / زنجیره گواهی ناقص که مسدودسازی محتوای مختلط را برمیانگیزد، یا کد خراب / ناقص کپیشده. با شکست این گام، تزریق و اتصال هرگز رخ نمیدهند. |
| کد در جای اشتباه (مسدودسازی در head / بیاثر) | شکست بارگذاری | 美洽 توصیه میکند کد را پایین صفحه، پیش از </body> بچسبانید؛ ابزارک پس از بارگذاری محتوای اصلی اجرا میشود. | ابزارک باید ظرف خود را پس از آمادهشدن DOM تزریق کند. در <head> رندر را مسدود میکند (روی شبکه ضعیف ابتدا صفحه خالی) یا پیش از آمادهشدن DOM اجرا و ناموفق میشود؛ در برخی scopeهای async / ماژول ترتیب بارگذاری هم میتواند خراب شود. |
| استایل پنجره / دکمه گفتگو خراب | مشکلات نمایش | ابزارک استایل خود را تزریق و با سایت سازگار میشود؛ تعارض با استایلهای سراسری میتواند نقص بصری ایجاد کند. | اسکریپت 美洽 در زمان اجرا CSS تزریق میکند؛ اگر استایلهای سراسری (انتخابگرهای عمومی / قوانین اولویت بالا / reset) کلاسهای آن را زودتر بازنویسی کنند، موقعیت، انباشت و فونت خراب میشوند — عارضه جانبی «تزریق پویا + اشتراک یک فضای استایل سند». |
| دکمه بیرون صفحه / پوشانده | مشکلات نمایش | دکمه ابزارک بهصورت شناور با موقعیت ثابت ظاهر میشود؛ اگر با عناصر ثابت دیگر پوشانده شد، انباشت یا موقعیت را تنظیم کنید. | عناصر position:fixed دیگر سایت (بازگشت به بالا، تبلیغ شناور، نوار پشتیبانی خودتان) با z-index بالاتر دکمه 美洽 را میپوشانند، یا قالب مختصاتش را اشتباه محاسبه میکند و آن را «بیرون صفحه / پوشانده» میگذارد. |
| تعارض DOM با افزونه / تحلیل شخص ثالث | مشکلات نمایش | اسکریپتهای دیگر صفحه که DOM را تغییر یا درخواستها را رهگیری میکنند میتوانند بر بارگذاری و نمایش عادی ابزارک اثر بگذارند. | اسکریپتهای نقشه حرارتی / تحلیل / تبدیل DOM را بازنویسی، رویهم تزریق یا درخواستها را رهگیری میکنند؛ چون آنها و 美洽 در یک سند تزریق میشوند، انباشت / رویدادها تداخل و ظرف 美洽 پوشانده یا init آن قطع میشود. |
| ابزارک پس از تغییر مسیر SPA ناپدید میشود | یکپارچهسازی فریمورک | برای برنامههای تکصفحه (SPA) از قلابهای مسیر فریمورک برای بارگذاری / init ابزارک 美洽 استفاده کنید تا با مسیریابی فرانتاند هماهنگ شود. | SPA نماها را با مسیریابی فرانتاند عوض میکند، DOM را نابود / بازسازی میکند، اما meiqia.js بهطور پیشفرض یکبار در بارگذاری اول تزریق میکند و هنگام تغییر مسیر خودبهخود بازسازی نمیشود، پس «صفحه عوض، گفتگو رفت». |
| init دستی لازم است (manualInit / init) | یکپارچهسازی فریمورک | برای توقف init خودکار پس از دانلود، _MEIQIA('manualInit') را پس از کد جاسازی 美洽 بیفزایید؛ برای init دستی هنگام نیاز _MEIQIA('init') را فراخوانید. | بهطور پیشفرض 美洽 بلافاصله پس از دانلود init میشود؛ وقتی ابتدا به ظرف آماده / اطلاعات مشتری ارسالشده / مسیر پایدار نیاز دارید، آن زمانبندی «خیلی زود» است — برای کنترل ترتیب به init دستی بروید. |
| entId ناهمخوان / کارشناسان گفتگو دریافت نمیکنند | پیکربندی / مجوز | عدد پس از entId در کد شناسه یکتای شرکت شماست؛ اگر با میز کار همخوان نباشد کارشناسان نمیتوانند گفتگو را اداره کنند — شناسه شرکت را در تنظیمات - تیم - جستجوی شناسه بیابید. | entId قطعه را به یک حساب شرکت مشخص پیوند میدهد. با کد دیگری / محیط دیگر، یا حسابهای قاطی، فرانتاند پنجره را بارگذاری میکند اما پیامها به «شرکت دیگر» میروند، پس این میز کار هیچ دریافت نمیکند — کلاسیک «سالم بهنظر اما هیچ دریافت نمیکند». |
| دامنه سایت در کنسول مجاز نشده | پیکربندی / مجوز | کنسول 美洽 «افزودن سایت یکپارچهسازی» را مجاز میکند، هرکدام با پیکربندی خود؛ سایت جدید باید پیش از یکپارچهسازی درست در کنسول پیکربندی شود. | 美洽 چند سایت را بهعنوان «سایت یکپارچهسازی» مدیریت میکند؛ دامنه باید برای شناسایی در کنسول ثبت / مجاز شود. دامنه تولید جدید نیفزوده ممکن است پذیرفته نشود یا به پیکربندی اشتباه نگاشته شود. |
| چندسایت / زیرکانال (پروب) قاطیشده | پیکربندی / مجوز | 美洽 از استقرار ابزارکها و پیوندهای گفتگوی متفاوت برای هر سایت پشتیبانی میکند (زیرکانال / پروب)؛ علاوه بر سایت پیشفرض میتوانید بیشتر بیفزایید، هرکدام با پیکربندی خود. | خطوط کسبوکار متفاوت گروه کارشناس / پیام خودکار متفاوت میخواهند، اما اگر هر سایت یک قطعه پیشفرض را به اشتراک بگذارد، منابع تمیز داده نمیشوند و پیکربندیها قاطی میشوند. زیرکانالها (پروب) برای «یک شرکت، چند ورودی، مسیریابیشده» طراحی شدهاند. |
| گفتگوی وب موبایل نمایش داده نمیشود / استقرار جدا لازم است | موبایل / SDK | کد ابزارک با سایت سازگار میشود؛ موبایل / رایانه همان قطعه را بهکار میبرند اما باید جدا مستقر شوند. | بسیاری تیمها صفحه / قالب رایانه و موبایل جدا دارند و کد را فقط در قالب رایانه چسباندهاند. قطعه همان است و خودسازگار میشود، اما گام «چسباندن» باید در قالب موبایل هم انجام شود؛ اگر جا بماند، موبایل گفتگو ندارد. |
| یکپارچهسازی SDK بومی برنامه / AppKey | موبایل / SDK | یکپارچهسازی درونبرنامه به AppKey از میز کار 美洽 نیاز دارد (تنظیمات - یکپارچهسازی - SDK، «افزودن پیکربندی APP»)، و توسعهدهندگان SDK iOS / Android را طبق مستندات و دموی رسمی یکپارچه میکنند. | برنامه از SDK بومی استفاده میکند، نه JS وب: ابتدا «افزودن پیکربندی APP» برای AppKey، سپس SDK را برای هر سکو برای رابط گفتگو، نخوانده، push و جز آن یکپارچه کنید — مسیری کاملاً متفاوت از ابزارک وب. |
| push پیام SDK نمیرسد | موبایل / SDK | push در SDK 美洽 دو حالت دارد: با «بدون push» پیامهای کارشناس فقط درون برنامه میرسند (برای دریافت آن را باز کنید)؛ با «سرور push سفارشی» کاربران حتی پس از خروج از برنامه روی تلفن push دریافت میکنند. | نبود «push آفلاین» معمولاً یعنی حالت push «بدون push» است، یا سرور push سفارشی / گواهی push هر سکو نیست. مسیر «美洽 ← سرور برنامه ← تلفن کاربر» است؛ حلقه گمشده فقط دریافت درونبرنامه را میگذارد. |
| پنهانکردن دکمه پیشفرض / ورودی سفارشی | فراخوانیهای API | برای نمایشندادن دکمه بومی 美洽 _MEIQIA('withoutBtn') را فراخوانید؛ پس از موفقیت init برای باز کردن گفتگو _MEIQIA('showPanel') را فراخوانید. | بهطور پیشفرض دکمه شناور بومی رندر میشود؛ برای ورودی خود باید پیش / حین init «بدون دکمه بومی» را اعلام و «باز کردن گفتگو» را به عنصرتان ببندید — مسئله زمانبندی API است، نه «دکمه خراب». |
| ارسال / همگامسازی اطلاعات مشتری بیاثر است | فراخوانیهای API | ابزارک وب 美洽 APIهای «ارسال اطلاعات مشتری»، «همگامسازی هویت مشتری» و «افزودن اطلاعات رویداد سفارشی» را برای آوردن داده بازدیدکننده به گفتگو ارائه میدهد. | این APIها باید در زمانبندی درست init فراخوانده شوند: پس از موفقیت init (یا در زمانبندی manualInit + init). خیلی زود / دیر، یا قالب فیلد اشتباه، و «تنظیم اما بیاثر» میشود. |
美洽 علل نمایشنشدن & مقایسه روشهای یکپارچهسازی (برآورد 2026)
موارد زیر برآوردهای 2026 ترکیبشده از راهنمای رسمی 美洽 (کانالهای دسترسی / API ابزارک وب JavaScript) و عیبیابی عمومی یکپارچهسازی است (نه تعهد فروشنده و نه اندازهگیری دستاول؛ برای مرجع، با نسخه و سیاست مرورگر تغییر میکند):
| بُعد | برآورد / مقایسه |
|---|---|
| توزیع علل نمایشنشدن (جامعه / تیکت · بر.) | مکان / بارگذارینشده ~۳۵٪ > adblock / افزونه مرورگر ~۲۵٪ > پیکربندی / مجوز (entId / دامنه) ~۲۰٪ > فریمورک (SPA) ~۱۲٪ > تعارض استایل / افزونه شخص ثالث ~۸٪ |
| یکپارچهسازی واقعاً چیست | ابزارک وب = JS ناهمگام شخص ثالث خارج از دامنه که DOM را تزریق میکند + اتصال طولانیمدت میانمبدأ (نه مؤلفه ایستای تعبیهشده)؛ از این رو متأثر از مکان، قوانین adblock، انباشت CSS، چرخه عمر SPA |
| یکپارچهسازی هر سکو (بر.) | وب رایانه / موبایل = ابزارک JS (همان کد، جدا مستقر)؛ برنامه = SDK بومی (AppKey)؛ WeChat / Douyin / RED = یکپارچهسازی مجاز کانال |
| اثر adblock (بر.) | حدود ۳۰-۴۰٪ کاربران رایانه افزونه adblock دارند ← اسکریپت گفتگوی شخص ثالث با قوانین تبلیغات مسدود میشود (ERR_BLOCKED_BY_CLIENT)، علت اصلی «کنسول سالم، سمت کاربر نیست» |
| زمان فعالشدن ابزارک JS (رسمی) | JS اختصاصی را پایین صفحه بچسبانید تا در حدود ۳-۵ دقیقه فعال شود؛ entId شناسه یکتای شرکت است و ناهمخوانی با میز کار کارشناسان را بیگفتگو میگذارد |
مبنای برآورد: خط پایه منابع + برونیابی زمانی (meiqia.com/help کانالهای دسترسی / ابزارک وب JavaScript، راهنمای یکپارچهسازی meiqia.im، عیبیابی عمومی، 2026)؛ با نسخه و سیاست مسدودسازی مرورگر تغییر میکند. آخرین اطلاعات رسمی 美洽 را دنبال کنید. غیررسمی · بومیسازی LLM.
مقایسه پنج روش یکپارچهسازی 美洽 (کد / دشواری / ویژگیها / سناریو / زمان فعالشدن)
کدام روش یکپارچهسازی؟ مقایسه زیر مستندات رسمی 美洽 را برای مرجع متقاطع سریع ترکیب میکند (حجم کد، کاملبودن ویژگی، بهترین تناسب، زمان فعالشدن). بیشتر سایتها «ابزارک JS وب» را برمیگزینند.
| روش یکپارچهسازی | کد / دشواری | کاملبودن ویژگی | بهترین برای | زمان فعالشدن |
|---|---|---|---|---|
| ابزارک JS وب | یک قطعه JS · کم | کاملترین (شناور / پاپآپ / خوشآمد خودکار / رد بازدیدکننده) | سایتهای رایانه + موبایل (توصیه رسمی) | ~۳-۵ دقیقه |
| پیوند گفتگو | بدون کد · حداقل | گفتگوی پایه | بدون فنی / گذاشتن پیوند گفتگوی سریع | آنی |
| API / WebIM SDK | نیازمند توسعه · بالا | سفارشیسازی عمیق (رابط خود / سیستم / یکپارچهسازی سفارش) | تیمهای دارای توان توسعه برای ادغام عمیق | بسته به توسعه |
| SDK بومی برنامه | یکپارچهسازی SDK · بالا | گفتگوی درونبرنامه + push پیام | برنامههای iOS / Android | بسته به توسعه |
| تنظیم سریع CMS | افزونه / یککلیک · کم | مانند ابزارک JS | سایتهای WordPress / Fkw / Shopify | دقایق |
کانال / سناریو → نقشه نتیجه یکپارچهسازی
همان 美洽 بر اساس کانال / سناریو متفاوت یکپارچه میشود. نقشه زیر کانالهای رایج را نشان میدهد: سبز = بچسبان و کار میکند، کهربایی = تنظیم لازم (استقرار جدا / init / فهرست سفید)، قرمز = پیشفرض روش را عوض کنید (adblock / entId / برنامه از SDK استفاده میکند).
پرسشهای متداول
美洽 پنجره / حباب گفتگو اصلاً نمایش داده نمیشود — چگونه رفع شود؟
ابزارک وب 美洽 با یک قطعه JS چسباندهشده یک پنجره گفتگوی شناور بارگذاری میکند؛ تأیید کنید کد درست تعبیه شده و سایت یکپارچهسازی در کنسول پیکربندی شده است. ابزارک همان meiqia.js است که پس از بارگذاری ناهمگام به DOM تزریق میشود، پس «هیچچیز» معمولاً یعنی «اسکریپت هرگز بارگذاری نشد»: مکان اشتباه، مسدود با adblock / حافظه پنهان، یا دامنه / entId ناهمخوان، پس تزریق هرگز اجرا نشد. F12 → Network، meiqia.js را جستجو کنید: بدون درخواست ← کد بیاثر (مکان را بررسی / حافظه را پاک کنید)؛ درخواست اما غیر ۲۰۰ ← مسدود یا مشکل مسیر؛ همهچیز سالم اما هنوز پنهان ← entId / مجوز دامنه و گروههای زیر را بررسی کنید.
美洽 اسکریپت بارگذاری شده اما دکمه گفتگو نیست — چگونه رفع شود؟
کد ابزارک با سایت سازگار میشود و دکمه گفتگو نشان میدهد؛ اگر نمایش ناموفق است، بررسی کنید آیا با استایل پنهان شده یا مقداردهی قطع شده. اگر اسکریپت بارگذاری اما دکمه نیست، معمولاً مشکل «لایه نمایش» است: CSS سراسری موقعیت دکمه را بازنویسی / display:none میکند، z-index بازنده میشود، یا عنصر ثابت دیگری آن را میپوشاند؛ خطای JS دیگر هم میتواند مقداردهی را قطع کند. F12 → Elements، ظرف 美洽 را بیابید — موجود، پنهان، یا بیرون صفحه؟؛ موقتاً CSS / اسکریپتهای خود را خاموش و دوباره آزمایش کنید؛ کنسول را برای خطای قطع اجرا بررسی کنید.
美洽 meiqia.js با افزونه adblock مسدود شده — چگونه رفع شود؟
اسکریپت گفتگوی 美洽 از دامنه شخص ثالث میآید؛ اگر افزونه مسدودکننده نصب باشد ممکن است آن را تبلیغ / ردیاب بداند و بارگذاری را مانع شود — مسدودسازی را خاموش یا به فهرست سفید بیفزایید. ERR_BLOCKED_BY_CLIENT یعنی افزونه مرورگر (AdBlock / uBlock / AdGuard) درخواست را با فهرستهای فیلتر مسدود کرده. اسکریپت 美洽 «شخص ثالث خارج از دامنه + ارتباط بیدرنگ» است که این قوانین اغلب با تبلیغ / ردیاب اشتباه میگیرند و شکست کاذب «کنسول سالم، سمت کاربر نیست» میسازند. در حالت ناشناس یا با خاموشبودن adblock دوباره آزمایش کنید — اگر ظاهر شد، مسدودسازی علت بوده؛ از کاربران بخواهید سایت را به فهرست سفید بیفزایند؛ فرانتاند میتواند اسکریپت گفتگو را با تأخیر / مشروط بارگذاری کند تا برخی قوانین خودکار را دور بزند.
美洽 meiqia.js 404 / وضعیت بد / محتوای مختلط — چگونه رفع شود؟
پس از استقرار، meiqia.js را در پنل Network جستجو کنید؛ وضعیت ۲۰۰ یعنی اسکریپت درست جایگذاری و بارگذاری شده. علل رایج غیر ۲۰۰: کد گیرافتاده در حافظه پنهان صفحه / CDN (پس از انتشار تازه نشده)، بارگذاری روی صفحه HTTP / زنجیره گواهی ناقص که مسدودسازی محتوای مختلط را برمیانگیزد، یا کد خراب / ناقص کپیشده. با شکست این گام، تزریق و اتصال هرگز رخ نمیدهند. پس از انتشار حافظه پنهان CDN / مرورگر را پاک کنید (یا حالت ناشناس)؛ HTTPS کامل با زنجیره گواهی سالم و بدون محتوای مختلط را تضمین کنید؛ تأیید کنید کد کپیشده کامل و بدون escape است.
美洽 کد در جای اشتباه (مسدودسازی در head / بیاثر) — چگونه رفع شود؟
美洽 توصیه میکند کد را پایین صفحه، پیش از </body> بچسبانید؛ ابزارک پس از بارگذاری محتوای اصلی اجرا میشود. ابزارک باید ظرف خود را پس از آمادهشدن DOM تزریق کند. در <head> رندر را مسدود میکند (روی شبکه ضعیف ابتدا صفحه خالی) یا پیش از آمادهشدن DOM اجرا و ناموفق میشود؛ در برخی scopeهای async / ماژول ترتیب بارگذاری هم میتواند خراب شود. JS مربوط به 美洽 را در فوتر مشترک هر صفحه، پیش از </body> بگذارید؛ برای SPA مدخل «مسیر SPA» را ببینید و از manualInit استفاده کنید؛ مطمئن شوید بستهبند آن را با tree-shaking حذف نمیکند.
美洽 استایل پنجره / دکمه گفتگو خراب — چگونه رفع شود؟
ابزارک استایل خود را تزریق و با سایت سازگار میشود؛ تعارض با استایلهای سراسری میتواند نقص بصری ایجاد کند. اسکریپت 美洽 در زمان اجرا CSS تزریق میکند؛ اگر استایلهای سراسری (انتخابگرهای عمومی / قوانین اولویت بالا / reset) کلاسهای آن را زودتر بازنویسی کنند، موقعیت، انباشت و فونت خراب میشوند — عارضه جانبی «تزریق پویا + اشتراک یک فضای استایل سند». F12 تا ببینید کدام قانون سایت ظرف 美洽 را بازنویسی میکند؛ استایلهای سراسری را محدود / اثر روی کلاسهای عمومی را کم کنید؛ در صورت نیاز از 美洽 بخواهید انباشت ظرف را تنظیم کند.
美洽 دکمه بیرون صفحه / پوشانده — چگونه رفع شود؟
دکمه ابزارک بهصورت شناور با موقعیت ثابت ظاهر میشود؛ اگر با عناصر ثابت دیگر پوشانده شد، انباشت یا موقعیت را تنظیم کنید. عناصر position:fixed دیگر سایت (بازگشت به بالا، تبلیغ شناور، نوار پشتیبانی خودتان) با z-index بالاتر دکمه 美洽 را میپوشانند، یا قالب مختصاتش را اشتباه محاسبه میکند و آن را «بیرون صفحه / پوشانده» میگذارد. ظرف 美洽 را در F12 انتخاب کنید تا مختصات / z-index واقعی را ببینید؛ آن را بالا ببرید یا z-index عنصر پوشاننده را پایین بیاورید؛ از انباشت چند شناور ثابت در یک گوشه بپرهیزید.
美洽 تعارض DOM با افزونه / تحلیل شخص ثالث — چگونه رفع شود؟
اسکریپتهای دیگر صفحه که DOM را تغییر یا درخواستها را رهگیری میکنند میتوانند بر بارگذاری و نمایش عادی ابزارک اثر بگذارند. اسکریپتهای نقشه حرارتی / تحلیل / تبدیل DOM را بازنویسی، رویهم تزریق یا درخواستها را رهگیری میکنند؛ چون آنها و 美洽 در یک سند تزریق میشوند، انباشت / رویدادها تداخل و ظرف 美洽 پوشانده یا init آن قطع میشود. افزونههای مشکوک را یکییکی خاموش کنید تا تعارض را بیابید؛ ترتیب بارگذاری / انباشت ظرف را تنظیم کنید؛ کاری کنید نقشه حرارتی و مانند آن از ناحیه ظرف 美洽 دوری کنند.
美洽 ابزارک پس از تغییر مسیر SPA ناپدید میشود — چگونه رفع شود؟
برای برنامههای تکصفحه (SPA) از قلابهای مسیر فریمورک برای بارگذاری / init ابزارک 美洽 استفاده کنید تا با مسیریابی فرانتاند هماهنگ شود. SPA نماها را با مسیریابی فرانتاند عوض میکند، DOM را نابود / بازسازی میکند، اما meiqia.js بهطور پیشفرض یکبار در بارگذاری اول تزریق میکند و هنگام تغییر مسیر خودبهخود بازسازی نمیشود، پس «صفحه عوض، گفتگو رفت». برای توقف init خودکار از _MEIQIA('manualInit') استفاده و در یک قلاب مسیر (React useEffect / Vue mounted / router afterEach) _MEIQIA('init') را برای نصب مجدد در صورت نیاز فراخوانید؛ از init چند نمونه بپرهیزید.
美洽 init دستی لازم است (manualInit / init) — چگونه رفع شود؟
برای توقف init خودکار پس از دانلود، _MEIQIA('manualInit') را پس از کد جاسازی 美洽 بیفزایید؛ برای init دستی هنگام نیاز _MEIQIA('init') را فراخوانید. بهطور پیشفرض 美洽 بلافاصله پس از دانلود init میشود؛ وقتی ابتدا به ظرف آماده / اطلاعات مشتری ارسالشده / مسیر پایدار نیاز دارید، آن زمانبندی «خیلی زود» است — برای کنترل ترتیب به init دستی بروید. _MEIQIA('manualInit') را پس از کد بیفزایید؛ وقتی شرایط آماده شد (DOM / نشست / مسیر) _MEIQIA('init') را فراخوانید؛ APIهای اطلاعات را طبق مستندات به ترتیب در زمانبندی init فراخوانید.
تنظیم یکپارچهسازی بیشتر: یکپارچهسازی وب 美洽، یکپارچهسازی SDK برنامه؛ برای شروع: راهنمای 美洽. نسخه کامل قابلجستجو (شامل این ابزار) همچنین در عیبیابی یکپارچهسازی 美洽 (GitHub Pages).