Pruebas y modo sandbox

Prueba a fondo tu integración de Insert Affiliate antes de pasar a producción. Esta guía cubre las pruebas en sandbox, la creación de afiliados de prueba y la depuración de tu integración.

Entornos de prueba compatibles

Puedes probar Insert Affiliate por completo en los siguientes entornos:

  • Compilaciones locales: ejecuta tu app directamente desde tu entorno de desarrollo
  • TestFlight (iOS): la plataforma de pruebas beta de Apple
  • Google Play Internal Testing: canales de prueba cerrada o interna
  • Google Play Closed Testing: pruebas beta con un público limitado

La atribución y las compras funcionan en todos estos entornos y aparecerán en tu panel de Insert Affiliate en tiempo real.

Etiquetas de transacciones de sandbox

Si usas RevenueCat para la verificación de compras, las transacciones de sandbox aparecen claramente etiquetadas como tales en tu panel, lo que facilita distinguir las compras de prueba de las reales.

Crear afiliados de prueba

Puedes crear fácilmente cuentas de afiliado de prueba usando alias de correo electrónico. Esto te permite probar varios afiliados sin necesitar varias cuentas de correo.

Usar alias de correo electrónico

La mayoría de los proveedores de correo admiten la sintaxis de alias con +:

Ejemplo: Si tu correo es [email protected]

Puedes crear afiliados de prueba con:

Todos los correos llegarán a tu bandeja de entrada principal ([email protected]), pero Insert Affiliate trata cada uno como una cuenta de afiliado independiente.

Crear un afiliado de prueba

  1. Ve a Crear afiliado
  2. Selecciona "Crear Afiliado (Admin)"
  3. Introduce tu correo de prueba (por ejemplo, [email protected])
  4. Crea y pega un deep link de afiliado
  5. Haz clic en Crear afiliado
Formulario para crear un afiliado en el panel de Insert Affiliate con el modo de administrador seleccionado y el código corto del afiliado visible

Haz clic para ver a tamaño completo

Anota el código corto del afiliado: lo usarás para las pruebas.

Métodos de prueba

Hay dos formas principales de probar tu integración:

Método 1: pruebas con código corto (recomendado)

Probar con códigos cortos es la forma más rápida y fiable de verificar tu integración.

¿Por qué códigos cortos?

Las pruebas con código corto aíslan Insert Affiliate de tu plataforma de deep linking, lo que te permite:

  • Verificar la integración de Insert Affiliate de forma independiente
  • Probar sin lidiar con la complejidad del deep linking
  • Iterar rápidamente durante el desarrollo
  • Identificar si los problemas están en Insert Affiliate o en el deep linking

Cómo probar con códigos cortos

  1. Añade un campo de código corto a tu app: implementa una forma de introducir códigos cortos manualmente (consulta Códigos cortos para ver los detalles de implementación)
  2. Activa el registro detallado (verbose logging): activa los logs del SDK para ver lo que está pasando
  3. Ejecuta tu app: iníciala en un dispositivo de prueba o simulador
  4. Introduce el código corto: escribe el código corto de tu afiliado de prueba
  5. Verifica la atribución: revisa los logs para confirmar que el código corto se ha guardado
  6. Haz una compra de prueba: completa una transacción de sandbox
  7. Revisa tu panel: verifica que la transacción aparece en Insert Affiliate

Interpretar los resultados

✅ Si la atribución funciona con códigos cortos pero NO con deep links:

  • El problema está en la integración de tu plataforma de deep linking
  • Insert Affiliate funciona correctamente
  • Centra la depuración en la gestión de los deep links

❌ Si la atribución no funciona con códigos cortos:

  • El problema está en tu configuración de Insert Affiliate o de la verificación de compras
  • Sigue la guía de Solución de problemas

Cuando las pruebas con código corto funcionen, prueba el flujo completo con deep links.

Probar deep links (app ya instalada)

  1. Compila e instala tu app en un dispositivo de prueba
  2. Haz clic en el deep link de un afiliado (envíatelo por correo, mensaje o código QR)
  3. La app debería abrirse con el identificador del afiliado
  4. Verifica la atribución: revisa los logs para confirmar que el código corto se ha guardado
  5. Haz una compra de prueba: completa una transacción de sandbox
  6. Revisa tu panel: verifica que la transacción aparece

Probar deep links (app no instalada, "cold start")

Esto prueba la experiencia completa del usuario cuando alguien hace clic en un enlace de afiliado sin tener tu app instalada.

Método estándar:

  1. Desinstala tu app del dispositivo de prueba
  2. Haz clic en el enlace del afiliado: debería llevarte a la App Store/Play Store
  3. Instala la app desde la tienda
  4. Abre la app: la atribución debería funcionar en el primer inicio
  5. Haz una compra de prueba: completa una transacción de sandbox
  6. Verifícalo en el panel: comprueba que la transacción aparece

Método más rápido (solo Insert Links):

Si usas Insert Links, puedes probar la atribución en cold start sin pasar por la tienda de apps:

  1. Desinstala tu app
  2. Toca el enlace del afiliado: te llevará a la página de la App Store
  3. No la instales desde la tienda: en su lugar, instálala localmente desde Xcode/Android Studio
  4. Inicia la app instalada localmente
  5. Si Insert Links está configurado correctamente, la atribución funcionará exactamente igual que si se hubiera instalado desde la tienda

