Configurar el checkout para Adapty Mail
Cada email que envía Adapty Mail contiene un enlace de checkout único para ese destinatario. Al hacer clic, accede a un embudo de checkout web que lo identifica por perfil, le presenta tu oferta y procesa el pago. Los embudos de checkout se encuentran en Web Paywalls dentro de Adapty Mail y se editan en el web paywall builder incluido.
Requisitos
- Un proveedor de pagos web con tus productos de suscripción configurados. Generate with AI solo es compatible con Stripe y se conecta directamente en el builder. Use your own hosted paywall acepta cualquier proveedor —Stripe, Paddle, PayPal u otros— ya que el pago se gestiona en tu propio lado.
No necesitas una cuenta aparte para el editor web de paywalls. Viene integrado con Adapty Mail: la primera vez que inicias sesión se crea un espacio de trabajo automáticamente, y accedes al editor con tus credenciales de Adapty. Esto es independiente de cualquier paywall web que hayas configurado en la página de paywalls del Adapty Dashboard principal — los paywalls web de Adapty Mail son entidades separadas que se gestionan íntegramente desde Adapty Mail.
Configura tu embudo de pago
En Adapty Mail, ve a Web Paywalls → Create. Tienes dos opciones:
- Generate with AI: el creador de paywalls web integrado en Adapty Mail genera el embudo por ti. Solo compatible con Stripe; si usas Paddle o PayPal, utiliza la segunda opción.
- Use your own hosted paywall: conecta un paywall que ya tengas alojado, con cualquier proveedor de pago.
Generar con IA
Disponible solo en proyectos vinculados a una app de Adapty — los que Adapty creó cuando abriste Mail desde el dashboard. Un proyecto que hayas creado tú mismo en Adapty Mail, en cualquier cuenta, utiliza Use your own hosted paywall.
La página de creación muestra un panel de Prerequisites en la parte superior con botones de acción en línea que te guían por cada condición previa: preparación de la marca, inicio de sesión en el builder, conexión con Stripe, productos y un paso final de revisión y publicación. Completa cada uno; el panel se actualiza a medida que se completa cada paso.
Cuando los requisitos previos están en verde, haz clic en Generate para abrir el diálogo de generación. Hay dos opciones a elegir:
- Environment: Elige Production o Sandbox. Sandbox usa tus productos en modo de prueba de Stripe y es la opción segura por defecto para entornos de desarrollo y locales — su cuenta está aislada de producción, por lo que las transacciones de prueba nunca afectan los datos en vivo.
- Plans: Elige hasta 3 planes de Stripe. Cada plan es una combinación de producto + precio. El paywall presenta estos como las ofertas en el checkout. Si eliges menos de 3, el paywall muestra solo los planes que hayas seleccionado.
Haz clic en Generate para ejecutar la compilación. Cuando termine, abre el editor en el builder para revisar el resultado y publicarlo. Luego, haz clic en Save.
El paywall debe estar publicado antes de que pueda gestionar el tráfico de checkout. Los paywalls no publicados devuelven un error cuando los usuarios hacen clic en los enlaces de checkout por correo electrónico.
Para ver los detalles del proveedor de pagos dentro del builder (cuentas de Stripe, modo de prueba o producción, configuración de productos), consulta Configuración del paywall web.
Usa tu propio paywall alojado
En esta opción, Adapty Mail redirige a los destinatarios a una página que tú alojas y sustituye los valores de cada destinatario en la URL. Todo lo que ocurre tras el clic —la oferta, el pago, la personalización— es responsabilidad tuya, con cualquier proveedor de pagos.
- En Web Paywalls → Create, selecciona Enter URL manually.
- Pega la URL de tu paywall alojado con marcadores de posición como parámetros de consulta. Adapty Mail los sustituye por destinatario para que la página pueda identificar al visitante. Ejemplo:
https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}
- Dale al paywall un Name y guárdalo. Después estará disponible para adjuntarlo a campañas.
La página de creación muestra los marcadores de posición que puedes usar y marca cada uno que encuentra en la URL que pegues:
| Placeholder | Value |
|---|---|
{email} | La dirección de correo electrónico del destinatario. |
{adapty.external_profile_id} | El ID de perfil del destinatario en Adapty. |
{funnelfox.external_profile_id} | El ID de perfil del destinatario en FunnelFox. |
{custom.external_profile_id} | El ID de usuario que enviaste a través de la API de Adapty Mail. |
{scheduled_email_id} | El ID del correo electrónico que contenía el enlace. |
Los tres marcadores de perfil son uno por cada fuente de la que puede llegar un perfil, y la página los enumera todos independientemente de si tu proyecto los utiliza. Usa el que corresponda a cómo envías los datos: {adapty.external_profile_id} para la integración de Adapty, {custom.external_profile_id} para la API. Un marcador para el que el destinatario no tiene valor se resuelve como una cadena vacía, por lo que nunca llega a tu página como texto literal; y un marcador que Adapty Mail no reconoce se transmite tal como lo escribiste.
Qué debe hacer tu página
La parte de Adapty Mail termina en la redirección. Dos tareas son tuyas:
- Identifica al visitante antes de que comience el pago: Lee el ID de perfil o el correo electrónico de la cadena de consulta y vincúlalo a la compra, para que el pago quede registrado en el cliente al que se envió el correo.
- Comunica la compra de vuelta: Adapty Mail nunca ve un pago procesado en tu propio proveedor, y una compra que no conoce no cuenta ni como conversión ni como ingresos atribuidos en Analytics; peor aún, el resto de la secuencia sigue enviándose a alguien que ya compró. Envíala por la vía que ya gestiona tus datos: la integración de Adapty o un evento de transacción en la API de Adapty Mail.
Pruébalo antes de lanzar
Send test email comprueba que el correo se renderiza y que tu página acepta pagos, pero Sandbox no está disponible para un paywall añadido por URL: el modal indica “This paywall has no sandbox products, so only production is available.” Por tanto, el test va a tu página real con productos reales: usa una tarjeta de crédito y solicita el reembolso, o apunta la URL a tu propio entorno de pruebas mientras verificas la integración. Consulta Prueba tu configuración.
Cómo se ve el checkout
Cuando un usuario hace clic en un enlace de checkout, aterriza en la Main conversion page. Después de intentar el pago, ve Payment success o Payment failed — solo se muestra una por intento.
Main conversion page Una presentación de ventas a página completa. La IA genera el texto y las imágenes de cada sección:
| Sección | Qué genera la IA |
|---|---|
| Titular | Titular en negrita orientado a beneficios |
| Subtitular | Propuesta de valor de apoyo |
| Insignia de oferta | Insignia de urgencia (sin precios inventados — usa lenguaje promocional vago) |
| Botón CTA | Texto orientado a la acción, 2–5 palabras |
| Beneficios | 3–6 tarjetas de beneficios con emoji y texto |
| Características | 3–8 descripciones de características con título y subtítulo |
| Planes | Título de selección de plan y texto del temporizador de oferta |
| Prueba social | Texto de prueba comunitaria y 3–5 reseñas de usuarios realistas |
| Preguntas frecuentes | 3–6 preguntas y respuestas habituales |
| Garantía | Texto de garantía de devolución de dinero o satisfacción |
Payment success Un mensaje de celebración con los próximos pasos y una imagen generada por IA.
Payment failed Un mensaje amigable que invita al usuario a intentarlo de nuevo. El estado del checkout se conserva.
Cómo funciona la personalización
El enlace CTA de cada correo apunta a una URL de checkout creada específicamente para su destinatario. Antes del envío, Adapty Mail sustituye cada marcador de posición en la URL de tu paywall por los valores de ese destinatario:
https://example.com/paywall?email=jane@example.com&adapty_profile_id=6f2a...c91
Un paywall generado recibe estos parámetros automáticamente — no se necesita ninguna configuración en el Paywall Builder web. Para un paywall añadido por URL, tú eliges qué marcadores de posición incluir. Cuando el usuario hace clic, la página de pago lee los parámetros para identificarle. Cuando se completa una compra, Adapty asocia el ingreso al correo electrónico concreto que generó la conversión. Estos datos aparecen en Análisis de campaña.
Solución de problemas
| Problema | Solución |
|---|---|
| El enlace de pago no se abre | Verifica que el paywall esté publicado en el web paywall builder |
| El usuario no está identificado en el pago | Confirma que se haya llamado a Adapty.identify() con el ID de usuario correcto antes de enviar el correo |
| La compra no se atribuye al correo | La atribución sigue el clic en el CTA del correo, por lo que el destinatario debe llegar al pago a través de ese enlace y la compra debe llegar a Adapty Mail en el mismo perfil. Una compra ya atribuida a un correo anterior conserva esa atribución |