Sigue los ingresos de Tebex
La integración con Tebex y las páginas Ingresos y Códigos de creador. Los pagos llegan al panel directamente desde Tebex, no a través del agente.
En unos diez minutos tu tienda de Tebex alimenta el panel y ves lo que gana el servidor, quién paga, qué paquetes se venden y cuánto vale un jugador nuevo. Los ingresos no vienen del agente: tu tienda de Tebex envía cada pago al panel como un webhook firmado, y el panel lo asocia a un jugador por su UUID de Minecraft. Así los ingresos, el valor del jugador y el ROI de las campañas usan pagos reales.
Antes de empezar#
- Una tienda de Tebex y acceso a su panel de creador.
- Un miembro del espacio con Conectar y desconectar integraciones (
manage_integrations) para conectarla. - Para leer la página, Ingresos (
view_revenue); el rol Viewer viene de serie sin él. Mira Equipo y ajustes. - La moneda de tu tienda fijada en Ajustes: los importes se muestran en ella.
Pasos#
En Integraciones, abre Tebex.
Crea un endpoint de webhook en Tebex
En el panel de creador de Tebex, abre Integrations → Webhooks → Endpoints, añade un endpoint y copia su
webhook secret. Activa payment.completed, payment.refunded, los eventos payment.dispute.* y, para
suscripciones, recurring-payment.started, recurring-payment.renewed, recurring-payment.cancellation y
recurring-payment.ended.
Pega el secreto en el panel
Pégalo en Secreto del webhook y pulsa Conectar Tebex. Se guarda cifrado y no se vuelve a mostrar.
Pega la URL del endpoint en Tebex
El panel muestra la URL que debes usar. Tebex envía primero una petición de validación; el estado pasa a Recibiendo con el primer pago.
Importa los pagos anteriores (opcional)
En Importar pagos anteriores (opcional), añade una Clave secreta del servidor de juego (Tebex: Game Servers → tu servidor → secret key) y pulsa Importar pagos anteriores. El panel importa todos los pagos que Tebex aún lista. Importar de nuevo nunca duplica un pago. Los reembolsos importados así se fechan el día del pago.
Los nombres de los compradores, los correos, las IP y los códigos postales se descartan antes de guardar nada. Desconectar Tebex detiene los pagos nuevos; los ya guardados se conservan.
Comprueba que funciona#
Abre Ingresos (la pestaña Tienda). Cuando ha llegado un pago, Ingresos tras reembolsos y Jugadores de pago se rellenan, y Todos los pagos lo lista con su jugador. Si Integraciones muestra Esperando a Tebex, envía un evento de prueba desde el endpoint en Tebex y vuelve a ejecutar la comprobación de la página. Antes de conectar, la página muestra Conecta tu tienda de Tebex.
Ir más lejos#
La página Ingresos#
| Sección | Muestra |
|---|---|
| Evolución | Ingresos por periodo con reembolsos y contracargos bajo la línea, el total acumulado, y compradores y pagos. |
| Suscripciones y compras únicas | Dinero de pagos recurrentes frente a compras sueltas. |
| Cuánto vale un jugador nuevo | Valor del jugador durante sus primeros 90 días, por cohorte y por campaña. |
| Tiempo hasta la primera compra | Días desde la primera sesión de un jugador hasta su primer pago, con la espera típica. |
| Paquetes, Ingresos por país, Códigos de creador | Ingresos tras reembolsos de cada uno. Los paquetes muestran ventas, compradores, reembolsado y la parte de primeras compras. |
| Ingresos por tipo de paquete | Paquetes clasificados por Exylia AI a partir de su nombre: Rangos, Cajas y llaves, Cosméticos, Moneda, Packs, Otro, Sin clasificar. |
| Ingresos por origen | Dinero por la dirección por la que entró cada comprador la primera vez; Sin vincular a un jugador es dinero de compradores que nunca entraron a la network. |
| Mayores pagadores | Los jugadores que más gastaron en el rango, tras reembolsos. |
| Suscripciones | Activas, a punto de cancelarse, nuevas y terminadas, y la baja (Parte cancelada). Solo se pueden contar cuando la tienda también envía los eventos de fin y cancelación de pagos recurrentes. |
| Todos los pagos | Cada transacción, la más reciente primero; busca por jugador, paquete, origen o id, filtra por estado (Vinculado, Sin vincular, Reembolsado, Contracargo, Gratis) y ordena por más recientes o mayor importe. |
| Pedidos gratuitos | Pedidos pagados por completo con un cupón o una tarjeta regalo. No son ventas y nunca convierten a nadie en jugador de pago. |
Si fijas un objetivo mensual en Ajustes › Menú, una línea arriba dice si vas a buen ritmo.
Códigos de creador#
Abre Ingresos › Códigos de creador: los códigos que los compradores escribieron al pagar. Los ingresos son tras
reembolsos: los reembolsos y contracargos se descuentan del código que trajo el pago. La página muestra Ingresos con
código y su Parte de los ingresos, Códigos usados, la media Por transacción, los ingresos con y sin
código en el tiempo, los Códigos principales y Todos los códigos con sus pagos, compradores, media y último
pago. Tiene su propio permiso, Códigos de creador (view_creators).
Definiciones
Los importes están en la moneda del espacio (Ajustes). Los reembolsos y contracargos se restan el día en que ocurren.
| Métrica | Definición |
|---|---|
| Ventas (ingresos brutos) | Pagos completados. |
| Ingresos tras reembolsos (netos) | Ventas menos reembolsos y contracargos. |
| Lo que te queda | Ingresos netos menos los impuestos y comisiones de pasarela que Tebex informa por pago. |
| Compradores (payers) | Jugadores únicos con un pago completado. |
| Jugadores que pagaron (conversión) | Compradores ÷ jugadores activos. |
| Gasto por jugador que paga (ARPPU) | Ingresos netos ÷ compradores. |
| Ritmo anual (run rate) | Ingresos netos de los últimos 30 días × 12. |
| Cuánto vale un jugador nuevo (LTV) | Ingresos netos que trae una cohorte en N días desde su primer día, por jugador. |
| Ingresos por jugador nuevo | Ingresos netos del rango de los jugadores cuya primera entrada está en el rango, ÷ esos jugadores. |
| Coste por jugador nuevo (CAC) y Rentabilidad (ROI) | Mira Campañas. |
Un pago de un jugador que nunca se ha visto en la network sigue siendo ingreso; simplemente queda Sin vincular a un jugador, así que cuenta en todos los totales pero no pertenece a ninguna campaña, origen ni grupo de fecha de llegada. Los totales cuentan solo la moneda de la tienda; los pagos en otras monedas se listan aparte.
¿Falta algo en esta página? Dínoslo en Discord