aptabase-unity

## SDK Unity Engine pour Aptabase Ce package instrumente les projets Unity Engine avec Aptabase, une plateforme analytique open-source et respectueuse de la vie privée pour les applications mobiles, desktop et web. ### Installation Installez via l'Unity Package Manager en ajoutant l'URL git https://github.com/aptabase/aptabase-unity.git via Fenêtre > Gestionnaire de packages > Ajouter un package depuis son URL git. ### Configuration Après avoir obtenu une clé d'application depuis Aptabase, définissez-la dans `Aptabase/Resources/AptabaseSettings.Asset`. L'hôte est sélectionné automatiquement selon la clé ; pour les déploiements auto-hébergés, un champ `SelfHostURL` apparaît. Les clés préfixées par `A-DEV-*` ciblent une instance locale d'Aptabase sur `https://localhost:3000`. Les paramètres optionnels incluent le remplacement de la version de l'application (`AppVersion`), la spécification d'un numéro de build spécifique à une plateforme (`AppBuildNumber`), l'ajustement des intervalles de vidage des événements (`FlushInterval`) et l'activation du rapport automatique de crash (`EnableCrashReporting`). ### Suivi des événements Les événements sont enregistrés via `Aptabase.TrackEvent()` dans l'espace de noms `AptabaseSDK`. Les propriétés personnalisées n'acceptent que des chaînes et des nombres. Les événements sont regroupés et envoyés toutes les 60 secondes en production ou toutes les 2 secondes en développement. Une vidange manuelle est disponible via `Aptabase.Flush()`. Le SDK enrichit automatiquement les événements avec le système d'exploitation, la version de l'application et d'autres métadonnées. Aucun événement n'est suivi automatiquement — tout enregistrement doit être fait manuellement. ### Suivi des erreurs (Bêta) Utilisez `Aptabase.TrackError(ex)` pour les exceptions gérées et `Aptabase.TrackError(ex, fatal: true)` pour les erreurs irrécupérables. Avec `EnableCrashReporting`, le SDK signale automatiquement : - Les exceptions capturées provenant des callbacks MonoBehaviour, des coroutines et de `Debug.LogException` comme `unhandled` - Les exceptions provoquant la terminaison du processus comme `crash` avec une sévérité `fatal` - Les exceptions de tâches non observées comme `taskException` Chaque rapport inclut le type d'exception, le message, la trace de la pile, la sévérité et la méthode de capture. Jusqu'à 100 erreurs uniques par session sont signalées. Les crashs natifs ne sont pas captés. ### Fonctionnalités supplémentaires - Récepteur de réponse via `SetResponseListener()` pour les codes de statut HTTP - Activation/désactivation du SDK avec `SetEnabled()` - Guide du formulaire de confidentialité Apple App Store fourni