Vireo Pro
Analítica de Freemius: qué contenido vende tu plugin
Freemius es una tienda remota, así que Vireo Pro reconstruye cada venta con dos mitades: el webhook de pago firmado aporta el dinero y Freemius Checkout en tu sitio aporta la visita del comprador. Se unen por el ID de pago de Freemius.
- Plan
- Vireo Pro
- Configuración
- ID de producto, clave secreta y un webhook en Freemius
- Eventos
- payment.created y payment.refund
- Dónde
- Vireo Analytics, Ingresos
Qué registra
- Los pagos, a partir del webhook payment.created de Freemius.
- Los reembolsos, a partir de payment.refund. Una notificación repetida se cuenta una sola vez, y los reembolsos que suman el pago entero lo marcan como reembolsado por completo.
- La fuente de cada venta hecha a través de Freemius Checkout en tu propio sitio.
- Las suscripciones, que se muestran en la tarjeta Suscripciones con MRR.
Cómo se reconstruye una venta de Freemius
- El webhook llega a /wp-json/vireo-analytics/v1/freemius/webhook. Vireo comprueba su firma HMAC-SHA256 con tu clave secreta y que su plugin_id sea tu ID de producto antes de registrar nada.
- El callback purchaseCompleted de Freemius Checkout envía la visita del comprador a Vireo desde su propio navegador. Si llega antes que el webhook, se retiene hasta seis horas.
- Los eventos de suscripción y licencia (subscription.created, subscription.cancelled, license.expired y license.cancelled) alimentan la tarjeta Suscripciones cuando Freemius los envía.
- wp vireo freemius backfill --since=<date> registra los pagos que el webhook no recogió, y --dry-run los cuenta antes. Necesita VIREO_FREEMIUS_API_TOKEN o VIREO_FREEMIUS_PUBLIC_KEY en el archivo de configuración de tu sitio o en el entorno.

Configúralo
- Ve a Vireo Analytics, Ajustes. En la parte superior de la pantalla hay una tarjeta «Seguimiento de ingresos de Freemius».
- Introduce el «ID de producto» que aparece en los ajustes del producto del panel de Freemius.
- Introduce el «Secreto del webhook»: la clave secreta de tu producto. Después haz clic en «Guardar ajustes de Freemius».
- Copia la «URL del webhook» de la tarjeta y, en Freemius, añádela como webhook para los eventos payment.created y payment.refund.
La clave secreta también autentica las llamadas a la API de Freemius, así que trátala como una credencial completa. Para mantenerla fuera de la base de datos, defínela en wp-config.php:
define( 'VIREO_FREEMIUS_SECRET', 'your-secret-key' );Qué verás
- Ingresos: Principales fuentes de ingresos e Ingresos por página de destino para las ventas hechas a través de Freemius Checkout en tu sitio.
- Una fila (unattributed) para las ventas sin visita en tu sitio, de modo que queden aparte del tráfico directo.
- Suscripciones: MRR actual, Variación neta del MRR, Bajas de clientes y Suscripciones activas.
Gratis o Pro
Vireo Pro. Consulta los precios.
Conviene saber
- Las ventas hechas en Freemius Checkout en tu propio sitio se atribuyen a la visita que trajo al comprador.
- Las ventas sin visita en tu sitio, como las renovaciones, aparecen en su propia fila (unattributed) en lugar de contarse como directas.
Preguntas
¿Puedo mantener la clave secreta fuera de la base de datos?
Sí. Define VIREO_FREEMIUS_SECRET en el archivo de configuración de tu sitio. Cuando la constante está definida, tiene prioridad sobre la clave guardada.
¿Qué eventos de webhook añado en Freemius?
payment.created y payment.refund. Son los dos que la tarjeta de seguimiento de ingresos de Freemius muestra junto a la URL del webhook.
¿Y si un pago llegó antes de configurar el webhook?
Ejecuta wp vireo freemius backfill con una fecha de inicio. Los pagos ya registrados se dejan como están, así que puedes ejecutarlo dos veces sin riesgo.
Documentación
Integraciones relacionadas
Prueba Vireo en tu propio sitio
Vireo Analytics es un plugin gratuito de WordPress. Cuenta las visitas sin cookies y guarda todo en tu propia base de datos. Vireo Pro añade las ventas de Freemius por origen, los objetivos y el resto.
Descarga Vireo gratis en WordPress.org