Cómo documentar fórmula, fuente, ventana, granularidad, exclusiones y owner para que equipos, dashboards y agentes interpreten igual cada KPI sin ambigüedad.
Empieza por la decisión que el KPI debe informar
Una métrica existe para responder una pregunta y cambiar una acción. Antes de escribir la fórmula se documenta quién la usa, con qué frecuencia y qué decisión depende de ella. Conversión puede significar formulario, lead válido, cita o venta; sin propósito, cada equipo elige la versión que favorece su lectura. El contrato vuelve explícita la relación entre indicador y decisión.
Un contrato de datos convierte un nombre de métrica en una definición operable. Declara propósito, fórmula, fuente, granularidad, ventana, exclusiones, calidad, owner y acciones dependientes. Cuando dashboards, reportes y agentes usan el mismo contrato, las discrepancias se vuelven investigables y una actualización no cambia silenciosamente la verdad del negocio.
Documenta la definición completa
El contrato incluye nombre canónico, descripción, fórmula, numerador, denominador, unidad, fuente, evento, granularidad, zona horaria, ventana, atribución, filtros, exclusiones y owner. También contiene ejemplos de inclusión y exclusión. La definición debe ser comprensible para negocio y precisa para implementación. Si utiliza campos derivados, enlaza sus contratos para que la cadena pueda reconstruirse.
Declara calidad, latencia y comportamiento ante fallos
La misma métrica puede actualizarse en tiempo real o cerrar días después. El contrato indica frecuencia, retraso esperado, umbrales de completitud, duplicados permitidos y qué ocurre si una fuente falta. Un dashboard debería mostrar dato incompleto en lugar de rellenar silencio con cero. Las alertas se asignan a un owner capaz de investigar y comunicar impacto.
Versiona cambios y protege comparabilidad
Cambiar una ventana, evento o filtro puede alterar la serie histórica. Toda modificación registra fecha, razón, aprobador, impacto y estrategia: recalcular, mantener dos versiones o comenzar una nueva serie. Reportes y agentes deben conocer la vigencia y no mezclar definiciones. Los enlaces hacia el contrato permiten que una persona entienda por qué dos plataformas muestran valores distintos sin forzar una coincidencia artificial.
Conecta contratos con reporting e inteligencia artificial
Wiwo.Metriq puede utilizar definiciones compartidas para interpretar fuentes y preparar entregables; la revisión humana valida causas y recomendaciones. Un agente que lee revenue o CAC necesita saber definición, periodo y límites antes de explicar una variación. Los contratos no eliminan discrepancias entre plataformas: les dan contexto, owner y procedimiento. La confianza aparece cuando cada número puede rastrearse desde la decisión hasta la fuente.
Preguntas frecuentes sobre Contratos de datos: una definición común para cada KPI.
Definiciones claras para evaluar alcance, funcionamiento y límites.
¿Qué es un contrato de datos?
Es un acuerdo versionado que define estructura, significado, calidad, ownership y uso esperado de un dato entre productores y consumidores.
¿Cada métrica necesita un contrato?
Conviene comenzar por KPIs críticos, compartidos o automatizados. Métricas de bajo impacto pueden usar una ficha más simple.
¿Quién debe aprobar la definición?
El owner de negocio y el responsable técnico de la fuente, con participación de los equipos que toman decisiones con ese KPI.
¿Un contrato obliga a que todas las plataformas coincidan?
No. Explica qué mide cada fuente, por qué puede diferir y cuál se utiliza para una decisión específica.
