Pasos de registro

1. Navega a Herramientas para desarrolladores → Consola de pruebas en la plataforma Singular
2. Haz clic en el botón Agregar dispositivo
3. Selecciona el Tipo de dispositivo en el menú desplegable:
   • Android: Prefiere el Google Advertising ID (GAID/aifa), AppSetID (asid) o AndroidID (andi) en ese orden
   • iOS: Usa el IDFA cuando esté disponible (requiere consentimiento de ATT); de lo contrario, usa IDFV
4. Ingresa el ID del dispositivo capturado desde el dispositivo
5. Proporciona un nombre de dispositivo distintivo para identificarlo fácilmente
6. Haz clic en Guardar dispositivo para completar el registro

Identificadores de dispositivo Android

Método recomendado: Usa la aplicación Singular Device Assist ( Android ) para obtener el GAID/aifa.

Método alternativo: Habilita el registro del SDK de Singular y captura el identificador desde Android LogCat:

SingularConfig config = new SingularConfig(SdkKey, SdkSecret)
    .withLoggingEnabled()
    .withLogLevel(1);

Salida de muestra de LogCat:

2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - andi : 8868adc2f7ffffff
2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - asid : 12dc3652-5e46-f2bb-a93a-b3c092ffffff
2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - aifa : 3bbc76b0-cebb-4a9f-b6ec-10ca1affffff

Identificadores de dispositivo iOS

Captura de IDFA: Úsala cuando el framework ATT esté implementado y el seguimiento autorizado.

Método 1: Aplicación Singular Device Assist ( iOS ) — otorga permiso de seguimiento cuando se solicite.

Método 2: Registra el IDFA en la consola de depuración de Xcode:

// Example in Swift
print("IDFA", ASIdentifierManager.shared().advertisingIdentifier.uuidString)

// Example in Objective-C
NSString *IDFA = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"IDFA: %@", IDFA);

Captura de IDFV: Úsala cuando ATT no esté implementado o el seguimiento no esté autorizado.

// Example in Swift
print("IDFV", UIDevice.current.identifierForVendor!.uuidString)

// Example in Objective-C
NSString *IDFV = [[[UIDevice currentDevice] identifierForVendor] UUIDString];
NSLog(@"IDFV: %@", IDFV);

Propósito

Validar que el ID de usuario personalizado se transmite correctamente a Singular para el seguimiento de usuarios entre dispositivos y análisis.

Procedimiento de prueba

1. Registra el dispositivo en la Consola de pruebas
2. Abre la aplicación en el dispositivo de prueba
3. Activa la acción que envía el ID de usuario (p. ej., inicio de sesión) si no se envía automáticamente
4. Expande los detalles del evento en la Consola de pruebas y verifica que el campo custom_user_id contenga el valor esperado

Solución de problemas

Si el ID de usuario personalizado no aparece:

• Verifica que el método que establece el ID de usuario se llame realmente en el momento apropiado del flujo de la aplicación
• Agrega un evento del SDK de Singular llamado "setting_custom_user_id" para mayor visibilidad en la Consola de pruebas
• Revisa los registros del SDK para confirmar la asignación del ID de usuario

Propósito

Verificar que la implementación del seguimiento de eventos envía los eventos con los nombres y atributos correctos a Singular.

Procedimiento de prueba

Para cada evento implementado en la integración del SDK:

1. Activa el evento en la aplicación y verifica que aparezca en la Consola de pruebas con el nombre correcto
2. Haz clic en la fila del evento para expandir los detalles y confirma que la sección Datos del evento contiene los atributos esperados

Solución de problemas

Si el evento no aparece:

• Verifica que la aplicación se haya abierto después de que el dispositivo estuviera completamente registrado en la Consola de pruebas
• Consulta los Registros de exportación para ver el evento (disponibles tras ~3 horas de retraso)
• Confirma que el código de activación del evento se ejecutó correctamente en la aplicación

Recursos adicionales

