Apps, keys e integración

Una app por cada web o bundle que instrumentas. Todas comparten servidor y base analítica; cada una tiene su key, su tagging y sus guías.

Instalar el agente (copiar y pegar)

El panel genera el snippet exacto de la app seleccionada:

<script src="https://TU-ARGUMENTUM/agent.js"
        data-key="sk_xxxxxxxx"
        data-endpoint="https://TU-ARGUMENTUM"></script>

Y para identificar usuarios y clientes (multitenant):

argumentum('identify', {
  visitorId: user.id,
  tenantId:  user.clienteId,
  visitor: { rol: user.rol },
  tenant:  { plan: user.plan }
});
argumentum('track', 'nombre_evento', { prop: 'valor' });

Qué configurar por app

• URL del sitio: la base para la autocaptura de pantallas del clickmap.
• Throttle de guías: máx. guías por usuario y ventana (por defecto 2/7 días).
• Ámbito de tracking: reglas include/exclude de rutas. Lo excluido no genera datos: ideal para dejar fuera el panel de administración o páginas legales.
• Informe semanal por webhook: cada 7 días el servidor envía un JSON con los KPIs de la semana (campo text listo para Slack). Configura la URL, guárdala y usa «Probar ahora».
• Privacidad (GDPR): borrado irreversible de todos los datos de un visitante (visitorId) o de un cliente y sus visitantes (tenantId). Solo rol admin. Requiere ClickHouse ≥ 23.3 (lightweight deletes).

Crear y eliminar apps

Crea una app por entorno/web que instrumentes. Eliminar una app borra su configuración (tagging y guías); los eventos ya almacenados permanecen en la base analítica.

API para BI e informes

Con el mismo ADMIN_TOKEN: POST /v1/query/{mau,kpis,top,funnel,paths, clickmap,adoption,guias,tenants}. Referencia completa y ejemplos en docs/INTEGRACION.md (enlazada arriba en esta misma pantalla).

Verificación

Tras desplegar, ejecuta el smoke de API: ADMIN_TOKEN=… node tools/api-smoke.mjs --server https://tu-servidor y confirma los 40 checks en verde.