تحلیل بازدید و سرعت صفحه

تحلیل بازدید و سرعت صفحه در پلن حرفه‌ای هستند و برای هر برنامه یا فانکشن جدا روشن می‌شوند: در داشبورد، پروژه → تنظیمات → تحلیل بازدید. هر دو را با هم یا هر کدام را جدا روشن کنید. در پلن رایگان، این کارت دکمهٔ ارتقا را نشان می‌دهد و API با 402 plan_required پاسخ می‌دهد.

cloudhost analytics enable my-site            # both
cloudhost analytics enable my-site --speed    # speed insights only
cloudhost analytics settings my-site --speed-sample 50

پلتفرم اسکریپت را روی آدرس هر سایتی که میزبانی می‌کند در /_insights/script.js ارائه می‌دهد. حدود ۴ کیلوبایت است، وابستگی ندارد و چیزی در مرورگر ذخیره نمی‌کند. یکی از این‌ها را به سایت اضافه کنید:

<script defer src="/_insights/script.js"></script>

• اسکریپت با بارگذاری هر صفحه و با هر جابه‌جایی در برنامهٔ تک‌صفحه‌ای (history.pushState) یک بازدید صفحه می‌فرستد، و وقتی صفحه پنهان می‌شود معیارهای سرعت همان بارگذاری را.
• رویدادها دسته‌ای و با sendBeacon فرستاده می‌شوند و سرور بی‌درنگ پاسخ می‌دهد؛ تحلیل بازدید هیچ‌وقت سایت را کند نمی‌کند. اگر فشار زیاد باشد، رویدادهای اضافه دور ریخته می‌شوند، نه درخواست‌های سایت.
• کامپوننت‌های Next.js و Astro فقط الگوی مسیر را اضافه می‌کنند (/blog/[slug]) تا سرعت صفحه صفحه‌ها را همان‌طور گروه کند که برنامهٔ شما. بدون آن‌ها، عددها، شناسه‌ها و هش‌های بلند در مسیر به [id] تبدیل می‌شوند.
• فقط /_insights/script.js و /_insights/event مال پلتفرم‌اند؛ هر مسیر دیگری زیر /_insights/ مال سایت شماست.

پروداکشن و پیش‌نمایش جدا نگه داشته می‌شوند؛ پیش‌فرض پروداکشن است. بازه‌های دو روز یا کمتر ساعتی و بازه‌های بلندتر روزانه (به وقت تهران) نشان داده می‌شوند.

بازه یکی از ۲۴ ساعت، ۷، ۳۰ یا ۹۰ روز یا ۱۲ ماه است، یا هر بازه‌ای در محدودهٔ نگه‌داری پلن. هر فهرست یک فیلتر است: روی یک کشور بزنید تا صفحه‌های همان کشور را ببینید. فیلترها با هم جمع می‌شوند.

• بازدیدکنندگان هر روز جدا شمرده می‌شوند (به وقت تهران)؛ کسی که در دو روز می‌آید دو بازدیدکننده است. این بهای ردیابی نکردن است.
• با فیلتر یک صفحه، بازدیدکنندگان همان صفحه شمرده می‌شوند و نرخ پرش نشان داده نمی‌شود.
• نرخ پرش سهم بازدیدهایی است که فقط یک صفحه دیده‌اند.
• در هر ساعت تعداد مسیرهای جدا سقف دارد (حرفه‌ای ۲٬۰۰۰)؛ بقیه با نام (other) شمرده می‌شوند، تا رباتی که آدرس می‌سازد داده‌ها را پر نکند.

هر معیار روی یک منحنی لگ‌نرمال از ۰ تا ۱۰۰ امتیاز می‌گیرد: آستانهٔ «خوب» ۹۰ و آستانهٔ «ضعیف» ۵۰ می‌شود، همان روشی که ابزارهای سنجش سرعت صفحه دارند. امتیاز صفحه میانگین وزنی امتیاز معیارها در صدک ۷۵ است؛ معیاری که گزارشی ندارد وزنش را بین بقیه پخش می‌کند. ۹۰ و بالاتر خوب، ۵۰ تا ۸۹ نیازمند بهبود و زیر ۵۰ ضعیف است.

موبایل و دسکتاپ جدا سنجیده می‌شوند (تبلت با موبایل است). صدک‌ها از شمارش گزارش‌ها در بازه‌های لگاریتمی خوانده می‌شوند و تا حدود ۱۰٪ دقیق‌اند.

