Conectar FunnelFox a Adapty

FunnelFox crea funnels web: páginas de aterrizaje y cuestionarios que venden tus suscripciones fuera de la App Store y Google Play. Conecta FunnelFox a Adapty para dar a los compradores web acceso a las funciones de pago en tu app móvil, y para ver sus compras en el mismo dashboard que las compras de la store.

Conectar requiere una clave y un ID de nivel de acceso. Tu aplicación debe identificar al comprador para alcanzar ese nivel de acceso. Consulta Proporciona acceso en tu aplicación.

Cómo funciona la integración

FunnelFox gestiona el cobro en la web. A continuación, llama a la API server-side de Adapty para crear el perfil, registrar la transacción y otorgar el nivel de acceso cuyo ID introduces en la configuración de la integración de FunnelFox. Las renovaciones, cancelaciones y pagos fallidos actualizan el mismo perfil. Las compras web aparecen en Adapty analytics junto con los ingresos de App Store y Google Play.

Crea un producto correspondiente en Adapty por cada producto que vende tu embudo. La compra llega a Adapty de cualquier manera, pero sin un producto Adapty no tiene la duración de la suscripción, por lo que los análisis pueden reportar una duración incorrecta o dejar la compra sin categorizar.

Adapty vincula una compra web con un usuario de la app mediante el customer user ID. FunnelFox utiliza por defecto la dirección de correo electrónico introducida en el checkout como ese ID.

Si tu funnel factura a través de Stripe o Paddle, no tienes que conectar ese proveedor a Adapty también. Conéctalo solo si además vendes a través de él fuera de tus funnels, y Adapty deduplicará las transacciones que lleguen desde ambas fuentes.

Para construir el mismo flow con tu propio checkout web en lugar de un funnel de FunnelFox, consulta Sincronizar compras entre web y móvil.

Conectar FunnelFox

La configuración se realiza desde el lado de FunnelFox, siguiendo la guía de integración de Adapty de FunnelFox. Se necesitan dos valores de Adapty:

• Secret API key: Abre App Settings en Adapty y copia la clave secreta.
• Access level ID: El nivel de acceso que otorga una compra. Todas las apps de Adapty comienzan con uno llamado premium; si necesitas otro, créalo primero.

Otorga diferentes niveles de acceso dentro de un mismo funnel

Un funnel que vende un único nivel no necesita nada aquí: cada compra otorga el nivel de acceso definido en la configuración de la integración.

Para vender más de un nivel desde un mismo funnel, usa el campo Custom entitlement en un elemento de checkout. Este campo sobreescribe el ID del nivel de acceso de la configuración de la integración para las compras realizadas a través de ese elemento. Un funnel puede contener más de un elemento de checkout, como un botón Wallet y un checkout en acordeón. Cada uno tiene su propio campo Custom entitlement, así que rellénalo en cada elemento que deba otorgar el nivel de acceso personalizado.

Proporcionar acceso en tu app

Para desbloquear funciones de pago a un comprador web, llama a Adapty.activate() o Adapty.identify() con el mismo customer user ID que usó FunnelFox. Por defecto, ese ID es la dirección de correo electrónico que el comprador introdujo en el proceso de pago. Consulta Identificación de usuarios iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform y Capacitor para ver la llamada correspondiente.

Instalar la app desde un enlace del funnel no identifica al comprador. Hasta que tu app llame a Adapty.identify() con el ID correspondiente, el perfil que tiene el nivel de acceso y el perfil que la app creó permanecen separados, y la app no muestra ningún acceso de pago. Iniciar sesión con el correo del checkout los vincula.

Para desbloquear el acceso sin un paso de inicio de sesión, pasa el customer user ID del funnel a la app mediante un deferred deep link y llama a Adapty.identify() con ese ID en el primer lanzamiento.

Luego lee el nivel de acceso del perfil para desbloquear las funciones. Consulta Comprobación del estado de la suscripción iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, y Capacitor .

Prueba la integración

1. Completa una compra en tu funnel.
2. En Adapty, abre Profiles y busca el perfil por el ID de usuario cliente que usa FunnelFox.
3. Confirma que el nivel de acceso cuyo ID introdujiste en la configuración de la integración de FunnelFox está activo en ese perfil.
4. Abre tu app, identifica al mismo usuario y confirma que las funciones de pago se desbloquean.

Solución de problemas

Un comprador web abre la app sin acceso de pago

Tu app no ha identificado al comprador. FunnelFox otorgó el nivel de acceso a un perfil vinculado al ID que utilizó, que por defecto es el correo electrónico del checkout, y tu app está leyendo un perfil diferente. Llama a Adapty.identify() con ese ID, tal como se describe en Proporcionar acceso en tu app.

Otras integraciones de FunnelFox

FunnelFox se conecta a tres productos de Adapty, cada uno configurado por separado.