مینی‌اپ بومی: ثبت دستی مراحل و نتیجه سفر

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

چه زمانی ثبت دستی لازم است؟

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

اکشن‌های سفر

اکشن	کاربرد
`analytics/journey/start`	شروع صریح سفر
`analytics/journey/complete`	پایان موفق سفر
`analytics/journey/cancel`	لغو سفر
`analytics/journey/timeout`	پایان سفر به‌علت اتمام زمان
`analytics/journey/fail`	پایان ناموفق بدون کد دلیل
`analytics/journey/fail/{reason}`	پایان ناموفق با کد دلیل؛ مانند `payment_declined`
`analytics/journey/step/{type}/{id}`	ثبت مرحله دستی با نوع `page`، `dialog` یا `custom`
`analytics/journey/data/{key}/{value}`	افزودن داده فنی و غیرحساس به سفر

ثبت نتیجه همراه تغییر صفحه

اکشن‌ها مانند سایر اکشن‌های Appsan با -> زنجیره می‌شوند. در مثال زیر ابتدا صفحه موفقیت باز و سپس سفر تکمیل می‌شود.

<button
    id="pay-button"
    text="پرداخت"
    onclick="page/success->analytics/journey/complete" />

ثبت مرحله سفارشی

<button
    id="confirm-button"
    text="تأیید"
    onclick="analytics/journey/step/custom/payment-authorized" />

ثبت خطا با دلیل

<button
    id="retry-button"
    text="تلاش دوباره"
    onclick="analytics/journey/fail/payment_declined" />

افزودن داده به سفر

<button
    id="wallet-button"
    text="کیف پول"
    onclick="analytics/journey/data/payment.method/wallet" />

قواعد شناسه و داده

طول شناسه مرحله و کد دلیل حداکثر ۱۲۸ کاراکتر است.
نوع مرحله فقط یکی از page، dialog یا custom است.
در هر سفر حداکثر ۲۰ مقدار داده ثبت می‌شود.
کلید داده حداکثر ۶۴ کاراکتر و شامل حروف، عدد، نقطه، زیرخط یا خط تیره است.
مقدار داده حداکثر ۲۵۶ کاراکتر و مجموع JSON داده‌ها حداکثر ۲۰۴۸ بایت است.

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

ارتباط با تعریف پنل

نوع و شناسه‌ای که در اکشن step می‌فرستید باید با مرحله تعریف‌شده در پنل یکسان باشد. برای نمونه، اکشن analytics/journey/step/custom/payment-authorized در پنل به‌صورت نوع custom و شناسه payment-authorized تعریف می‌شود.

Revision #2
Created 5 September 2026 00:06:55 by a.dadgari
Updated 5 September 2026 00:20:12 by a.dadgari