À propos du projet

Le paquet @vskstudio/takt-angular propose une intégration native pour la plateforme d'analyse Takt, axée sur la collecte de données respectueuse de la vie privée. Il est conçu pour Angular 17 et versions ultérieures, et peut être ajouté à un projet avec une seule commande du gestionnaire de paquets. Installation Exécutez : pnpm add @vskstudio/takt-angular @vskstudio/takt-core Intégration Bootstrap Dans l'appel d'amorçage racine, enregistrez le fournisseur en utilisant provideTakt. Le fournisseur initialise uniquement la bibliothèque analytique principale dans le navigateur, envoie une vue initiale de page, active les fonctionnalités facultatives de capture automatique (clics sur les liens sortants, téléchargements de fichiers, navigation SPA, etc.) et effectue un nettoyage lorsque l'application Angular est détruite. Du côté serveur, le fournisseur est inactif, rendant la bibliothèque sûre pour le rendu côté serveur. Service Injectable TaktService peut être injecté n'importe où dans l'application. Il expose des méthodes telles que track(eventName, options), pageview(), optOut() et optIn(). Toutes ces méthodes sont des opérations sans effet avant l'initialisation de la bibliothèque ou lorsqu'elle s'exécute sur le serveur, garantissant qu'elles ne lèvent jamais d'exception. Suivi Déclaratif des Clics La directive TaktEventDirective permet aux développeurs d'attacher le suivi à tout élément cliquable via l'attribut taktEvent, avec des entrées optionnelles taktProps et taktRevenue. La directive résout l'instance analytique en cours au moment du clic, maintenant le balisage propre. Widgets UI Deux composants autonomes sont fournis : - TaktBadgeComponent affiche un badge SVG généré par le serveur pour un domaine donné. - TaktEmbedComponent affiche un iframe isolé qui affiche les tableaux de bord d'analyse publics. Ces deux composants sont utilisables dans n'importe quel modèle Angular et prennent en charge les entrées pour le domaine, le thème, la taille, la langue et la variante visuelle. API Publique de Statistiques L'assistant createStats crée un client pour l'API publique Takt. Il offre des méthodes asynchrones summary, timeseries, realtime et breakdown, permettant aux développeurs de récupérer programmatiquement des données d'analyse agrégées. Élément Personnalisé Framework-Agnostique Pour les pages non Angular, un élément personnalisé autonome nommé takt-analytics est exporté. Après avoir appelé defineTaktElement (ou importé le module qui exécute automatiquement l'enregistrement), l'élément peut être placé dans un HTML brut et respectera automatiquement les paramètres de confidentialité comme le suivi des liens sortants et le suivi des téléchargements de fichiers. Un bundle CDN est également disponible pour une inclusion rapide sans étape de construction. Options de Configuration TaktConfig prend en charge un large éventail d'options, y compris le domaine, le point de terminaison, le suivi des liens sortants, le suivi des téléchargements de fichiers, la navigation SPA, le respect du paramètre Ne Pas Suivre, l'exclusion de localhost, le taux d'échantillonnage, la gestion des chaînes de requête, les exclusions de chemin, le nettoyage des URL et le suivi des éléments étiquetés. Les valeurs par défaut sont raisonnables pour la plupart des sites, et la configuration peut être fournie à provideTakt lors de l'amorçage. Licence La bibliothèque est publiée sous licence MIT.