Pasos para el registro

1. Navegue a Herramientas de desarrollador → Consola de pruebasen la plataforma Singular
2. Haga clic en el botón Añadir dispositivo
3. Selecciona el Tipo de Dispositivo en el desplegable:
   • Android: Prefiera Google Advertising ID (GAID/aifa), AppSetID (asid) o AndroidID (andi) en ese orden
   • iOS: Utilice IDFA cuando esté disponible (requiere el consentimiento de ATT), de lo contrario utilice IDFV
4. Introduzca el ID de dispositivo capturado del dispositivo
5. Proporcione un nombre distintivo del dispositivo para facilitar su identificación
6. Haga clic en Guardar dispositivo para completar el registro

Identificadores de dispositivos Android

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

Método alternativo: Habilite el registro de Singular SDK y capture el identificador desde Android LogCat:

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

Ejemplo de salida 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 dispositivos iOS

Captura IDFA: Usar cuando el framework ATT esté implementado y el rastreo autorizado.

Método 1: Singular Device Assist app(iOS) - conceder permiso de seguimiento cuando se le solicite.

Método 2: Registrar 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);

IDFV Capture: Usar cuando ATT no implementado o seguimiento no 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 y análisis de usuarios entre dispositivos.

Procedimiento de prueba

1. Registre el dispositivo en la consola de pruebas
2. Abrir la aplicación en el dispositivo de prueba
3. Activar la acción que envía el ID de usuario (por ejemplo, inicio de sesión) si no se envía automáticamente
4. Expanda los detalles del evento en la Consola de Pruebas y verifique que el campo custom_user_idcontiene el valor esperado.

Solución de problemas

Si no aparece el ID de usuario personalizado:

• Compruebe que el método que establece el ID de usuario se llama realmente en el momento adecuado del flujo de la aplicación.
• Añada el evento SDK Singular llamado "setting_custom_user_id" para visibilidad en la Consola de Pruebas
• Compruebe los registros del SDK para confirmar la asignación del ID de usuario

Propósito

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

Procedimiento de prueba

Para cada evento implementado en la integración SDK:

1. Dispare el evento en la aplicación y verifique que el evento aparece en la Consola de Pruebas con el nombre correcto.
2. Haga clic en la fila del evento para ampliar los detalles y confirme que la sección Datos del eventocontiene los atributos esperados.

Solución de problemas

Si el evento no aparece:

• Compruebe que la aplicación se ha abierto después de que el dispositivo se haya registrado completamente en la consola de pruebas.
• Compruebe los registros de exportacióndel evento (disponibles tras un retraso de unas 3 horas)
• Confirme que el código de activación del evento se ha ejecutado correctamente en la aplicación

Recursos adicionales

• Entender la medición de eventos
• Referencia de eventos estándar singulares

Propósito

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

Procedimiento de la prueba

Para cada tipo de evento de ingresos implementado:

1. Active el evento de ingresos en la aplicación y compruebe que el evento aparece en la consola de pruebas.
2. Expanda la fila del evento y confirme la presencia de los siguientes campos:
   • pcc - Código de moneda (por ejemplo, USD, EUR)
   • r - Importe de ingresos
   • Atributos adicionales del evento de ingresos, si se han implementado

Recursos adicionales

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

Propósito

Verificar que la implementación de enlaces profundos gestiona correctamente los enlaces singulares y dirige a los usuarios a los destinos previstos dentro de la aplicación.

1. 1. Configure el destino de la prueba

1. Vaya a Configuración → Aplicaciones en la plataforma Singular.
2. Busque la app y haga clic para abrir la configuración
3. Añada el destino de enlace profundo que coincida con el código del manejador de destino en la integración SDK reconoce

2. Crear enlace de prueba

1. Vaya a Atribución → Gestionar enlaces y seleccione la app
2. Haga clic en Crear enlace
3. En Tipo de enlace, seleccione "Fuente personalizada" y en Nombre de fuente, seleccione "Correo electrónico"
4. Proporcione el nombre del enlace
5. Amplíe la sección Configuración del enlace y redireccionamientos
6. Seleccione el destino de prueba en el menú desplegable Enlace profundo
7. Introduzca la URL del sitio web en el campo Destino alternativo para otras plataformas.
8. Haga clic en Generar y copie el enlace del campo Enlace de seguimiento de clics

3. Pruebe la funcionalidad del enlace