• Comprender la medición de eventos
• Referencia de eventos estándar de Singular

Propósito

Validar que la implementación del seguimiento de ingresos informa correctamente los montos de compra, la moneda y los detalles adicionales de ingresos.

Procedimiento de prueba

Para cada tipo de evento de ingresos implementado:

1. Activa el evento de ingresos en la aplicación y verifica que aparezca en la Consola de pruebas
2. Expande la fila del evento y confirma que los siguientes campos estén presentes:
   • pcc — Código de moneda (p. ej., USD, EUR)
   • r — Monto de ingresos
   • Atributos adicionales del evento de ingresos si están implementados

Recursos adicionales

• Preguntas frecuentes sobre validación de compras dentro de la aplicación

Propósito

Verificar que la implementación de enlaces profundos maneja correctamente los Singular Links y dirige a los usuarios al destino deseado dentro de la aplicación.

1. Configurar destino de prueba

1. Navega a Configuración → Aplicaciones en la plataforma Singular
2. Busca la aplicación y haz clic para abrir la configuración
3. Agrega un destino de enlace profundo que coincida con el código del controlador de destino en la integración del SDK

2. Crear enlace de prueba

1. Ve a Atribución → Administrar enlaces y selecciona la aplicación
2. Haz clic en Crear enlace
3. En Tipo de enlace , selecciona "Fuente personalizada" y en Nombre de fuente , selecciona "Email"
4. Proporciona un nombre para el enlace
5. Expande la sección Configuración del enlace y redireccionamientos
6. Selecciona el destino de prueba en el menú desplegable Enlace profundo
7. Ingresa la URL del sitio web en el campo Destino alternativo para otras plataformas
8. Haz clic en Generar y copia el enlace del campo Enlace de seguimiento de clics

3. Probar la funcionalidad del enlace

1. Asegúrate de que la aplicación esté instalada en el dispositivo de prueba
2. Envía el enlace copiado al dispositivo de prueba por correo electrónico
3. Desde el dispositivo, abre el correo y haz clic en el enlace; la aplicación debe abrirse mostrando la página o el contenido deseado
4. En la Consola de pruebas, verifica que el valor del Enlace profundo aparezca en los argumentos de la sesión

Alternativa para pruebas en Android

Prueba los enlaces profundos de Android usando ADB (Android Debug Bridge) para la validación desde la línea de comandos.

Requisitos previos:

• Instala ADB (incluido en las herramientas de plataforma del SDK de Android)
• Habilita las Opciones de desarrollador y la depuración USB en el dispositivo
• Conecta el dispositivo a la computadora mediante USB

Comando de prueba:

adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.sng.link/xxxxx?_dl=yourapp://deeplink"

Solución de problemas

Problema: El enlace profundo abre una nueva instancia de la aplicación en lugar de cambiar a la instancia existente.

Solución: Agrega lo siguiente a la actividad en AndroidManifest.xml:

android:launchMode="singleTask"

Consulta la documentación de <activity> de Google para ver las opciones de launchMode.

Propósito

Verificar que los enlaces profundos diferidos manejan correctamente los enlaces en los que se hizo clic antes de la instalación de la aplicación, dirigiendo a los usuarios al destino deseado en el primer lanzamiento.

Procedimiento de prueba

1. Revisa el evento de sesión en la Consola de pruebas para confirmar que los enlaces profundos diferidos están habilitados
2. Configura el destino de prueba y el enlace siguiendo los pasos de enlace profundo anteriores
3. Desinstala la aplicación del dispositivo de prueba
4. Restablece el identificador de publicidad del dispositivo
5. Agrega el nuevo identificador a la Consola de pruebas
6. Envía el enlace profundo al dispositivo por correo electrónico y haz clic en el enlace desde el dispositivo
7. El enlace debe redirigir a la tienda de aplicaciones; instala la aplicación (para compilaciones locales, carga de forma lateral desde Android Studio o Xcode en lugar de la versión de la tienda)
8. Después de la instalación, abre la aplicación; debe mostrar la página o el contenido especificado en el enlace profundo
9. En la Consola de pruebas, verifica que el valor del enlace profundo diferido aparezca en el primer evento de sesión

