# Primeros pasos con evoOrigin

> Pon en marcha evoOrigin: comprueba la captura en sesión, activa el registro de visitas y la atribución de leads y lanza el evento desde tu extensión.

# Primeros pasos con evoOrigin

## Antes de empezar

Tras instalar el paquete, la captura en sesión ya funciona. El registro en base de datos no: tienes que activarlo tú. Haz estos pasos en orden y detente donde ya tengas lo que necesitas.

## 1. Comprueba la captura en sesión

1. Abre una página de tu sitio añadiendo parámetros a la URL, por ejemplo `?utm_source=prueba&utm_medium=email&utm_campaign=lanzamiento`.
2. Navega por el sitio. El plugin de sistema guarda el origen en la sesión de Joomla bajo la clave `evo_origin` (la puedes cambiar en los ajustes del plugin).

Para que la captura no se active en peticiones que no son páginas, el plugin la omite en el administrador, en las peticiones que no son GET, en las que no son HTML, en `com_ajax`, en las peticiones AJAX y en los agentes de usuario que contienen «bot», «crawl» o «spider».

Otra extensión puede leer ese valor de la sesión. La estructura exacta está en la [referencia](https://evoaddons.com/es/documentacion/evoorigin-referencia).

## 2. Activa el registro de visitas (nivel 1)

1. Ve a *Componentes → evoOrigin* y abre las opciones (botón *Opciones*).
2. En la pestaña *Registro de visitas (nivel 1)*, pon *Registrar visitas* en «Sí».
3. Revisa *Cómo guardar la IP* (por defecto, truncada) y *Retención del detalle (días)* (por defecto, 90).
4. Guarda.

Cada sesión con algún origen genera una fila. Las verás en *Componentes → evoOrigin → Visitas*. Si quieres saber qué se guarda y cuánto tiempo, lee [Datos que trata](https://evoaddons.com/es/documentacion/evoorigin-datos) antes de activar esto en producción.

## 3. Registra solo con consentimiento (opcional)

Si tu sitio tiene un banner de cookies:

1. En la pestaña *Consentimiento*, activa *Registrar solo con consentimiento*.
2. Rellena *Cookie del banner* con el nombre de la cookie donde tu banner guarda la elección.
3. Rellena *Valor que significa «aceptado»*. Si lo dejas vacío, basta con que la cookie exista y no esté vacía.

Si activas el consentimiento y no indicas la cookie, evoOrigin no registra ninguna visita y el panel muestra un aviso.

## 4. Activa la atribución de leads (nivel 2)

1. En la pestaña *Atribución de leads (nivel 2)*, pon *Guardar la atribución de leads* en «Sí».
2. Fija *Retención del resumen (meses desde la última interacción)*. El valor por defecto es 24.
3. Pide a la extensión que crea tus leads que lance el evento `onEvooriginLead`. Ejemplo:

```
use Joomla\CMS\Factory;
use Joomla\Event\Event;

Factory::getApplication()->getDispatcher()->dispatch(
    'onEvooriginLead',
    new Event('onEvooriginLead', ['refType' => 'offer', 'refId' => (string) $offerId])
);
```

evoOrigin guarda un resumen con el primer origen, el último origen y la fecha de cada uno, ligado a esa referencia. Si el nivel 2 está apagado o la sesión no tiene origen, el evento no hace nada.

## 5. Mira los resultados

- *Estadísticas*: visitas por mes, fuente, medio y campaña.
- *Visitas*: el detalle de las visitas que aún se conservan.
- *Atribución de leads*: un resumen por lead.

## Qué hacer a continuación

- Ajusta cada opción con la página de [configuración](https://evoaddons.com/es/documentacion/evoorigin-configuracion).
- Si consultas datos desde otros sistemas, mira la [referencia](https://evoaddons.com/es/documentacion/evoorigin-referencia) de la API REST y de las herramientas MCP.

---

https://evoaddons.com/es/documentacion/evoorigin-primeros-pasos