Pruebas
Ejecuta una build de depuración, abre la app una vez y revisa el panel. Esta página explica qué cuenta como dispositivo de prueba, cómo ver sus datos y cómo probar los deep links diferidos sin publicar en Google Play.
Dispositivos de prueba
Una instalación marcada como dispositivo de prueba envía datos reales, pero el panel los deja fuera de tus números hasta que los pidas. Así tus propias pruebas nunca inflan las instalaciones, la conversión ni los ingresos.
| Plataforma | Se marca como dispositivo de prueba cuando |
|---|---|
| Android | La build es depurable (lo predeterminado en las builds de depuración), o pasas UnolinkOptions(debug = true). Además, desde el SDK 0.3.0, una build de release que instalaste tú mismo con adb o Android Studio, y los teléfonos del informe previo al lanzamiento de Google y de Firebase Test Lab. |
| iOS | Pasas UnolinkOptions(debug: true). Usa #if DEBUG, ya que una biblioteca compilada no puede ver los ajustes de tu build. Desde el SDK 0.3.0, las builds de TestFlight y de Xcode son dispositivos de prueba por sí solas. |
| React Native | Pasas { debug: __DEV__ }, además de las reglas de iOS y Android de arriba. |
| Flutter | Pasas debug: kDebugMode, además de las reglas de iOS y Android de arriba. |
Una instalación que hace una compra de sandbox en RevenueCat (TestFlight, testers con licencia en Google Play) también pasa a ser un dispositivo de prueba, con todo lo que envió.
Los canales de prueba de Google Play (interno, cerrado, abierto) no se pueden distinguir de la versión de la tienda en el teléfono. Marca esas builds tú mismo, por ejemplo con una variable en tiempo de compilación:
// React Native / Expo: set EXPO_PUBLIC_UNOLINK_TEST=1 only for testing-track builds
Unolink.configure("ulk_…", { debug: __DEV__ || process.env.EXPO_PUBLIC_UNOLINK_TEST === "1" })
Ver los datos de prueba en el panel
Abre tu app → Embudo o Recorridos y activa Incluir dispositivos de prueba. Las instalaciones de prueba aparecen entonces junto a las reales. Vuelve a desactivarlo antes de leer tus números reales.
Una primera apertura aparece a los pocos segundos de iniciar la app. Los eventos se envían en lotes cada 15 segundos mientras la app está abierta, y de inmediato cuando pasa a segundo plano: pulsa Inicio para enviarlos ya.
Registros de depuración
El SDK es silencioso cuando todo funciona: de forma predeterminada solo registra advertencias y errores. Para ver cada paso, sube el nivel de registro.
// Android: Logcat, tag "Unolink"
Unolink.configure(this, "ulk_…", UnolinkOptions(logLevel = LogLevel.DEBUG))
// iOS: Xcode console, prefix "[Unolink]"
Unolink.configure(apiKey: "ulk_…", options: UnolinkOptions(logLevel: .debug, debug: true))
// React Native: Xcode console or Logcat, tag "Unolink"
Unolink.configure("ulk_…", { debug: __DEV__, logLevel: "debug" })
// Flutter: Xcode console or Logcat, tag "Unolink"
await Unolink.configure('ulk_…', debug: kDebugMode, logLevel: UnolinkLogLevel.debug);
Vuelve a dejarlo en el valor predeterminado antes de publicar.
Simular un referrer de instalación de Play (Android)
Google Play solo pasa un referrer de instalación en las instalaciones reales desde Google Play. Para probar tu código de deep links diferidos sin uno, dale a una build de depuración nativa de Android un referrer simulado:
Unolink.configure(this, "ulk_…", UnolinkOptions(
debugInstallReferrer = "unolink_click_id=clk_01JA0000000000000000000000&unolink_deep_link=%2Fpromo%2F3for2&unolink_p_offer=3for2",
))
- Solo se usa en builds depurables. Las builds de release lo ignoran y leen el referrer real.
- Solo se lee en el primer inicio, igual que el real. Desinstala la app, o borra su almacenamiento, antes de cada intento.
- Tu listener de deep links diferidos recibe
deepLink = "/promo/3for2"yparams = {offer=3for2}del referrer. El SDK registra una advertencia de que usó el referrer simulado. - La instalación en sí no se atribuye a un enlace, salvo que el ID de clic sea un clic real de uno de los enlaces de tu app.
Esta opción forma parte del SDK nativo de Android. En React Native y Flutter, prueba con una instalación real como se explica abajo.
Probar con una instalación real (Android)
- Sube una build a Google Play Console → Pruebas → Pruebas internas y añádete como tester.
- En el teléfono, desinstala la app, luego abre uno de tus enlaces de Unolink e instala desde la ficha de Play que se abre.
- Abre la app. La instalación se atribuye a ese enlace, y el listener de deep links se ejecuta si el enlace tiene un deep link.
Más información en Deep links diferidos en Android.
iPhone
En iPhone, las instalaciones y los eventos se cuentan, pero a tu app nunca se le dice qué enlace se tocó: no hay deep link diferido, porque Apple no tiene referrer de instalación y Unolink nunca hace fingerprinting. Aun así, el panel asocia las instalaciones en iPhone a su enlace, sin fingerprinting. Así que en iOS, prueba que llegan las instalaciones y los eventos. No hay deep link que comprobar en la app.
Lista de comprobación
- La primera apertura aparece en Recorridos con Incluir dispositivos de prueba activado.
- Cada llamada del embudo aparece como un paso en esa instalación.
- Con RevenueCat: una compra de sandbox aparece en la misma instalación después de
setUserId. - Android: una instalación de prueba interna de Play desde un enlace muestra el enlace, y el deep link se abre.
- Las builds de release se configuran sin
debug: truey con el nivel de registro predeterminado.
¿Falta algo? Consulta Solución de problemas.