aptabase-unity

## SDK del motor Unity para Aptabase Este paquete instrumenta proyectos del motor Unity con Aptabase, una plataforma de análisis de código abierto y centrada en la privacidad para aplicaciones móviles, de escritorio y web. ### Instalación Instala a través del Package Manager de Unity añadiendo la URL git https://github.com/aptabase/aptabase-unity.git mediante Window > Package Manager > Add Package from git URL. ### Configuración Tras obtener una App Key de Aptabase, establécela en `Aptabase/Resources/AptabaseSettings.Asset`. El host se selecciona automáticamente según la clave; para despliegues autoalojados aparece un campo `SelfHostURL`. Las claves que empiecen por `A-DEV-*` apuntan a una instancia local de Aptabase en `https://localhost:3000`. Las configuraciones opcionales incluyen anular la versión de la aplicación (`AppVersion`), especificar un número de compilación específico de plataforma (`AppBuildNumber`), ajustar los intervalos de envío de eventos (`FlushInterval`) y habilitar el informe automático de crasheos (`EnableCrashReporting`). ### Seguimiento de eventos Los eventos se registran mediante `Aptabase.TrackEvent()` dentro del namespace `AptabaseSDK`. Las propiedades personalizadas solo aceptan cadenas y números. Los eventos se agrupan y envían cada 60 segundos en producción o cada 2 segundos en desarrollo. El envío manual está disponible a través de `Aptabase.Flush()`. El SDK enriquece automáticamente los eventos con el SO, la versión de la aplicación y otros metadatos. No se rastrean eventos automáticamente; todo el registro debe hacerse manualmente. ### Seguimiento de errores (Beta) Usa `Aptabase.TrackError(ex)` para excepciones controladas y `Aptabase.TrackError(ex, fatal: true)` para errores irrecuperables. Con `EnableCrashReporting`, el SDK informa automáticamente: - Excepciones capturadas de callbacks MonoBehaviour, corutinas y `Debug.LogException` como `unhandled` - Excepciones que terminan el proceso como `crash` con gravedad `fatal` - Excepciones de Task no observadas como `taskException` Cada informe incluye tipo de excepción, mensaje, traza de pila, severidad y método de captura. Se reportan hasta 100 errores únicos por sesión. Los crasheos nativos no se capturan. ### Funcionalidades adicionales - Escuchador de respuestas mediante `SetResponseListener()` para códigos de estado HTTP - Habilitar/deshabilitar el SDK con `SetEnabled()` - Guía del formulario de privacidad de Apple App Store proporcionada