عن المشروع

react-fathom هو غلاف تحليلات يركز على الخصوصية مبني حول Fathom Analytics، ومصمم خصيصًا للتطبيقات القائمة على React بما في ذلك منصات الويب والموبايل. يدعم المتابعة التلقائية للصفحات عند تغيير المسارات، وتتبع الأحداث المخصصة، وتتبع تحويلات الأهداف مع القيم النقدية، ويقدم كلًا من الواجهات البرمجية (hooks) والمكونات التعهيدية لتكامل مرن. الميزات الرئيسية: - إعداد خالٍ من التكوين: قم بتغليف تطبيقك بـ FathomProvider وقم بتوفير siteId - متابعة تلقائية للصفحات لكلًا من Next.js App Router وPages Router عبر NextFathomProviderApp وNextFathomTrackViewApp وNextFathomTrackViewPages - دعم React Native من خلال export مخصص /native يستخدم WebView مخفيًا لتحميل سكريبت تتبع Fathom، مع دورية تخزين محلية عند عدم الاتصال وتكامل مع React Navigation - دعم كامل لـ TypeScript مع تعريفات أنواع شاملة - قابل لـ Tree-shaking: يتم تغليف ما تستخدمه فقط - دمج الخيارات الافتراضية: تعيين قيم افتراضية على مستوى التطبيق في FathomProvider يتم دمجها تلقائيًا مع جميع استدعاءات المتابعة - دعم المكونات المتداخلة: يمكن للمورّثCHILD تجاوز الإعدادات الافتراضية للمورّث الأب - تنفيذ عميل مخصص: يمكنك توفير واجهة FathomClient لـ React Native أو اختبارات mocks أو سيناريوهات التصيير من جانب الخادم - واجهات مريحة: useTrackOnMount وuseTrackOnClick وuseTrackOnVisible لأنماط المتابعة الشائعة - مكونات تعهيدية: TrackPageview وTrackClick وTrackVisible للمتابعة مباشرة في JSX - دعم النطاقات المخصصة لـ Fathom - تتبع حالة التطبيق في React Native (أحداث المقدمة والخلفية) يتطلب الحزمة fathom-client كاعتماد متبادل (peer dependency)، وتعمل مع React >= 16.8 وNext.js >= 10.0.0 وReact Native >= 0.60.0. لا تتطلب Fathom أي ملفات تعريف ارتباط (cookies)، مما يجعلها متوافقة مع GDPR وCCPA وPECR بشكل مباشر دون الحاجة إلى لافتات موافقة.