معرفی تحلیل سفر مینی‌اپ

تحلیل سفر مسیر واقعی کاربر را از زمان باز شدن مینی‌اپ تا رسیدن به نتیجه نهایی ثبت می‌کند. هر سفر مجموعه‌ای مرتب از رویدادها است؛ برای نمونه ورود به صفحه اصلی، نمایش یک گفت‌وگو، رفتن به صفحه پرداخت و در نهایت تکمیل یا خطای سفر.

با این قابلیت می‌توان مشخص کرد کاربران از کدام مسیر عبور می‌کنند، در کدام مرحله متوقف می‌شوند و نرخ تکمیل هر فرایند چقدر است. نتیجه در پنل اپسان، هم به‌صورت تجمیعی و هم در جزئیات هر سفر نمایش داده می‌شود.


چه اطلاعاتی ثبت می‌شود؟

  • زمان شروع و پایان سفر و زمان وقوع هر رویداد
  • مراحل مشاهده‌شده با نوع page، dialog یا custom
  • نتیجه نهایی: تکمیل‌شده، خطا، لغوشده، اتمام زمان یا ناتمام
  • نوع اجرا: مینی‌اپ بومی اندروید یا Web
  • داده‌های فنی و غیرحساس که توسعه‌دهنده به سفر اضافه می‌کند
  • لاگ‌های مجاز، فقط وقتی قانون جمع‌آوری لاگ در تعریف سفر فعال باشد

نکته امنیتی: در رابط تحلیل سفر پنل، شناسه کاربر و شناسه نشست نمایش داده نمی‌شود. در داده‌های سفر نیز اطلاعات شخصی، توکن، شماره تماس و ورودی آزاد کاربر را ثبت نکنید.


نسخه‌های موردنیاز

بخش حداقل نسخه کاربرد
Appsan Core 0.1.78 چرخه اجرای مینی‌اپ و ارتباط با میزبان
Appsan Analytics 0.1.0 ساخت، مرتب‌سازی و ارسال رویدادهای سفر
Appsan Web Extension 0.0.8 پل امن میان WebView و SDK بومی
Appsan Mini Web SDK 0.1.0 تشخیص مسیر و API عمومی مینی‌اپ وب

برای مینی‌اپ کاملاً بومی، دو مورد اول لازم است. برای مینی‌اپ وب داخل Android WebView، هر چهار مورد باید با نسخه‌های بالا یا نسخه سازگار جدیدتر استفاده شوند.


روش‌های ثبت سفر

حالت خودکار

شروع سفر، نمایش صفحات بومی و تغییر مسیرهای معمول وب بدون ثبت دستی توسعه‌دهنده شناسایی می‌شود. این حالت، انتخاب پیش‌فرض است.

حالت دستی

برای مراحل معنایی که از چرخه صفحه یا URL قابل تشخیص نیست، توسعه‌دهنده رویداد را صریحاً ثبت می‌کند؛ مانند نمایش پنجره تأیید، انتخاب روش پرداخت یا پایان موفق یک فرایند چندمرحله‌ای.

صفحات بعدی، نحوه استفاده از هر دو حالت در مینی‌اپ بومی و وب و همچنین تنظیم و مشاهده نتیجه در پنل را توضیح می‌دهند.


Revision #4
Created 5 September 2026 00:01:38 by a.dadgari
Updated 5 September 2026 00:13:23 by a.dadgari