Propósito

Validar que la implementación del seguimiento de desinstalaciones detecta y reporta correctamente las desinstalaciones de la aplicación para el análisis de abandono.

Requisitos previos

Antes de realizar la prueba, verifica:

• Token FCM/APNS enviado a Singular (consulta SDK de Android: Seguimiento de desinstalaciones e SDK de iOS: Seguimiento de desinstalaciones )
• Clave del servidor FCM (Android) o Certificado de push de iOS ingresado en la página de configuración de la aplicación

Procedimiento de prueba

1. Instala la aplicación en un dispositivo real (no emulador)
2. Abre la aplicación para que la instalación quede registrada en Singular
3. Desinstala la aplicación del dispositivo
4. Verifica el evento de desinstalación usando uno de los siguientes métodos:
   • Exporta los registros de atribución y busca el evento de desinstalación (puede tardar unos días en aparecer)
   • Si los postbacks están configurados en el sistema BI interno, recibe el postback sobre la desinstalación
   • Contacta al soporte de Singular o al Customer Success Manager para asistencia en la validación

Causas comunes

Si el dispositivo está registrado y no aparecen eventos en el Registro de eventos, verifica lo siguiente:

• Monitoreo en vivo requerido: La Consola de pruebas solo muestra eventos en tiempo real cuando el dispositivo está seleccionado y el indicador 🟢 En vivo es visible. No recupera eventos históricos
• Aplicación abierta: Asegúrate de que la aplicación se haya abierto en el dispositivo de prueba para generar el evento de sesión
• Eventos activados: Si estás probando eventos específicos, asegúrate de haber realizado las acciones de activación en la aplicación
• Precisión del ID del dispositivo: Verifica que el ID del dispositivo ingresado en la Consola de pruebas sea correcto
• Tipo de ID del dispositivo: Para iOS sin aviso ATT, no se puede usar el IDFA; se debe usar el IDFV en su lugar

SDK versión 12.0.0 o posterior

A partir del SDK de Singular 12.0.0, no es necesario probar el evento _InstallReferrer . Una vez que la aplicación se publica en la tienda, el SDK coloca los datos de _InstallReferrer en la primera sesión de forma automática. Solo es necesario verificar que la sesión aparezca en la Consola de pruebas.

SDK versión <12.0.0>

Para versiones anteriores del SDK de Android, todavía es necesario verificar el evento _InstallReferrer en la Consola de pruebas para una atribución de instalación correcta.

Pasos de verificación

Verifica la precisión del IDFA:

• Usa la aplicación Singular Device Assist (iOS) con el permiso de seguimiento concedido
• Registra el IDFA en la consola de depuración de Xcode
• Consulta los Registros de exportación (después de 1+ hora) con el campo "Estado de App Tracking Transparency"; el valor 0 (No determinado) significa que el aviso ATT no se mostró

Verificaciones de configuración

1. Configuración del dispositivo: Verifica que Configuración → Privacidad → Seguimiento muestre "Permitir que las apps soliciten rastrear" habilitado
2. Aviso de ATT: Confirma que el aviso de ATT apareció durante la prueba; si no se mostró, el IDFA no se rastreó
3. Restablecer IDFA: Si el dispositivo se usó anteriormente, restablece el identificador de publicidad en Configuración → Privacidad → Seguimiento
4. Versión del SDK: Verifica que la última versión del SDK de Singular esté integrada correctamente
5. Inicialización del SDK: Confirma que el SDK se inicializó en AppDelegate o SceneDelegate según la documentación
6. Revisar errores: Revisa la consola de Xcode en busca de errores de inicialización del SDK o de seguimiento

