Documentación

Funnels Web2App

Califica usuarios con un quiz, guíalos por una pantalla informativa, cobra en la web y redirígelos de vuelta a tu app mediante un deep-link.

Resumen

Un funnel es una secuencia ordenada de pasos que termina en un paywall hosteado. Vive en una URL pública estable:

text
https://www.experiwall.com/f/{funnelId}

El patrón típico de Web2App es: corre un anuncio pago, envía tráfico a la URL del funnel, califica con un quiz corto, presenta el paywall, cobra en el navegador y luego redirige al usuario de vuelta a tu app móvil con un token de redención firmado.

No se requiere instalar ningún SDK del lado web. Tanto el funnel como el paywall los renderiza Experiwall en el servidor.

Tipos de paso

Cada funnel tiene una lista ordenada de pasos. Se admiten tres tipos:

  • quiz_single_select: una pregunta con opciones de radio etiquetadas. La elección del usuario se registra en la sesión y puede reenviarse a tu app mediante el token del deep-link.
  • info: un título, un texto opcional y un botón de CTA. Úsalo para pantallas de beneficios, generadores de confianza o placeholders de carga.
  • paywall: referencia un paywall publicado existente por ID. El funnel entrega el control al paywall hosteado; tras una compra exitosa, el usuario es redirigido a tu URL de éxito configurada.

El orden importa

Los pasos se ejecutan en el orden del arreglo. Aún no se admite la ramificación según respuestas del quiz; todos los usuarios recorren el mismo camino.

Flujo del usuario

Este es el recorrido completo desde el clic en el anuncio hasta la apertura de la app:

  1. El usuario llega a /f/{funnelId}.
  2. Experiwall crea una sesión anónima y escribe una cookie (exwf_{funnelId}) que persiste por 30 días.
  3. Los pasos de quiz e info se renderizan del lado del servidor; las respuestas se envían a /api/f/{funnelId}/answer.
  4. Cuando se llega a un paso de paywall, el funnel redirige a través de /api/f/{funnelId}/checkout?screen_id=..., que graba dos cookies de atribución de vida corta (exwf_active_session, exwf_active_funnel) y luego hace un 302 hacia el paywall hosteado en /p/{screenId}.
  5. El pago se completa en el paywall hosteado vía Stripe, Polar o MercadoPago.
  6. La ruta de retorno verifica el pago, firma un token de redención y redirige a tu URL de éxito.
  7. Si hay un app scheme configurado, la URL de éxito puede ser tu manejador de deep-link, que abre la app directamente.

Configuración

Los funnels se crean y gestionan desde Dashboard → Funnels. Cada funnel pertenece a un proyecto y referencia paywalls del mismo proyecto.

Para publicarlo:

  1. Crea un funnel y agrega al menos un paso de paywall.
  2. Publica el funnel. Los funnels sin publicar devuelven un 404.
  3. Asegúrate de que el paywall referenciado también esté publicado. Un paso de paywall que apunte a una pantalla sin publicar o eliminada muestra una página de error.
  4. Configura una URL de éxito en Settings → Payments. Ahí es donde llega el usuario después de la compra.

Para devolver al usuario a tu app después del checkout, configura un App scheme en Settings → Payments (por ejemplo, myapp). Experiwall construirá un deep-link con esta forma:

text
myapp://experiwall-redeem?token={signedToken}

El token es un payload firmado con HMAC-SHA256 (TTL de 5 minutos) que contiene screen_id, product_id, payment_intent_id y project_id. Verifícalo del lado del servidor o mediante la REST API antes de otorgar entitlements.

SDK nativo

El SDK de React Native exporta Experiwall.redeem(token), que envía el token a /api/sdk/redeem y devuelve el estado de entitlement verificado. Consulta la documentación del SDK de React Native.

Meta CAPI

Si corres anuncios de Meta (Facebook/Instagram) para llevar tráfico al funnel, conecta la Conversions API para obtener eventos Purchase del lado del servidor. Configura tu Meta Pixel ID y un token de acceso de Conversions API en Settings → Payments.

Al confirmarse una compra, Experiwall dispara un evento Purchase con el valor, la moneda y todas las señales de coincidencia disponibles capturadas al entrar al funnel: em (email hasheado), fbp (cookie del navegador), fbc (id de clic), IP del cliente y user agent.

Captura de fbclid

El parámetro de consulta fbclid se captura automáticamente del referrer cuando se crea la sesión del funnel. No requiere configuración.

Atribución

Cada sesión de funnel registra qué funnel y qué respuestas del quiz llevaron a una conversión. La cookie exwf_active_session vincula la sesión del navegador con el evento de pago, de modo que las conversiones aparecen tanto en las analíticas del funnel como en el panel de conversiones del paywall.

Las cookies de atribución son de vida corta (30 minutos). Si el usuario abandona y regresa después, la cookie de sesión del funnel (TTL de 30 días) restaura su progreso, pero se abre una nueva ventana de atribución para el pago.