مینی‌اپ بومی: حالت خودکار و تنظیم سفر در پنل
در مینی‌اپ بومی، افزونه Analytics چرخه اجرای مینی‌اپ و نمایش عناصر page و dialog را به‌صورت خودکار به رویدادهای سفر تبدیل می‌کند.
چه چیزهایی خودکار ثبت می‌شوند؟
- با رندر شدن مینی‌اپ، رویداد شروع سفر ساخته می‌شود.
- هر عنصر
pageیاdialogهنگام نمایش، با شناسه فنی خود به‌عنوان مرحله ثبت می‌شود. - ترتیب رخدادها داخل هر سفر به‌صورت افزایشی نگهداری می‌شود.
- اگر مینی‌اپ بدون نتیجه صریح بسته شود، سفر با نتیجه لغوشده و دلیل
app_closedپایان می‌یابد.
نکته: شناسه عناصر باید پایدار، کوتاه و غیرحساس باشد؛ مانند checkout، payment-confirmation یا error-network. متن قابل‌نمایش، شماره سفارش و اطلاعات کاربر را به‌عنوان ID استفاده نکنید.
تنظیم سفر در پنل اپسان
ثبت رویدادها مستقل از تعریف پنل انجام می‌شود؛ اما برای ساخت قیف، محاسبه نرخ عبور مراحل و تشخیص خطا باید یک تعریف فعال ایجاد شود.
- از منوی مینی‌اپ‌های شما، مینی‌اپ موردنظر را باز کنید.
- به زبانه سفرها بروید و تنظیم سفرها را انتخاب کنید.
- دکمه تعریف جدید را بزنید.
- نوع تعریف را انتخاب کنید: سفر برای مسیر انعطاف‌پذیر یا قیف تبدیل برای ترتیب مشخص مراحل.
- نام و توضیح فارسی وارد کنید و گزینه تعریف فعال باشد را روشن نگه دارید.
- مراحل را به‌ترتیب اضافه کنید. نوع و شناسه هر مرحله باید دقیقاً با
pageیاdialogدر XML برابر باشد. - در صورت نیاز، قوانین خطا را با تطبیق دقیق یا Regex تعریف کنید و سپس ذخیره تعریف را بزنید.
۱. ورود به زبانه سفرها
۲. باز کردن تنظیمات سفر
۳. ایجاد تعریف جدید و افزودن مراحل
قوانین خطا
مشاهده یک صفحه یا دیالوگ می‌تواند سفر را خودکار خطادار کند. در حالت تطبیق دقیق، ID باید کاملاً برابر باشد. در حالت Regex، الگو روی کل ID اجرا می‌شود؛ برای نمونه error-(network|timeout).
Regex فقط روی شناسه فنی اجرا می‌شود، نه متن دیالوگ یا محتوای لاگ. موتور مشترک سرور و Android از قواعد RE2 استفاده می‌کند و Lookaround یا Backreference را پشتیبانی نمی‌کند.
error-networkمشاهده نتیجه
در زبانه سفرها، جدول سفرها شناسه سفر، زمان شروع، نتیجه و تعداد مراحل را نشان می‌دهد. با انتخاب آیکون مشاهده، جزئیات مرتب مراحل باز می‌شود. داشبورد نیز تعداد کل سفرها، نرخ تکمیل، مراحل مشاهده‌شده و تفکیک نتایج را نمایش می‌دهد.
No Comments