takt-angular

تقدم حزمة @vskstudio/takt-angular دمجًا أصليًا لمنصة تحليلات Takt، مع التركيز على جمع البيانات الأولوية للخصوصية. تم تصميمها لـ Angular 17 فأحدث، ويمكن إضافتها إلى المشروع بتنفيذ أمر واحد لإدارة الحزم. التثبيت قم بتشغيل: pnpm add @vskstudio/takt-angular @vskstudio/takt-core الدمج مع التشغيل الأساسي في استدعاء التشغيل الأساسي، سجل المزود باستخدام provideTakt. يقوم المزود بتهيئة مكتبة التحليلات الأساسية فقط في المتصفح، وإرسال عرض الصفحة الأولي، وتفعيل ميزات التقاط تلقائي اختيارية (نقرات الروابط الخارجة، تنزيل الملفات، التنقل في تطبيق صفحة واحدة، إلخ)، وتنظيف عند تدمير تطبيق Angular. من ناحية الخادم، يكون المزود غير فعال، مما يجعل المكتبة آمنة لتقديم الخادم. الخدمة القابلة للتثبيت يمكن تثبيت TaktService في أي مكان في التطبيق. تعرض طرقًا مثل track(eventName, options)، pageview()، optOut() و optIn(). جميع الطرق لا تفعل شيئًا قبل تهيئة المكتبة أو عند التشغيل على الخادم، مما يضمن عدم حدوث أي أخطاء. تتبع النقر التصريحي يسمح TaktEventDirective للمطورين بتوصيل تتبع لأي عنصر قابل للنقر عبر خاصية taktEvent، مع مدخلات اختيارية taktProps و taktRevenue. يحلل الإرشاد المثيل التحليلي المباشر وقت النقر، ويحافظ على نظافة العلامات. مكونات الواجهة يتم توفير مكونين مستقلين: - TaktBadgeComponent يعرض شارة SVG تم إنشاؤها من الخادم لمجال معين. - TaktEmbedComponent يعرض iframe محاصر يعرض لوحة تحكم تحليلات عامة. كلا المكونين قابلان للاستخدام في أي قالب Angular ويدعمان المدخلات الخاصة بالمجال، والسمة، والحجم، واللغة، والشكل البصري. واجهة برمجية للإحصائيات العامة يقوم createStats بإنشاء عميل لواجهة برمجية Takt العامة. يقدم طرقًا غير متزامنة مثل summary، timeseries، realtime و breakdown، مما يتيح للمطورين الحصول على بيانات التحليلات المجمعة برمجيًا. عنصر مخصص غير مرتبط بالإطار لصفحات غير Angular، يتم تصدير عنصر مخصص ذاتي الاستقلال يُسمى takt-analytics. بعد استدعاء defineTaktElement (أو استيراد الوحدة التي تقوم بتشغيل التسجيل تلقائيًا)، يمكن وضع العنصر في HTML عادي وسيحترم إعدادات الخصوصية تلقائيًا مثل تتبع الروابط الخارجية وتنزيل الملفات. يوجد أيضًا حزمة CDN جاهزة للإدراج السريع دون خطوة بناء. خيارات التكوين يدعم TaktConfig مجموعة غنية من الخيارات، بما في ذلك المجال، والنقطة النهائيّة، وتتبع الروابط الخارجية، وتعقب تنزيل الملفات، والتنقل في تطبيق صفحة واحدة، واحترام "عدم التتبع"، واستبعاد المضيف المحلي، ومعدل العينة، ومعالجة سلسلة الاستعلام، واستبعاد المسارات، وتنظيف عناوين URL، وتتبع العناصر الموسومة. القيم الافتراضية مناسبة لمعظم المواقع، ويمكن تزويد التكوين بـ provideTakt عند التشغيل الأساسي. الترخيص يتم إصدار المكتبة بموجب ترخيص MIT.