Para otras plataformas de deep linking, consulta su documentación sobre las opciones de prueba en cold start.

Compras en sandbox

Pruebas de sandbox en iOS

Requisitos:

  • Apple ID de sandbox (creado en App Store Connect)
  • Sesión iniciada con la cuenta de sandbox en el dispositivo de prueba
  • Productos de prueba configurados en App Store Connect

Pasos:

  1. Crea una cuenta de tester de sandbox en App Store Connect
  2. Cierra la sesión de tu cuenta habitual de la App Store en tu dispositivo
  3. Inicia tu app e intenta hacer una compra
  4. Cuando se te pida, inicia sesión con tu cuenta de sandbox
  5. Completa la compra de prueba (es gratuita)
  6. Verifica que la transacción aparece en tu panel de Insert Affiliate

Nota: Las compras de sandbox en iOS aparecen claramente marcadas en tu panel si usas RevenueCat.

Pruebas de sandbox en Android

Requisitos:

  • Cuenta de tester de licencias añadida en Google Play Console
  • Productos de prueba configurados
  • App subida al canal de prueba interna (no necesita revisión)

Pasos:

  1. Añade tu correo de prueba como tester de licencias en Google Play Console
  2. Instala tu app a través del canal de prueba interna
  3. Haz una compra de prueba (usa una tarjeta de crédito de prueba o será gratuita)
  4. Completa la compra
  5. Verifica que la transacción aparece en tu panel de Insert Affiliate

Depurar tu integración

Activar el registro detallado

Todos los SDKs de Insert Affiliate admiten registro detallado (verbose logging). Actívalo en tus compilaciones de desarrollo para ver:

  • Cuándo se reciben los deep links
  • Cuándo se guardan los códigos cortos
  • Cuándo se envían las compras a Insert Affiliate
  • Cualquier error o problema

Consulta la documentación del SDK de tu plataforma para saber cómo activar el registro detallado.

Situaciones de depuración habituales

Situación 1: los códigos cortos funcionan, los deep links no

Diagnóstico: Problema con la integración de la plataforma de deep linking

Pasos de depuración:

  1. Registra en los logs la URL del deep link que recibe tu app al iniciarse
  2. Verifica que coincide con el formato que espera tu plataforma de deep linking
  3. Comprueba que estás pasando el enlace al SDK de Insert Affiliate
  4. Revisa la documentación de tu plataforma de deep linking

Situación 2: la atribución funciona, pero las compras no aparecen

Diagnóstico: Problema con la integración de verificación de compras

Pasos de depuración:

  1. Verifica la configuración del webhook (RevenueCat/Apphud/Iaptic)
  2. Comprueba que el identificador del afiliado se está pasando a la plataforma de compras
  3. Para RevenueCat: verifica que el atributo insert_affiliate aparece en el panel de RevenueCat
  4. Revisa la guía de Solución de problemas

Situación 3: no funciona nada

Diagnóstico: Varios problemas o errores de configuración

Pasos de depuración:

  1. Empieza por la guía de Inicio rápido
  2. Verifica que la clave de API es correcta en la inicialización del SDK
  3. Comprueba que la configuración del panel de Insert Affiliate está completa
  4. Activa el registro detallado
  5. Prueba primero con códigos cortos
  6. Sigue la guía completa de Solución de problemas

Lista de comprobación de pruebas

Usa esta lista para asegurarte de probarlo todo a fondo antes del lanzamiento:

Pruebas básicas de integración

  • La atribución por código corto funciona
  • Las compras de sandbox aparecen en el panel
  • Los importes de las compras son correctos
  • El registro detallado no muestra errores
  • Los deep links abren la app cuando está instalada
  • Los deep links atribuyen correctamente cuando la app está instalada
  • La atribución funciona en el primer inicio después de la instalación
  • La atribución en cold start funciona (enlace → tienda → instalación → inicio)

Pruebas específicas por plataforma

  • Probado en iOS (si corresponde)
  • Probado en Android (si corresponde)

Buenas prácticas

Durante el desarrollo

  1. Prueba siempre primero con códigos cortos: aísla los problemas
  2. Usa el registro detallado sin reparos: ayuda a detectar problemas pronto
  3. Prueba con frecuencia: no esperes al final para probar la integración
  4. Prueba en dispositivos reales: los simuladores pueden comportarse de forma diferente

Antes del lanzamiento

  1. Completa la lista de comprobación de pruebas: asegúrate de cubrir todas las situaciones
  2. Prueba la atribución en cold start: es una parte crítica de la experiencia del usuario
  3. Revisa tu panel: familiarízate con los datos

Después del lanzamiento

  1. Supervisa las primeras transacciones: verifica que todo funciona en producción
  2. Ten el registro detallado disponible: usa compilaciones de depuración si surgen problemas

Obtener ayuda

Si tienes problemas durante las pruebas:

  1. Consulta Solución de problemas: guía de depuración paso a paso
  2. Revisa la documentación de la plataforma: guías de deep linking y de verificación de compras
  3. Contacta con soporte: escribe a [email protected] o visita app.insertaffiliate.com/help

Próximos pasos

Cuando hayas terminado las pruebas: