رفتن به محتوا

آمار و تحلیل

آمار و تحلیل داخلی برای هر اپلیکیشن منتشرشده در Proyecta. برای مشاهده ترافیک، Web Vitals و تفکیک دستگاه‌ها، در builder به Admin > Analytics بروید.

هر اپلیکیشن Proyecta به‌صورت پیش‌فرض با قابلیت آمار و تحلیل ارائه می‌شود. نیازی به نصب چیزی، جای‌گذاری کد اسنیپت یا داشتن حساب در سرویس‌های شخص ثالث نیست. جمع‌آوری داده برای هر اپلیکیشن منتشرشده به‌طور خودکار فعال می‌شود؛ داشبورد آمار و تحلیل درون builder در پلن Pro و بالاتر در دسترس است. برای مشاهده داده‌های سایت منتشرشده‌تان، در builder به Admin > Analytics بروید.

آمار و تحلیل دارای سه نما است که در نوار کناری Admin فهرست شده‌اند:

نما محتوا
Overview ترافیک — بازدید صفحات، بازدیدکنندگان، جلسات، صفحات برتر، و نمودار سری زمانی روزانه (منابع ارجاع در تب Devices نمایش داده می‌شوند)
Web Vitals Core Web Vitals (LCP، INP، CLS) جمع‌آوری‌شده از کاربران واقعی
Devices مرورگرها و منابع ترافیک (ارجاع‌دهنده‌ها)

چه داده‌هایی رهگیری می‌شوند؟

Section titled “چه داده‌هایی رهگیری می‌شوند؟”

آمار و تحلیل به‌صورت خودکار از سایت منتشرشده شما (زیردامنه *.proyecta.live یا دامنه اختصاصی‌تان) جمع‌آوری می‌شود. ترافیک preview درون builder محاسبه نمی‌شود.

بازه زمانی فعلی ۷ روز گذشته است. امکان انتخاب بازه تاریخ سفارشی در roadmap قرار دارد.

چطور به آن دسترسی داشته باشم؟

Section titled “چطور به آن دسترسی داشته باشم؟”

پروژه‌تان را در builder باز کنید، به نمای Admin بروید، سپس در نوار کناری Analytics را انتخاب کنید. مشاهده آن نیازمند پلن Pro یا بالاتر است — در پلن رایگان به‌جای آن یک پیام ارتقاء پلن نمایش داده می‌شود. در پلن پولی، نمای Overview به‌صورت پیش‌فرض بارگذاری می‌شود؛ از نوار کناری می‌توانید بین Overview، Web Vitals و Devices جابجا شوید.

رهگیری رویدادهای سفارشی

Section titled “رهگیری رویدادهای سفارشی”

فراتر از جمع‌آوری خودکار بازدید صفحه و Web Vitals، اپلیکیشن شما می‌تواند رویدادهای سفارشی خودش را ثبت کند — ثبت‌نام، خرید، استفاده از ویژگی‌ها، یا هر چیزی که برایتان اهمیت دارد. رویدادهای سفارشی به‌طور خودکار به اپلیکیشن شما نسبت داده می‌شوند.

اپلیکیشن شما از قبل با tracker وصل شده، پس می‌توانید track() را از هر جایی در کد React فراخوانی کنید:

import { track } from '@proyecta-ai/analytics';
// Fire from an event handler, an effect, or right after a successful write.
track('signup', { plan: 'pro', referrer: 'newsletter' });
track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

پراپرتی‌ها یک آبجکت ساده از رشته‌ها و اعداد هستند. track() هرگز خطا نمی‌دهد و نیازی به بررسی null ندارد — اگر analytics هنوز مقداردهی اولیه نشده باشد، فراخوانی به‌سادگی نادیده گرفته می‌شود؛ بنابراین استفاده از آن در حین رندر یا در اولین paint کاملاً ایمن است.

از AI بخواهید این را پیاده‌سازی کند: "Track a 'signup' event whenever a new user registers."

آیا باید Google Analytics یا Mixpanel اضافه کنم؟

نه. آمار و تحلیل به‌صورت داخلی تعبیه شده و برای هر اپلیکیشن منتشرشده‌ای به‌طور خودکار فعال است. اگر می‌خواهید علاوه بر آن از یک سرویس شخص ثالث هم استفاده کنید، می‌توانید از AI بخواهید آن را یکپارچه کند — کلید API سرویس مورد نظرتان را در بخش Environment Variables صفحه Settings وارد کنید و بگویید "Add Google Analytics to my app".

آیا به پلن پولی نیاز دارم؟

جمع‌آوری داده برای هر اپلیکیشن منتشرشده‌ای، صرف‌نظر از پلن، اجرا می‌شود. بخش Analytics در Admin یک ویژگی Pro است — در پلن رایگان یک پیام ارتقاء پلن نمایش داده می‌شود. رهگیری رویدادهای سفارشی در هر پلنی کار می‌کند.

چرا داده‌ای نمی‌بینم؟

آمار و تحلیل فقط نسخه منتشرشده اپلیکیشن شما را رهگیری می‌کند. اگر هنوز چیزی publish نکرده‌اید، یا اگر سایت منتشرشده‌تان در ۷ روز گذشته ترافیکی نداشته، پنل خالی خواهد بود. ترافیک preview درون builder محاسبه نمی‌شود. (همچنین مطمئن شوید که از پلن Pro استفاده می‌کنید — خود داشبورد نیازمند Pro است.)

آیا می‌توانم داده‌ها را خروجی بگیرم؟

هنوز نه. خروجی CSV در roadmap قرار دارد.

آیا می‌توانم بازه تاریخ دیگری انتخاب کنم؟

هنوز نه. پنل ۷ روز گذشته را نشان می‌دهد. بازه‌های سفارشی در roadmap قرار دارند.

آیا داده‌های بازدیدکنندگان ناشناس‌سازی می‌شوند؟

آمار و تحلیل Proyecta از یک کوکی first-party (_pry_vid) برای شناسایی بازدیدکنندگان بازگشتی استفاده می‌کند. کاربران را در سایت‌های شخص ثالث رهگیری نمی‌کند. اینکه آیا به بنر رضایت کوکی نیاز دارید یا نه، به حوزه قضایی کاربرانتان بستگی دارد (برای مثال، GDPR در اتحادیه اروپا ممکن است برای شناسه‌های دائمی نیاز به رضایت داشته باشد). با مشاور حقوقی خود مشورت کنید.

  • بازه‌های تاریخ قابل تنظیم (24 ساعته، 30 روزه، سفارشی)
  • خروجی CSV
  • رهگیری تبدیل و اهداف