1. Asegúrese de que la aplicación está instalada en el dispositivo de prueba
2. Envíe por correo electrónico el enlace copiado al dispositivo de prueba
3. Desde el dispositivo, abra el correo electrónico y haga clic en el enlace - la aplicación debería abrirse mostrando la página/contenido deseado
4. En la Consola de Pruebas, verifique que el valor de Enlace Profundo aparece en los argumentos de Sesión

Alternativa de prueba de Android

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

Requisitos previos:

• Instalar ADB (incluido en las herramientas de la plataforma SDK de Android)
• Habilitar las opciones de desarrollador y la depuración USB en el dispositivo
• Conectar el dispositivo al ordenador a través de USB

Comando deprueba:

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: Añada lo siguiente a la actividad en AndroidManifest.xml:

android:launchMode="singleTask"

Consulte la documentación de <activity> de Googlepara conocer las opciones de launchMode.

Propósito

Verificar que la vinculación profunda diferidagestiona correctamente los enlaces en los que se ha hecho clic antes de la instalación de la aplicación, dirigiendo a los usuarios al destino previsto en el primer lanzamiento.

Procedimiento de prueba

1. Compruebe el evento de sesión en la consola de pruebas para confirmar que la vinculación profunda diferida está activada.
2. Configure el destino y el enlace de prueba siguiendo los pasos de vinculación profunda anteriores.
3. Desinstalar la aplicación del dispositivo de prueba
4. Restablecer el identificador de publicidad del dispositivo
5. Añada un nuevo identificador a la consola de pruebas
6. Enviar enlace profundo por correo electrónico al dispositivo y hacer clic en el enlace desde el dispositivo
7. El enlace debería redirigir a la tienda de aplicaciones: instala la aplicación (para compilaciones locales, carga lateral desde Android Studio o Xcode en lugar de la versión de la tienda).
8. Después de la instalación, abra la aplicación - debería mostrar la página/contenido especificado en el enlace profundo
9. En la consola de pruebas, compruebe que el valor del enlace profundo diferidoaparece en el evento de la primera sesión.

Propósito

Validar que la implementación de seguimiento de desinstalación detecta e informa correctamente de las desinstalaciones de aplicaciones para el análisis de rotación.

Requisitos previos

Antes de realizar la prueba, verifique

• Envío del token FCM/APNS a Singular (consulte SDK de Android: Seguimiento de desinstalacionesy SDK de iOS: Seguimiento de desinstalaciones)
• Clave de servidor FCM (Android) o certificado push de iOSintroducido en la página de configuración de la aplicación.

Procedimiento de prueba

1. Instale la aplicación en un dispositivo real (no en un emulador).
2. Abra la aplicación para instalarla registrada en Singular
3. Desinstale la aplicación del dispositivo
4. Verifique el evento de desinstalación utilizando uno de los siguientes métodos:
   • Exporte los registros de atribucióny encuentre el evento de desinstalación (puede tardar un par de días en aparecer)
   • Si se han configurado postbacksal sistema BI interno, recibir postback sobre la desinstalación
   • Póngase en contacto con el servicio de atención al clientede Singularpara obtener ayuda sobre la validación.

Causas comunes

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

• Se requiere monitorización en directo: La Consola de Pruebas sólo muestra eventos en vivo cuando el dispositivo está seleccionado y el indicador 🟢 En Vivo está visible. No recupera eventos históricos
• Aplicación abierta: Asegúrese de que la aplicación se abrió en el dispositivo de prueba para generar el evento de sesión
• Eventos activados: Si se prueban eventos específicos, asegúrese de que las acciones desencadenantes se realizan en la aplicación.
• Exactitud del ID del dispositivo: Compruebe que el ID del dispositivo introducido en la consola de pruebas es correcto.
• Tipo de ID de dispositivo: Para iOS sin ATT prompt, no se puede utilizar IDFA - debe utilizar IDFV en su lugar

Versión SDK 12.0.0+

A partir de Singular SDK 12.0.0, no es necesario probar el evento _InstallReferrer. Una vez que la aplicación es empujada a la tienda, SDK coloca los datos _InstallReferrer en la primera sesión de forma automática. Sólo es necesario verificar que la sesión aparece en la consola de pruebas.

Versión SDK <12.0.0>

Para versiones más antiguas de SDK de Android, todavía es necesario comprobar _InstallReferrerevento en la consola de pruebas para la atribución de la instalación correcta.

Pasos de verificación

Vuelva a comprobar la exactitudde IDFA:

• Usa la aplicación Singular Device Assist (iOS) con el permiso de rastreo concedido
• Registre IDFA en la consola de depuración de Xcode
• Comprueba los registros de exportación (después de más de una hora) con el campo "App Tracking Transparency status" - valor 0 (Indeterminado) significa que no se muestra el aviso ATT

