Atribución de Ingresos

Función Pro

Conecta el comportamiento de los visitantes con ingresos reales. Ve qué páginas, campañas y fuentes de tráfico generan ventas integrando con tu proveedor de pagos.

---

Descripción General

La atribución de ingresos cierra la brecha entre marketing y ventas. En lugar de adivinar qué actividades generan ingresos, ve los números reales:

• Ingresos por fuente: Qué canales generan más ingresos
• Ingresos por página: Qué contenido lleva a compras
• Ingresos por campaña: Qué campañas tienen ROI positivo
• Recorrido del cliente: Qué ruta lleva a la conversión

---

Integraciones Compatibles

Stripe

Integración nativa con Stripe para rastreo automático de ingresos.

Configuración:

1. Abre Dominios → tu sitio → pestaña Ingresos → Integraciones → Stripe
2. Haz clic en Conectar Cuenta de Stripe
3. Autoriza la conexión
4. Los datos de ingresos se sincronizan automáticamente

Datos capturados:

• Montos de transacciones
• Correos electrónicos de clientes (para coincidencia de recorrido)
• Eventos de suscripción (nuevo, renovación, cancelación)
• Estado de pago (exitoso, fallido, reembolsado)

Lemon Squeezy

Integración nativa con Lemon Squeezy para empresas indie y SaaS.

Configuración:

1. Abre Dominios → tu sitio → pestaña Ingresos → Integraciones → Lemon Squeezy
2. Ingresa tu clave API de Lemon Squeezy
3. Configura el secreto de firma del webhook
4. Los datos de ingresos se sincronizan automáticamente

Polar

Integración nativa con Polar para monetización de código abierto y creadores.

Configuración:

1. Abre Dominios → tu sitio → pestaña Ingresos → Integraciones → Polar
2. Ingresa tu clave API de Polar
3. Configura el secreto de firma del webhook
4. Los datos de ingresos se sincronizan automáticamente

PayPal

Integración nativa con PayPal Checkout para pagos únicos. Se admiten modos Sandbox y Live.

Configuración:

1. Crea una aplicación REST API en PayPal Developer
2. Crea un webhook en PayPal apuntando a https://api.zenovay.com/webhooks/paypal/YOUR_WEBSITE_ID
3. Suscríbete a PAYMENT.CAPTURE.COMPLETED y PAYMENT.CAPTURE.REFUNDED
4. En Zenovay, abre Dominios → tu sitio → pestaña Ingresos → Integraciones → PayPal y pega:
   • Client ID, Client Secret (de tu aplicación de PayPal)
   • Webhook ID (del webhook que acabas de crear)
   • Elige Sandbox o Live para coincidir con tu aplicación de PayPal
5. Guarda — Zenovay valida las credenciales obteniendo un token de acceso OAuth2

Para mayor precisión en la atribución, establece purchase_units[0].custom_id = visitor_id al crear la orden de PayPal en tu servidor. Consulta la guía de integración de PayPal para obtener instrucciones completas.

El soporte de suscripción aún no está disponible — solo se rastrean capturas únicas en V1.

Paddle

Integración nativa con Paddle Billing (v2) para empresas SaaS que usan Paddle como comerciante registrado (maneja IVA de la UE e impuestos sobre ventas globales). Se admiten modos Sandbox y Live.

Solo necesitas UNA cosa: una clave API de Paddle con permiso de escritura. Zenovay crea el destino del webhook en tu nombre a través de la API de Paddle, captura el secreto de firma automáticamente y almacena ambos encriptados. Nunca tocas el panel de Notificaciones de Paddle.

Configuración (2 minutos):

1. En Paddle → Herramientas de desarrollador → Autenticación → Nueva clave API → permiso Escritura → copia la clave (comienza con pdl_live_apikey_ o pdl_sdbx_apikey_).
2. En Zenovay, abre Dominios → tu sitio → pestaña Ingresos → Integraciones → Paddle → pega la clave. Sandbox vs Live se detecta automáticamente del prefijo.
3. Haz clic en Conectar. Listo.

Lo que sucede tras bastidores:

• Zenovay valida la clave contra /event-types.
• Llama a POST /notification-settings en tu nombre — URL https://api.zenovay.com/api/webhooks/paddle/<your-website-id>, suscrita a transaction.completed + 3 eventos de suscripción.
• Captura endpoint_secret_key de la respuesta de Paddle y lo almacena encriptado.

Por qué nunca ves un campo "secreto de firma" en el camino feliz: Paddle oculta intencionalmente el secreto de firma en su panel después de la creación (sin botón "revelar", solo "Rotar secreto"). Zenovay usa la API de Paddle para obtener el secreto directamente — la única ruta documentada programáticamente. Consulta el artículo del centro de ayuda para obtener la explicación completa.

Datos capturados:

• Montos de transacciones (monedas incluyendo JPY/KRW sin decimales manejados correctamente según ISO 4217)
• Correos electrónicos de clientes cuando están presentes en el evento (para coincidencia de visitante → ingresos)
• Ciclo de vida de suscripción: creado, actualizado, cancelado (se asigna a subscription_status de Zenovay)
• Estado de pago

Los eventos de reembolso (adjustment.*) y las ramas de suscripción pausada / vencida no se representan aún en V1 — Zenovay los ignora silenciosamente.

Consulta la guía de integración de Paddle para solución de problemas y el fallback de configuración manual (raramente necesario).

Webhooks Personalizados

Para cualquier otro proveedor de pagos, usa webhooks:

Punto final del Webhook:

POST https://api.zenovay.com/webhooks/revenue

Carga útil:

{
  "api_key": "YOUR_API_KEY",
  "website_id": "YOUR_WEBSITE_ID",
  "event": "purchase",
  "data": {
    "transaction_id": "txn_123",
    "amount": 99.00,
    "currency": "USD",
    "customer_email": "[email protected]",
    "product_name": "Pro Plan",
    "metadata": {
      "plan": "annual",
      "coupon": "LAUNCH20"
    }
  }
}

---

Panel de Control de Ingresos

Métricas de Descripción General

Ingresos por Fuente

Ve qué fuentes de tráfico generan más ingresos:

• Tráfico directo
• Búsqueda orgánica
• Búsqueda pagada
• Redes sociales
• Referencias
• Campañas de correo electrónico
• Campañas etiquetadas con UTM

Ingresos por Página

Identifica contenido con alta conversión:

• Páginas de destino que llevan a compras
• Publicaciones de blog que influyen en decisiones de compra
• Rendimiento de página de precios
• Páginas de características que convierten

---

Modelos de Atribución

Último Toque (Predeterminado)

Acredita el 100% de los ingresos a la última página/fuente antes de la conversión.

Mejor para: Entender los desencadenantes finales de conversión

Primer Toque

Acredita el 100% de los ingresos a la primera página/fuente en el recorrido del cliente.

Mejor para: Entender canales de adquisición

Lineal

Acredita los ingresos equitativamente en todos los puntos de contacto en el recorrido.

Mejor para: Entender la contribución del recorrido completo

Decaimiento Temporal

Acredita más ingresos a los puntos de contacto más cercanos a la conversión.

Mejor para: Vista equilibrada con enfoque en conversión

---

Rastreo del Recorrido del Cliente

Conecta sesiones de visitantes anónimos con clientes pagadores:

Cómo Funciona

1. Rastreo anónimo: El visitante explora tu sitio
2. Revelación de identidad: El visitante proporciona correo electrónico (registro, pago, formulario)
3. Evento de compra: Pago recibido a través del webhook
4. Conexión del recorrido: Todas las sesiones previas vinculadas al cliente

Vista del Recorrido

Para cada cliente, ve:

• Fecha de primera visita y fuente
• Todas las páginas vistas en todas las sesiones
• Tiempo desde la primera visita hasta la compra
• Sesiones totales antes de la conversión
• Contenido que influyó en la compra

---

Configuración del Rastreo de Ingresos

Paso 1: Conectar Proveedor de Pagos

Consulta Integraciones Compatibles arriba.

Paso 2: Habilitar Rastreo de Identidad

Asegúrate de que la identificación del visitante esté configurada:

// Cuando el usuario proporciona correo electrónico (formulario, registro, pago)
window.zenovay('identify', 'user_123', {
  email: '[email protected]'
});

Paso 3: Verificar Flujo de Datos

1. Realiza una compra de prueba
2. Verifica el panel de control de Ingresos
3. Verifica que la transacción aparece con el monto correcto
4. Confirma que el recorrido del cliente está vinculado

---

Alertas de Ingresos

Recibe notificaciones sobre eventos de ingresos:

Resumen Diario de Ingresos

{
  "alert": "daily_revenue_summary",
  "schedule": "0 9 * * *",
  "channel": "email",
  "recipients": ["[email protected]"]
}

Hitos de Ingresos

{
  "alert": "revenue_milestone",
  "threshold": 10000,
  "period": "month",
  "channel": "slack"
}

Pagos Fallidos

{
  "alert": "payment_failed",
  "notify_immediately": true,
  "channel": "email"
}

---

Acceso API

Accede a datos de ingresos programáticamente:

Resumen de Ingresos

GET /api/websites/:websiteId/revenue/summary
  ?start_date=2025-01-01
  &end_date=2025-12-31
Authorization: Bearer YOUR_API_KEY

Ingresos por Fuente

GET /api/websites/:websiteId/revenue/by-source
  ?period=last_30_days
Authorization: Bearer YOUR_API_KEY

Recorridos de Clientes

GET /api/websites/:websiteId/revenue/journeys
  ?limit=100
Authorization: Bearer YOUR_API_KEY

---

Privacidad y Seguridad

Manejo de Datos

• Datos de transacciones encriptados en reposo
• Correos electrónicos de clientes hasheados para coincidencia
• Sin números de tarjeta de crédito almacenados
• Los datos de tarjeta se manejan completamente por tu proveedor de pagos — Zenovay nunca recibe números de tarjeta (alcance PCI manejado por Stripe, Paddle, PayPal, etc.)

Control de Acceso

• Datos de ingresos visibles para roles Admin y Owner
• El rol Viewer solo ve datos agregados
• El acceso API requiere alcances apropiados

---

Mejores Prácticas

1. Conecta el proveedor de pagos primero: Los datos de ingresos son fundamentales
2. Implementa rastreo de identidad: Vincula anónimos con clientes pagadores
3. Etiqueta campañas consistentemente: Usa parámetros UTM para atribución
4. Revisa el modelo de atribución: Elige el modelo que se ajuste a tu ciclo de ventas
5. Configura alertas: Sabe cuándo se alcanzan los hitos de ingresos

---

Próximos Pasos

• Eventos Personalizados - Rastrea acciones relacionadas con ingresos
• Objetivos - Configura objetivos de conversión
• Inteligencia B2B - Conecta visitas de empresas con ingresos

---

Herramientas gratuitas relacionadas

Las etiquetas UTM consistentes son la base de una buena atribución de campañas. Créalas con nuestro Generador de UTM gratuito y luego haz seguimiento de esas campañas en tu panel de Zenovay.