برای سایت پربازدید، لازم نیست همهٔ بارگذاری‌ها معیار سرعت بفرستند. در تنظیمات، درصد نمونه را از ۱ تا ۱۰۰ بگذارید: با ۱۰٪، از هر ده بارگذاری صفحه یکی معیارهایش را نگه می‌دارد و هزینهٔ سرعت صفحه یک‌دهم می‌شود. معیارهای یک بارگذاری با هم نگه داشته یا دور ریخته می‌شوند. بازدیدهای صفحه نمونه‌برداری نمی‌شوند.

cloudhost analytics settings my-site --speed-sample 10

بیش از سهم شامل، به ازای هر ۱۰۰ هزار حساب می‌شود؛ قیمت‌ها در صفحهٔ قیمت‌ها هستند. رویدادهایی که دور ریخته می‌شوند (ویژگی خاموش، ربات‌ها، بیش از سقف، بیرون از نمونه) حساب نمی‌شوند.

curl -H "Authorization: Bearer $KEY" \
  "https://api.ibel.ai/v1/apps/my-site/analytics?period=30d&country=IR"

curl -H "Authorization: Bearer $KEY" \
  "https://api.ibel.ai/v1/apps/my-site/speed-insights?device=mobile&period=7d"

همهٔ مسیرها، پارامترها و کدهای خطا در مرجع API هستند.

تحلیل بازدید و سرعت صفحه هیچ داده‌ٔ شخصی‌ای جمع نمی‌کنند. این بیانیه را می‌توانید در اطلاعیهٔ حریم خصوصی سایت‌تان لینک دهید.

• بدون کوکی، بدون ذخیرهٔ محلی، بدون اثرانگشت‌گیری. اسکریپت هیچ چیزی در مرورگر بازدیدکننده ذخیره نمی‌کند.
• هیچ آدرسی نگه داشته نمی‌شود. آدرس IP بازدیدکننده فقط یک بار، وقتی رویداد می‌رسد، برای یافتن کشور به کار می‌رود و بعد دور ریخته می‌شود. هرگز روی دیسک یا در لاگ نوشته نمی‌شود.
• بازدیدکنندگان با هشی شمرده می‌شوند که برگشت‌پذیر نیست. برای شمردن بازدیدکنندگان یکتا، هشی از آدرس و رشتهٔ مرورگر بازدیدکننده با یک نمک تصادفی ایجاد می‌شود که هر روز (به وقت تهران) عوض می‌شود و پس از روز بعد حذف می‌شود. هش فقط برای همان روز و روز بعد نگه داشته می‌شود و بعد همراه نمک حذف می‌شود. نه به یک شخص لینک می‌خورد و نه به همان بازدیدکننده در روزی دیگر یا سایتی دیگر.
• فقط شمارش‌ها نگه داشته می‌شوند. آنچه می‌ماند این است که هر صفحه در هر ساعت چند بازدید و چند بازدیدکننده داشته، بر حسب سایت ارجاع‌دهنده (فقط نام میزبانش، هرگز آدرس کامل)، کشور، نوع دستگاه (دسکتاپ، موبایل، تبلت)، سیستم‌عامل و نام مرورگر؛ و برای سرعت، چند گزارش در هر بازهٔ هر معیار افتاده، بر حسب مسیر و نوع دستگاه.
• رشتهٔ پرس‌وجو و بخش پس از `#` حذف می‌شوند پیش از آنکه چیزی ذخیره شود، پس عبارت‌های جست‌وجو، توکن‌ها و ایمیل‌های درون آدرسها هرگز نگه داشته نمی‌شوند.
• داده‌ها در ایران می‌مانند، روی سرورهای خود پلتفرم، و وقتی مدت نگه‌داری پلن تمام شود حذف می‌شوند؛ یا بی‌درنگ، وقتی مالک پروژه تحلیل بازدید را خاموش کند و داده‌ها را حذف کند.
• برای این داده‌ها، طبق قواعد معمول کوکی، بنر رضایت لازم نیست، چون هیچ اطلاعاتی روی دستگاه بازدیدکننده ذخیره یا از آن خوانده نمی‌شود؛ مسئولیت اطلاعیهٔ حریم خصوصی سایت همچنان با صاحب سایت است.

کشور از فهرستی از بازه‌های IP به کشور خوانده می‌شود که روی سرورهای پلتفرم است؛ برای یافتن کشور هیچ درخواستی به بیرون فرستاده نمی‌شود. بازدیدهای ربات‌ها (از روی رشتهٔ مرورگر) شمرده نمی‌شوند.

خاموش کردن جمع‌آوری را متوقف می‌کند و داده‌های قبلی تا پایان مدت نگه‌داری می‌مانند. «حذف داده‌ها» در تنظیمات (یا cloudhost analytics delete) هر دو ویژگی را خاموش و همهٔ شمارش‌ها را بی‌درنگ حذف می‌کند؛ با نشست داشبورد تایید دوم لازم است.