SDK
SDK de Traqio: cuál elegir y qué hace cada uno
Nueve SDK para apps de iOS y Android, y para sitios web un SDK de navegador más SDK de servidor Node.js, PHP y Python — y lo que admite cada uno hoy.
Un SDK de Traqio es la librería que integra tu app para que Traqio pueda atribuir sus instalaciones y medir lo que ocurre después. Todos los SDK hacen las mismas tres tareas: informan de la instalación una sola vez con las pruebas que aporta su plataforma (el Install Referrer de Google Play en Android, SKAdNetwork en iOS), ponen en cola los eventos que registras y los envían en lotes que sobreviven a los reinicios y a las malas conexiones, y resuelven los deep links de los enlaces de seguimiento de Traqio. Ninguno hace fingerprinting del dispositivo, y ninguno lee un identificador publicitario salvo que lo actives (por ahora iOS, Android y React Native).
Elige según cómo está construida tu app#
Usa un solo SDK de Traqio por app: con dos, cada uno informaría de la instalación y cada evento se contaría dos veces.
Para un sitio web#
Un sitio web usa dos SDK, uno por mitad: el SDK de navegador conserva el click id del anuncio desde la página de llegada hasta el formulario de registro, y un SDK de servidor en tu backend reporta el registro con él — atribución web explica la cadena, y el inicio rápido web la configura.
Cada mitad usa su propia clave, nunca la de la app: una clave web pública para el navegador, una clave de servidor secreta para el backend. Los eventos web y las conversiones de servidor nunca se vinculan a una instalación de app.
Lo que admite cada SDK hoy#
Medido en el código de cada SDK, no prometido. Una vez: el Install Referrer se lee en el primer arranque sin el reintento del SDK de React Native cuando Google Play no está disponible momentáneamente; esa instalación se registra entonces como orgánica. App: compatible, siempre que tu app pase al SDK el evento del ciclo de vida o la URL (cada página de SDK muestra la línea). —: no aplicable en esa plataforma.
| RN / Expo | Android | iOS | Flutter | Capacitor | KMP | MAUI | Unity | |
|---|---|---|---|---|---|---|---|---|
| Android: Play Install Referrer | Sí | Sí | — | Una vez | Una vez | Una vez | Una vez | Una vez |
| iOS: registro en SKAdNetwork | Sí | — | Sí | Sí | Sí | Sí | Sí | Sí |
| iOS: valores de conversión según tu mapeo | Sí | — | Sí | No | Sí | No | No | No |
| iOS: atribución de Apple Ads | Sí | — | Sí | No | Sí | No | No | No |
| Eventos con valor y moneda | Sí | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Id de transacción de la tienda en las compras | Sí | No | No | No | Sí | No | No | No |
| Ingresos publicitarios de AdMob | Sí | No | No | No | Sí | No | No | No |
| Deep links, directos y diferidos | Sí | Sí | App | Sí | App | App | Sí | Sí |
| Aperturas de la app (retención) | Sí | Sí | Sí | Sí | App | App | App | Sí |
| Consentimiento para compartir con redes publicitarias | Sí | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Borrado desde la app (forgetMe) | Sí | No | No | No | Sí | No | No | No |
| Cola sin conexión y reintentos | Sí | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
El SDK de React Native / Expo es el más completo porque ejecuta el motor JavaScript compartido, @traqio/core, que también impulsa Capacitor. En los demás SDK, lo que falta falta en la app, no en el servidor: el borrado desde la app tiene un equivalente del lado del servidor, y los ingresos siempre pueden llegar a través de RevenueCat.
Hasta qué punto está probado cada SDK#
Una capacidad en el código no es lo mismo que una capacidad vista en funcionamiento. Esta es la prueba más sólida que tiene hoy cada SDK:
| SDK | Paquete | Registro | Probado |
|---|---|---|---|
| React Native / Expo | @traqio/react-native | npm | Verificado en un dispositivo |
| Android | io.khufu.traqio:traqio-android | Maven Central | Compilado en CI |
| iOS | TraqioSDK | SPM / CocoaPods | Compilado en CI |
| Flutter | traqio | pub.dev | Tipos comprobados en CI |
| Capacitor | @traqio/capacitor | npm | Tipos comprobados en CI |
| Kotlin Multiplatform | io.khufu.traqio:traqio-kmp | Maven Central | Compilado en CI |
| .NET MAUI | Traqio.Maui | NuGet | Compilado en CI |
| Unity | app.traqio.sdk | UPM | Aún sin build automatizada |
“Verificado en un dispositivo” significa que la cadena completa (un clic en un enlace de seguimiento, una instalación desde Google Play, el Install Referrer leído por el SDK, una instalación atribuida de forma determinista) se ha ejecutado de principio a fin en un entorno Android real. “Compilado en CI” significa que la propia cadena de herramientas del SDK lo compila en cada cambio, pero ninguna app lo ha ejecutado todavía contra producción.
Acceso anticipado
Compatible hoy#
Los SDK de apps miden apps de iOS y Android. Cada uno apunta a las plataformas móviles para las que compila su framework: un proyecto .NET MAUI o Kotlin Multiplatform se mide en sus destinos Android e iOS, y un juego de Unity en sus builds de Android e iOS. Los SDK web miden sitios web: @traqio/web en cualquier navegador, y los SDK de servidor en Node.js 18+, PHP 8.1+ (Laravel 12 y 13) y Python 3.9+.
Preguntas frecuentes#
- ¿Qué SDK de Traqio debo usar?
- El que corresponde al lenguaje en el que está escrito el código de arranque de tu app: @traqio/expo para una app de Expo, @traqio/react-native para una app de React Native sin Expo (bare), el SDK de Kotlin para una app Android nativa, TraqioSDK para una app iOS nativa, y el paquete de Flutter, Capacitor, Kotlin Multiplatform, .NET MAUI o Unity para las apps creadas con ellos. Usa exactamente un SDK de Traqio por app.
- ¿Todos los SDK hacen lo mismo?
- Comparten el mismo contrato (informar de la instalación una sola vez, poner en cola y reintentar los eventos, resolver los deep links, transmitir el consentimiento del usuario), pero no todas las capacidades. Los valores de conversión de SKAdNetwork, la atribución de Apple Ads, los ids de transacción de la tienda, los ingresos publicitarios de AdMob y el borrado desde la app están completos en los SDK de React Native / Expo y de Capacitor (y en parte en el SDK nativo de iOS); la matriz de esta página enumera cada uno.
- ¿Puedo usar dos SDK de Traqio en la misma app?
- No. Cada SDK informaría de la instalación y gestionaría su propia cola de eventos, así que cada instalación y cada evento se contarían dos veces. @traqio/expo y @traqio/react-native son el mismo módulo con dos nombres: instala solo uno de ellos.