Si el problema persiste después de seguir estos pasos, consulta la documentación de Apple sobre ATT o contacta al ingeniero de integración de Singular.

Proceso de eliminación

1. Haz clic en el ícono de edición junto al dispositivo en la Consola de pruebas
2. En la barra lateral que aparece, haz clic en Eliminar dispositivo
3. La eliminación borra todos los registros de eventos y elimina los datos de atribución del dispositivo de Singular

Consulta también: Cómo restablecer el dispositivo para las pruebas de atribución de instalación

Requisitos para el restablecimiento

Para volver a probar la integración del SDK con el mismo dispositivo, elimina los datos en caché local del dispositivo y borra la atribución del dispositivo en la plataforma Singular.

Pasos para restablecer en Android

1. Cierra la aplicación y confirma que no esté en ejecución (usa Forzar detención si está disponible)
2. Ve al menú Configuración
3. Navega a Aplicaciones , mantén presionada la aplicación y selecciona Información de la app
4. Selecciona Almacenamiento y haz clic en Borrar caché y Borrar datos
5. En la Consola de pruebas, selecciona el dispositivo, haz clic en el ícono de edición y luego en Eliminar dispositivo para eliminar la atribución

Pasos para restablecer en iOS

1. Cierra la aplicación y desinstálala del dispositivo
2. En la Consola de pruebas, busca el dispositivo, haz clic en el ícono de edición y luego en Eliminar dispositivo para eliminar la atribución

Interfaz del Registro de eventos

Después de registrar el dispositivo y enviar los eventos, estos aparecen en el Registro de eventos de la Consola de pruebas con actualizaciones en tiempo real.

Detalles del evento

Haz clic en la fila del evento para expandirla y ver los detalles completos del evento tal como fueron enviados desde la aplicación, incluidos todos los parámetros y atributos.

Prioridad de resolución

Deben resolverse antes del lanzamiento a producción — estos problemas impiden la funcionalidad principal.

Problemas de Error comunes

• No se recibieron sesiones: El SDK no está inicializado o no está enviando datos a Singular
• Claves del SDK no válidas: Clave del SDK o secret configurados incorrectamente
• Discrepancia de plataforma: La aplicación informa un identificador de plataforma incorrecto

Enfoque de resolución

1. Revisa la Descripción del error para obtener orientación específica
2. Consulta la guía de integración del SDK para la plataforma afectada
3. Verifica la configuración e inicialización del SDK
4. Vuelve a probar usando la Consola de pruebas después de las correcciones
5. Ejecuta una nueva Auditoría del SDK para confirmar la resolución

Prioridad de resolución

Deben resolverse para seguir las mejores prácticas — la integración funciona, pero se recomiendan mejoras.

Problemas de Advertencia comunes

• Sin ID de usuario personalizado: El ID de usuario personalizado no está implementado para el seguimiento entre dispositivos
• Problemas de seguimiento de ingresos: Los eventos de ingresos no siguen las mejores prácticas
• Atributos de eventos faltantes: Los eventos se rastrean sin los atributos recomendados

Enfoque de resolución

1. Evalúa el impacto en el negocio de la función faltante
2. Revisa la documentación de implementación de la función
3. Implementa si la función se alinea con los requisitos
4. Prueba la implementación usando la Consola de pruebas

Prioridad de resolución

Revisar y decidir — funciones opcionales que pueden no aplicarse al caso de uso específico.

Problemas de Información comunes

• Enlace profundo diferido deshabilitado: DDL puede no ser relevante para la estrategia de marketing
• Seguimiento de desinstalaciones no configurado: El seguimiento de desinstalaciones es opcional según los requisitos
• Funciones opcionales del SDK: Funciones adicionales no críticas para la funcionalidad básica

Enfoque de resolución

1. Revisa el Nombre de validación para identificar la función opcional
2. Determina si la función es relevante para los requisitos del negocio
3. Si no es relevante, ignora el problema con seguridad
4. Si es relevante, implementa siguiendo la documentación del SDK