Primeros pasos con Adapty Mail

En esta guía, configurarás Adapty Mail y lanzarás tu primer flow de correo electrónico.

La configuración tiene nueve partes:

  1. Elige tu tipo de cuenta
  2. Conecta tus datos
  3. Configura tu marca
  4. Configura tu dominio de envío
  5. Añade la dirección de tu empresa
  6. Crea un paywall web
  7. Genera una campaña con IA
  8. Lanza un flow
  9. Empieza a enviar

Adapty Mail hace un seguimiento de tu progreso en la lista de verificación del onboarding y la oculta una vez completados todos los pasos.

Antes de empezar

Asegúrate de tener lo siguiente antes de comenzar:

  • Acceso DNS: Puedes añadir registros a tu dominio raíz.
  • Pagos: Tienes una cuenta de Stripe con tus productos de suscripción configurados. Si quieres usar otro proveedor, aloja el checkout tú mismo — consulta Configurar checkout.

1. Elige el tipo de cuenta

Warning

Elige con cuidado: un proyecto que crees tú mismo en Adapty Mail no podrá vincularse a Adapty después.

El tipo de cuenta determina lo que puede hacer tu proyecto de Adapty Mail:

Adapty vinculado (recomendado)Independiente
RegistroInicia sesión con tu cuenta de Adapty y abre Mail. Adapty crea un proyecto vinculado a tu app. El intercambio de datos entre Adapty Mail y el SDK está desactivado hasta el paso final de la configuración. No tienes que migrar tus compras a Adapty: el modo observador, fácil de configurar y que solo reporta tus transacciones, es suficiente.Regístrate solo en Adapty Mail con un correo electrónico y una contraseña. Sin cuenta de Adapty y sin nada que instalar en tu app — aportas los datos tú mismo, a través de FunnelFox o la API.
Página de pago (Paso 6)Genera con IA — una página de pago alojada diseñada en torno a tu marca, con pagos de Stripe integrados — o tu propio paywall alojadoTu propio paywall alojado
SegmentosImporta desde Adapty o crea en MailCrea en Mail
Marca — de dónde se generan tus correos: nombre, logo, colores y tono (Paso 3)Construida a partir del listado de tu app en el store antes de que llegues, si tiene unoConstruida a partir de una URL del store que pegas
Datos de compra (Paso 2)Un clic en Settings > Project; FunnelFox y la API también funcionanClave secreta pegada en el dashboard de Adapty o FunnelFox, o la API
EquipoLos compañeros de equipo se unen cuando abren Mail desde tu empresa de Adapty; también se pueden invitar por correoInvitaciones por correo
Selector de productos de Adapty

2. Conecta tus datos

Antes de que Adapty Mail pueda enviar un correo a un usuario, necesita:

  • Su dirección de correo electrónico: El destino de tus emails.
  • Su customer user ID: El identificador único del usuario. Adapty lo almacena en el perfil del usuario para que la misma persona sea reconocida en todos sus dispositivos. Sin él, Adapty crea un nuevo perfil cada vez que reinstala tu app o cierra sesión.
  • Su feed de eventos de suscripción: Pruebas, renovaciones, cancelaciones y reembolsos, a medida que ocurren. Esto te permite segmentar usuarios según su comportamiento y asociar los ingresos al email que impulsó la compra. Sin el feed de eventos, la única secuencia que puede recibir un usuario es la destinada a personas que nunca han comprado.

Sigue las instrucciones para crear un punto de entrada para estos datos:

  • Adapty: Úsalo si tu app ya ejecuta el SDK de Adapty. Adapty reenvía perfiles, emails y eventos de suscripción por ti, así que no necesitas un servidor propio. En tu app, añade identificación de usuario y recogida de email. Consulta Conectar Adapty con Adapty Mail.
  • Adapty Mail API: Úsalo si ya tienes un backend que contiene estos datos, si tu app no tiene el SDK de Adapty, o si importas suscriptores desde otro lugar. Tú mismo publicas perfiles y eventos de transacciones. La clave secreta en Settings > Project autentica las solicitudes. Consulta Enviar emails y transacciones mediante la Adapty Mail API.
  • FunnelFox: Úsalo si captas y cobras a usuarios a través de los funnels web de FunnelFox. FunnelFox ya tiene sus emails, compras y eventos de suscripción, y los reenvía a Adapty Mail por su cuenta — sin trabajo con el SDK ni solicitudes que escribir. Consulta la guía de integración de FunnelFox.
  • Una combinación: Puedes usar más de un punto de entrada a la vez. Adapty Mail empareja los datos de usuario entrantes por customer_user_id y dirección de email.

