آمار استفاده

روشن کردن#

آمار استفاده تا وقتی روشنش نکنید خاموش است؛ برای هر پروژه جداگانه در Abrova Auth › تنظیمات › آمار استفاده روشن می‌شود (مالکان و مدیران). شمارش از همان لحظه شروع می‌شود؛ چیزی از قبل پر نمی‌شود.

منطقه‌ی زمانی که روزها بر اساس آن شمرده می‌شوند را انتخاب کنید (پیش‌فرض UTC؛ برای کاربران داخل ایران Asia/Tehran) تا «امروز» با بازار شما جور باشد. این یک تنظیم برای هر پروژه است و برای همه‌ی کسانی که آن را می‌بینند یکسان است. تغییر از روز بعد اعمال می‌شود؛ روزهای گذشته اعدادشان را نگه می‌دارند، و در روزِ تغییر ممکن است بعضی کاربران دو بار شمرده شوند.

خاموش کردن، شمارش را متوقف می‌کند و اعداد استفاده‌ی پروژه را حذف می‌کند.

چه چیزی می‌بینید#

در Abrova Auth › نمای کلی › استفاده:

اعداد در حدود یک دقیقه به‌روز می‌شوند. کاربران فعال هفتگی و ماهانه مربوط به هفته‌ی جاری و ماه تقویمی جاری‌اند، نه ۷ یا ۳۰ روزِ اخیر.

«فعال» یعنی چه#

کاربر در روزی فعال است که در آن روز وارد شود یا نشستی را تمدید کند. SDKها access token یک‌ساعته را وقتی کمتر از ۲ دقیقه از اعتبارش مانده و اپ شما (یا SDK دیگری از ابرووا) آن را می‌خواهد تمدید می‌کنند: در عمل وقتی اپ بعد از بیش از یک ساعت باز می‌شود، و تقریباً هر یک ساعت یک بار در حین استفاده.

• درخواستی که رد شود شمرده نمی‌شود: سقف کاربر ماهانه با کیف پول خالی (MAU_LIMIT)، کاربر غیرفعال، نشست منقضی یا پایان‌یافته.
• حذف یک کاربر، یا حذف کاربران ناشناس بی‌استفاده، روزهای گذشته را تغییر نمی‌دهد.

کمبود شناخته‌شده. کاربری که اپ را آخر شب و دوباره کمی بعد از نیمه‌شب، در همان یک ساعت، باز می‌کند، در روز دوم دیده نمی‌شود: توکنش هنوز معتبر است، پس چیزی به Abrova Auth نمی‌رسد. به همین دلیل اعداد روزانه ممکن است کمی کمتر باشند، هرگز بیشتر.

چه چیزی ذخیره می‌شود#

شمارش، نه ردیابی. Abrova Auth فقط ذخیره می‌کند چند نفر از کاربران شما در هر روز فعال بوده‌اند — مثلاً «۳۱۲ کاربر در ۲۴ اکتبر» — و هرگز فهرستی از روزها یا ساعت‌هایی که یک شخص از اپ شما استفاده کرده نگه نمی‌دارد.

• هیچ داده‌ی جدیدی از دستگاه خارج نمی‌شود؛ فقط درخواست‌هایی که Abrova Auth از قبل دریافت می‌کند شمرده می‌شوند.
• هیچ آدرس IP، ایمیل، شماره تلفن، توکن یا شناسه‌ی کاربری بخشی از شمارش نیست.
• اعداد فقط برای شماست: بدون شخص ثالث، بدون تبلیغات، بدون پروفایل‌سازی.
• شمارش‌ها ۴۰۰ روز نگه داشته می‌شوند.

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

رایگان و با موجودی کیف پول#

آمار استفاده هزینه‌ی اضافه‌ای ندارد. اینکه کنسول چه مقدار نشان دهد بستگی دارد به اینکه پروژه‌ی شما فقط از سهمیه‌ی رایگان ماهانه استفاده می‌کند یا به‌صورت پرداخت به‌اندازه‌ی مصرف از موجودی کیف پول هزینه می‌کند:

شمارش‌ها همیشه ۴۰۰ روز نگه داشته می‌شوند؛ فقط چیزی که نمایش داده می‌شود تغییر می‌کند، پس با شارژ کیف پول کل تاریخچه‌تان فوراً نمایش داده می‌شود.

API آمار#

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

curl "https://auth-users.abrova.ir/v1/projects/YOUR_PROJECT_ID/insights?from=2026-10-01&to=2026-10-24" \
  -H "x-api-key: $ABROVA_API_KEY" \
  -H "x-server-secret: $ABROVA_SERVER_SECRET"

{
  "enabled": true,
  "timeZone": "Asia/Tehran",
  "today": "2026-10-24",
  "activeToday": 312,
  "weeklyActive": 1104,
  "monthlyActive": 1840,
  "stickiness": 0.17,
  "days": [
    { "day": "2026-10-24", "active": 312, "new": 41,
      "byPlatform": { "android": 201, "ios": 111 },
      "byMethod": { "anonymous": 290, "google": 22 } }
  ],
  "returning": [
    { "cohort": "2026-10-17", "size": 52, "day1": 21, "day7": 12, "day30": null }
  ]
}

• پارامترهای from و to روزهایی در منطقه‌ی زمانی پروژه‌اند، با قالب YYYY-MM-DD. بدون آن‌ها کل بازه‌ای را که می‌توانید ببینید می‌گیرید؛ بازه‌ای که از آن بیرون بزند به همان کوتاه می‌شود.
• مقادیر day1، day7 و day30 تا وقتی cohort به اندازه‌ی کافی قدیمی نشده null هستند.
• فهرست IPهای مجاز کلید سرور پروژه‌ی شما اعمال می‌شود.

چه چیزی شامل نیست#

رویدادها، قیف‌ها (funnel)، صفحه‌ها و ویژگی‌های سفارشی بخشی از Abrova Auth نیستند: این سرویس کاربران را می‌شمارد، نه کارهایی که انجام می‌دهند. چیزی مثل «آیا کاربران مرحله‌ی ۳ را تمام کردند» را در داده‌های خودتان نگه دارید، مثلاً یک سند Abrova Sync برای هر کاربر.