Comprobaciones de configuración

1. Ajustes del dispositivo: Comprueba que Ajustes → Privacidad → Seguimiento muestra "Permitir que las apps soliciten el seguimiento" activado
2. Indicación ATT: Confirme que el aviso ATT apareció durante la prueba - si no aparece, IDFA no rastreado
3. Restablecer IDFA: Si el dispositivo se utilizó anteriormente, restablezca el identificador de publicidad a través de Configuración → Privacidad → Seguimiento
4. Versión SDK: Verificar que la última versión de Singular SDK se integró correctamente
5. Inicialización SDK: Confirmar SDK inicializado en AppDelegate o SceneDelegate según la documentación
6. Comprobar errores: Revise la consola de Xcode en busca de errores de inicialización o seguimiento del SDK

Si los problemas persisten después de seguir estos pasos, consulte la documentación de Apple ATTo póngase en contacto con el ingeniero de integración de Singular.

Proceso de eliminación

1. Haga clic en el icono Editar junto al dispositivo en la Consola de Pruebas
2. En la barra lateral que aparece, haga 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.

Véase también: Cómo restablecer el dispositivo para la prueba de atribución de instalación

Restablecer requisitos

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

Pasos para restablecer Android

1. Cierre la aplicación y confirme que no se está ejecutando (use Forzar detenciónsi está disponible)
2. Ir al menú Configuración
3. Navega hasta Apps, pulsa prolongadamente sobre la app, selecciona App Info
4. Seleccione Almacenamiento y haga clic en Borrar caché y Borrar datos.
5. En la consola de pruebas, seleccione el dispositivo y haga clic en el icono Editar y, a continuación, en Eliminar dispositivo para eliminar la atribución.

Pasos para restablecer iOS

1. Cierre la aplicación y desinstálela del dispositivo.
2. En la consola de pruebas, busque el dispositivo y haga clic en el icono Editar y, a continuación, en Eliminar dispositivo para eliminar la atribución.

Interfaz del registro de eventos

Tras registrar el dispositivo y enviar los eventos, éstos aparecen en el Registro de Eventos de la Consola de Pruebas con actualizaciones en tiempo real.

Detalles del Evento

Haga clic en la fila de eventos para expandir y ver los detalles completos de los eventos enviados desde la aplicación, incluyendo todos los parámetros y atributos.

Prioridad de resolución

Deben resolverse antes de la versión de producción: estos problemas impiden la funcionalidad básica.

Problemas de error comunes

• No se reciben sesiones: SDK no inicializado o no envía datos a Singular
• Claves SDK no válidas: Clave o secreto del SDK configurado incorrectamente.
• Platform Mismatch: La aplicación informa de un identificador de plataforma incorrecto

Resolución

1. Revise la descripción del error para obtener orientación específica
2. Consulte la guía de integración del SDK para la plataforma afectada
3. Verifique la configuración del SDK y el código de inicialización
4. Vuelva a realizar pruebas con la consola de pruebas después de las correcciones
5. Ejecute una nueva auditoría del SDK para confirmar la resolución

Prioridad de resolución

Debe resolverse para las mejores prácticas - funciones de integración pero se recomiendan mejoras.

Advertencias comunes

• Sin ID de usuario personalizado: No se ha implementado el ID de usuario personalizado para el seguimiento entre dispositivos.
• Problemas de seguimiento de ingresos: Los eventos de ingresos no siguen las mejores prácticas
• Faltan atributos de eventos: Eventos rastreados sin los atributos recomendados

Enfoque de resolución

1. Evaluar el impacto empresarial de la función que falta
2. Revisar la documentación de implementación de la función
3. Implementar si la función se ajusta a los requisitos
4. Probar la implementación mediante la consola de pruebas

Resolución Prioridad

Revisar y decidir - características opcionales que pueden no aplicarse a un caso de uso específico.

Problemas comunes de información

• Enlace profundo diferido desactivado: DDL puede no ser relevante para la estrategia de marketing
• Seguimiento de desinstalación no configurado: Seguimiento de desinstalación opcional en función de los requisitos
• Funciones opcionales del SDK: Características adicionales no críticas para la funcionalidad básica

Método de resolución

1. Revisar el nombre de validación para identificar la función opcional
2. Determine si la función es relevante para los requisitos de la empresa
3. Si no es relevante, ignorar el problema
4. Si es relevante, impleméntela siguiendo la documentación del SDK