Adapty Mail comienza a enviar correos electrónicos una vez que el resto de la configuración está en marcha.

3. Configura tu marca

Adapty Mail no puede generar emails ni paywalls web sin una marca. Tu marca almacena la información que Adapty Mail necesita para reflejar la apariencia y el tono de tu app: nombre, logo, colores, tipografías, tono de voz, funcionalidades y reseñas. Tú proporcionas el listado del store y Adapty Mail construye la marca a partir de él.

  1. En Adapty Mail, abre Brand.
  2. Si la página muestra una marca ya configurada, revísala y continúa. Si muestra la pantalla Set up your brand, sigue los pasos a continuación.
  3. En Store, elige App Store o Google Play y pega la URL de tu ficha.
    Note

    La pantalla de configuración solo acepta una ficha de App Store o Google Play. Si tu app no tiene ficha en ningún store —por ejemplo, un funnel web-to-app—, contacta con el soporte de Adapty antes de continuar.

  4. Haz clic en Build my brand. Adapty Mail descarga la página, analiza las reseñas e infiere el tono de tu marca. Normalmente termina en menos de un minuto.
  5. Para revisar secciones, editarlas manualmente o añadir fuentes de landing page y redes sociales, consulta Brand.

4. Configura tu dominio de envío

Adapty Mail envía correos desde tu dominio privado. Añades los registros DNS una sola vez y todas las campañas usan el mismo dominio verificado.

Para registrar tu primer dominio, en Adapty Mail ve a Settings > DNS > la sección Email domains.

  1. En el campo Domain, escribe tu dominio raíz (por ejemplo, yourapp.com). Solo se aceptan dominios apex: los subdominios como app.yourapp.com se rechazan al introducirlos.

  2. En el campo Sending subdomain, escribe el prefijo desde el que se enviarán tus correos, o déjalo vacío para usar mail. Los correos se enviarán entonces desde hello@mail.yourapp.com.

  3. Haz clic en Add domain.

    mail-email-domains.webp
  4. En tu proveedor de dominios, añade todos los registros DNS que aparecen en la tarjeta del nuevo dominio. Vienen en tres grupos: los registros DKIM y MAIL FROM de tu subdominio de envío, los registros del buzón que calienta el dominio y los registros de go.yourapp.com, que sirve imágenes y enlaces rastreados. Para saber qué autentica cada grupo, consulta Qué registros añades. Para exportarlos todos de una vez, haz clic en Export.

  5. Opcionalmente, añade el registro TXT DMARC sugerido en tu dominio raíz (recomendado).

  6. Haz clic en Check para verificar de inmediato, o sal de la tarjeta y deja que Adapty Mail compruebe el DNS automáticamente.

mail-email-domains.webp

Resumen del tiempo de verificación:

  • Sondeo automático: La primera comprobación se ejecuta 1 minuto después de añadir el dominio; luego los intervalos se duplican hasta alcanzar una vez por hora, hasta que se encuentren los registros.
  • Comprobación manual: Haz clic en Check en cualquier momento para lanzar una comprobación inmediata.
  • Propagación de DNS: Normalmente en minutos; en casos excepcionales, hasta 48 horas.
  • Ventana de verificación: 7 días. Si caduca, tus registros DNS permanecen en su lugar — añade tu dominio de nuevo en Settings > DNS para iniciar una nueva ventana.

Un dominio verificado es suficiente para empezar a usar Adapty Mail. Un proyecto puede tener hasta cinco dominios, y puedes añadir el resto más adelante.

Para más detalles sobre cada tipo de registro y el calentamiento del dominio, consulta Configura tu dominio de envío.

5. Añade la dirección de tu empresa

Las leyes anti-spam exigen una dirección postal física en cada correo electrónico de marketing. Adapty Mail la incluye en el pie de página de cada correo de campaña y bloquea la generación de campañas hasta que la rellenes.

  1. En Adapty Mail, ve a Settings > Company.
  2. En la sección Company address, completa los campos Legal company name, Address line 1, City, Postal code y Country. Los campos Address line 2 y State / Region son opcionales.
  3. Haz clic en Save.

6. Crea un paywall web

Cuando un destinatario hace clic en un CTA de tu correo electrónico, llega a un paywall web — una página de pago en el navegador. Cada campaña enlaza a uno, y Adapty Mail rechaza una campaña sin él. Este no es tu paywall in-app: una compra realizada ahí es un pago web, no una transacción de App Store o Google Play.

