عن المشروع

هذا المستودع عبارة عن قالب لإنشاء منصة تحليلات ويب تعتمد على Events API و Endpoints الخاصة بـ Tinybird. يركز القالب على الخصوصية والسرعة، ويوضح ملف README أنه يمكن للمستخدمين الحصول على مقاييس فورية في لوحة تحكم مسبقة الصنع خلال دقائق دون معرفة سابقة بـ Tinybird. بعد الإعداد، يمكن للمستخدمين إضافة أحداث مخصصة لحالات استخدام مثل التجارة الإلكترونية أو التسويق مع الحفاظ على الأداء الفوري. الإعداد: يتم استنساخ المستودع، والدخول إلى دليل tinybird، وتثبيت التبعيات باستخدام pnpm، وتسجيل الدخول إلى Tinybird، ثم النشر. يتم تفعيل التتبع عن طريق وضع مقتطف نصي برمجى (script snippet) في قسم head الخاص بالموقع مع رمز التتبع (tracker token). يتوقع ملف README استقبال أحداث page_hit عند زيارة المستخدمين للموقع والتفاعل معه. يمكن إرسال الأحداث المخصصة عبر Tinybird.trackEvent. تستخدم السمات المخصصة بادئة data-tb_ ويتم تخزينها في عمود payload الخاص بمصدر بيانات analytics_events، وتُدرج مع كل حدث. يعتمد دعم تعدد المستأجرين (Multi-tenancy) وتعدد النطاقات على معاملات data-domain و data-tenant-id. يمكن تصفية جميع نقاط نهاية المشروع بواسطة tenant_id و domain، أو يمكن لرموز JWT أن تحمل fixed_params. يدعم برنامج التتبع أيضاً مؤشرات Web Vitals من خلال مكتبة web-vitals. تتضمن الأحداث التي تحمل إجراء web_vital مقاييس مثل LCP و TTFB و FCP و INP و CLS. تتوفر لوحة تحكم جاهزة على analytics.tinybird.live، حيث يقوم المستخدمون بلصق رمز مسؤول مساحة العمل (workspace admin token). يتم الحصول على رمز لوحة التحكم أيضاً من Tinybird. تشير الأقسام المتقدمة إلى ملفات README منفصلة لـ tinybird ولوحة التحكم للتطوير المحلي؛ حيث يقوم pnpm dev بمزامنة التغييرات مع فرع Tinybird، ويُستخدم pnpm deploy للإنتاج. يتم إنشاء ملف .env.local بقيم TINYBIRD_TOKEN و TINYBIRD_HOST. يمكن للمستخدمين تخصيص واستضافة لوحة التحكم الخاصة بهم على Vercel. يشير ملف README إلى أن Tinybird متوافق مع GDPR كمنصة، بينما يظل المستخدمون مسؤولين عن اتباع قواعد GDPR فيما يتعلق بجمع البيانات والموافقة.