Conectar Superwall
Apunta Superwall a Clakta con un webhook para que las compras, renovaciones y reembolsos de tu app lleguen automáticamente, y cada venta se atribuya al anuncio que trajo al usuario.
Superwall envía las compras, renovaciones y reembolsos de tu app a Clakta mediante un webhook: Clakta te da una dirección y tú la pegas en Superwall.
Conectar
En Clakta:
- Abre tu proyecto y ve a Configuración del proyecto → Plataformas de venta.
- Busca Superwall y haz clic en Conectar.
- Ponle a la conexión un nombre que vayas a reconocer después, como
Mi app, y haz clic en Crear conexión. - Copia la URL del webhook que aparece. Deja esta ventana abierta.
En Superwall:
- Abre tu app, ve a Integrations y elige Webhooks, dentro de Webhooks and tools.
- Haz clic en Create webhook. Ponle un nombre como
Claktay pega la URL que copiaste en Webhook URL. - Deja Events to listen for como está. Todos los eventos vienen marcados, y Clakta usa estos:
| Evento | Para qué lo usa Clakta |
|---|---|
INITIAL_PURCHASE | Registra el primer cobro de una suscripción. |
RENEWAL | Registra cada renovación, incluido el primer cobro después de una prueba gratuita. |
NON_RENEWING_PURCHASE | Registra una compra única. |
REFUND | Marca la venta como reembolsada. |
Clakta ignora los demás eventos, así que dejarlos marcados no causa ningún problema.
- Crea el webhook. Superwall muestra la clave de firma una sola vez, justo
después. Cópiala: empieza por
whsec_.
De vuelta en Clakta:
- Pega la clave en Clave de firma y haz clic en Finalizar.
La tarjeta pasa a mostrar Añadida. Las ventas nuevas aparecen pocos segundos después de pagarse. Las ventas anteriores a la conexión no se importan.
Superwall solo permite crear webhooks después de configurar el seguimiento de ingresos. Si la integración de Webhooks muestra Needs revenue tracking, configúralo primero en Superwall.
Atribuir cada venta al anuncio que trajo al usuario
Superwall solo sabe lo que tu app le cuenta. Para que Clakta sepa de dónde vino cada comprador, la app tiene que guardar esa información en Superwall como atributos de usuario antes de mostrar el paywall. Clakta lee estos:
| Atributo | Qué poner en él |
|---|---|
clakta_session_id | La sesión del visitante en Clakta, cuando el usuario llegó por tu web. |
clkt, utm_source, utm_medium, utm_campaign, utm_content | Los parámetros del anuncio, cuando la app los recibe (por ejemplo, en el enlace que la abrió). |
email | El email del comprador, para unir sus compras aquí con las de otras plataformas. |
Las renovaciones se atribuyen al mismo anuncio que el primer cobro. Sin estos atributos, las ventas se registran igual, solo que sin origen.
Si desarrollas la app tú mismo
Define los atributos con setUserAttributes de Superwall. En iOS:
Si el usuario empieza en tu web, lee allí su sesión con
clakta.getSessionId() y pásala a la app, por ejemplo en el enlace que la abre.
Qué se registra
Cada cobro pagado se convierte en un pedido: la primera compra, cada renovación y cada compra única. El pedido queda en la moneda en que pagó el comprador, o en dólares estadounidenses cuando Clakta no admite esa moneda.
Empezar una prueba gratuita no es una venta. El primer cobro después de la prueba sí lo es. Un reembolso total marca el pedido como reembolsado. Después de un reembolso parcial, el pedido sigue pagado.
Las compras en sandbox (TestFlight, cuentas de prueba de Google Play, modo de prueba de Stripe) no se registran.
Preguntas frecuentes
Artículos relacionados
Conectar Shopify
Instala la app de Clakta en tu tienda de Shopify. Configura el seguimiento del checkout, importa tus pedidos recientes y asocia cada venta al anuncio que la produjo.
Conectar Lemon Squeezy
Envía a Clakta tus pedidos, renovaciones y reembolsos de Lemon Squeezy mediante un webhook, y acredita cada venta al visitante que la hizo.
Conectar Dodo Payments
Apunta Dodo Payments a Clakta con un webhook para que tus pagos, reembolsos y contracargos lleguen automáticamente, y cada venta se asocie al visitante que la hizo.