Tienes dos opciones:

  • Generar con IA: Genera un paywall con el constructor integrado, desarrollado por FunnelFox. El paywall generado usa Stripe para procesar los pagos.
  • Usar tu propio paywall alojado: Apunta Adapty Mail a una página que ya tienes alojada, con el proveedor que uses. Adapty Mail redirige al usuario a tu paywall con los datos del usuario prerrellenos en la URL. Un paywall alojado por ti puede usar cualquier proveedor de pagos.
Note

Generar con IA requiere Stripe y una cuenta vinculada a Adapty. Stripe es el único proveedor compatible con el checkout generado. Si usas un proveedor diferente o una cuenta de Adapty Mail independiente, utiliza tu propio paywall alojado.

Para empezar, en Adapty Mail ve a Web Paywalls > Create.

new-web-paywall.webp

Opción A: Generar con IA

La página muestra una lista de verificación de requisitos previos con botones integrados: complétala en orden y luego vuelve a generar. La lista cubre iniciar sesión en el Paywall Builder, conectar Stripe, añadir productos y revisar el resultado. Consulta Configurar el checkout para ver el proceso completo. Si terminas un requisito en otra pestaña, haz clic en Refresh en la lista de verificación para sincronizar su estado.

Cuando todos los requisitos estén en verde, haz clic en Proceed to generation. En el diálogo Choose plans:

  1. Elige entre 1 y 3 planes, todos en la misma divisa. Cada plan es una oferta que el paywall generado presenta en el checkout. Haz clic en Add plan para añadir un segundo y un tercero.
  2. Para cada plan, elige un precio de producción, su equivalente en sandbox, o ambos. Un precio de producción y uno de sandbox en la misma fila cuentan como un solo plan.
  3. Haz clic en Generate paywall.

Rellena una columna completa para cada plan o déjala vacía en todos — una columna rellenada solo a medias bloquea la generación. Sin precios de sandbox, los correos de prueba apuntan al paywall de producción y las compras de prueba no funcionan.

Important

El paywall debe estar publicado antes de poder procesar el tráfico de pago. Los paywalls no publicados devuelven un error cuando los usuarios hacen clic en los enlaces de pago por correo electrónico.

Opción B: Usa tu propio paywall alojado

  1. Selecciona Enter URL manually.

  2. 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 de pago pueda identificar al visitante. Ejemplo:

    https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}

    La página de creación lista los marcadores de posición que puedes usar. Consulta Configurar el checkout para ver a qué se resuelve cada uno.

  3. Guarda y publica.

Para conocer la anatomía del funnel de pago y cómo funciona la personalización, consulta Configurar el checkout.

generate-web-paywall.webp

7. Genera una campaña con IA

Una campaña es una secuencia de hasta 15 correos electrónicos que un destinatario recibe a lo largo del tiempo. La IA escribe toda la secuencia a partir de la marca que configuraste en el Paso 3: textos, diseño, imágenes principales y enlaces de pago personalizados.

  1. En Adapty Mail, ve a Campaigns y haz clic en Create.

  2. Establece el nombre de la campaña.

  3. En el desplegable Web paywall, selecciona el web paywall que añadiste en el paso anterior.

    mail-new-campaign.webp
  4. Haz clic en Generate emails.

  5. Rellena el diálogo de generación: tono, idioma, un prompt personalizado opcional (hasta 2.000 caracteres) y el número de correos (1–15, por defecto 4). Consulta Crear una campaña para saber qué hace cada campo.

    generate-emails.webp
  6. Haz clic en Generate. La generación suele tardar unos minutos. El sistema agota el tiempo de espera tras 5 minutos si no puede completarlo; vuelve a intentarlo si eso ocurre.

  7. Previsualiza cada correo. El encabezado de la vista previa tiene un Theme toggle (Auto, Light, Dark) que controla cómo se renderiza la vista previa; el contenido generado es idéntico en todos los modos. Puedes regenerar correos individuales, editar el texto o abrir el editor HTML para un control más detallado.

generated-emails.webp
  1. Haz clic en Create para guardar la campaña.

La campaña se guarda como borrador y todavía no se envía — las campañas se activan únicamente cuando se asocian a un flow (siguiente paso). No hay ninguna acción de “publicar” independiente en el editor de campañas.

8. Lanzar un flow

