مینیاپ بومی: ثبت دستی مراحل و نتیجه سفر
حالت خودکار برای ثبت نمایش صفحات و دیالوگها کافی است. هرجا یک مرحله از روی چرخه رابط قابل تشخیص نیست، یا نتیجه سفر باید صریح باشد، از اکشنهای 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 با -> زنجیره میشوند. در مثال زیر ابتدا صفحه موفقیت باز و سپس سفر تکمیل میشود.
ثبت مرحله سفارشی
ثبت خطا با دلیل
افزودن داده به سفر
قواعد شناسه و داده
- طول شناسه مرحله و کد دلیل حداکثر ۱۲۸ کاراکتر است.
- نوع مرحله فقط یکی از
page،dialogیاcustomاست. - در هر سفر حداکثر ۲۰ مقدار داده ثبت میشود.
- کلید داده حداکثر ۶۴ کاراکتر و شامل حروف، عدد، نقطه، زیرخط یا خط تیره است.
- مقدار داده حداکثر ۲۵۶ کاراکتر و مجموع JSON دادهها حداکثر ۲۰۴۸ بایت است.
نکته امنیتی: نام کاربر، شماره تماس، توکن، شماره سفارش و متن آزاد را در شناسه، دلیل خطا یا داده سفر قرار ندهید. برای موارد متغیر از کدهای عمومی و پایدار استفاده کنید.
ارتباط با تعریف پنل
نوع و شناسهای که در اکشن step میفرستید باید با مرحله تعریفشده در پنل یکسان باشد. برای نمونه، اکشن analytics/journey/step/custom/payment-authorized در پنل بهصورت نوع custom و شناسه payment-authorized تعریف میشود.
No Comments