Adapty Mail incluye sus propios flows. Un flow conecta triggers (eventos de suscripción) con campañas (secuencias de correos). Cada uno de los cinco triggers — una suscripción a punto de expirar, un pago fallido, etc. — tiene su propio flow. Un flow puede enviar una campaña a todos los usuarios que activen el trigger, o usar segmentos para enviar campañas distintas a grupos diferentes.

  1. En Adapty Mail, ve a Flows y abre el trigger que quieras configurar:

    • Never purchased — usuarios que se registraron pero aún no han realizado ninguna compra.
    • Renewal cancelled — usuarios que desactivaron la renovación automática pero aún tienen una suscripción activa.
    • Billing issue — pago fallido, tarjeta rechazada o vencida, o período de gracia.
    • Expired — la suscripción ha caducado y se ha perdido el acceso.
    • Refunded — usuarios que solicitaron un reembolso tras realizar una compra.

    Consulta Flows para ver el objetivo y el tono recomendado para cada trigger.

  2. Haz clic en Create para abrir el diálogo.

create-flow-mail.webp
  1. En el diálogo:
    • Elige un Segment. All Users se dirige a todos los usuarios que activan este trigger, y es suficiente para empezar. Para afinar la audiencia más adelante, crea un segmento diferente — un subconjunto filtrado de tus usuarios según su país, edad o estado de suscripción.
    • Establece el tipo de contenido en Campaign (la opción A/B Test se explica en pruebas A/B).
    • Selecciona la Campaign que guardaste en el Paso 7.
  2. Haz clic en Save.

El flow se activa de inmediato — no hay un paso de lanzamiento separado. A partir de este momento, los usuarios que coincidan con el segmento empezarán a recibir la campaña en cuanto alcancen el evento de activación.

Note

Puedes añadir más filas al mismo trigger, cada una con su propio segmento y campaña. Adapty Mail las revisa de arriba abajo y utiliza el primer segmento que coincida. Deja All Users al final — Adapty Mail no guardará un flow si aparece en otra posición.

mail-flow-details.webp
Tip

Si los nuevos destinatarios deben confirmar su dirección antes de recibir comunicaciones de marketing, activa el doble opt-in antes de este paso. Solo se pedirá confirmación a los perfiles creados después de activarlo.

9. Empezar a enviar

Tu campaña está configurada pero aún no se ha activado: ningún dato de usuario está llegando a Adapty Mail. Empieza a enviar datos a través del punto de entrada que elegiste. Si tu proyecto está vinculado a Adapty (paso 1) solo cambia cómo activas el flujo de datos de Adapty, no lo que llega:

Tus datos provienen deTu proyecto de Mail está vinculado a una app de AdaptyQué hacer
El SDK de AdaptyEn Adapty Mail, ve a Settings > Project y haz clic en Enable Adapty integration. El botón permanece desactivado hasta que tengas un flow (paso 8).
El SDK de AdaptyNoAdapty puede alimentar un proyecto al que no está vinculado: solo necesita la clave. Copia la clave secreta desde Settings > Project y pégala en el dashboard de Adapty en Integrations > Adapty Mail.
Tu backend, a través de la API de Adapty MailCualquieraEmpieza a enviar perfiles y eventos de transacciones. Los perfiles que envíes antes de terminar esta configuración nunca recibirán nada, por eso este paso es el último.
FunnelFoxCualquieraCopia la clave secreta desde Settings > Project y pégala en FunnelFox en Integrations > Adapty Mail. Los datos empiezan a llegar en aproximadamente un minuto.

Desde este punto, los usuarios que coincidan con tu segmento recibirán la campaña en cuanto activen el desencadenador. Antes de abrir el acceso a usuarios reales, prueba toda la cadena con un usuario de prueba.

Solución de problemas

ProblemaSolución
Generate emails aparece desactivadoFalta la dirección de tu marca o empresa. El tooltip del botón indica cuál. Consulta el Paso 3 y el Paso 5
La generación del paywall está bloqueadaEl panel indica la causa: sin marca, sin cuenta de Stripe conectada o sin productos de Stripe con precios. Corrígelo y haz clic en Refresh en la lista de verificación
La campaña no se guardaToda campaña necesita un paywall web. Crea uno en el Paso 6
Enable Adapty integration aparece desactivadoAdapty Mail necesita al menos un flow primero. Consulta el Paso 8
Los registros DNS no se verificanComprueba que coincidan exactamente: sin puntos finales, destinos CNAME correctos, un valor por registro. La propagación de DNS puede tardar hasta 48 horas
La ventana de verificación ha expiradoAñade el dominio de nuevo en Settings > DNS para iniciar una nueva ventana. Los registros en tu registrador siguen activos, no hay nada que volver a añadir
La generación de emails ha superado el tiempo límiteLa generación se detiene tras 5 minutos. Vuelve a intentarlo y contacta con el soporte de Adapty si el problema persiste

Para errores fuera de la configuración inicial, consulta las secciones de solución de problemas en Configura tu dominio de envío y Configura el checkout.

Más información