Una métrica es una fórmula que transforma datos numéricos en un valor calculado, por ejemplo, "ingresos totales de este mes" o "tasa de entregas a tiempo". Las métricas se almacenan en el Catálogo de análisis y se pueden reutilizar en cualquier visualización. MAQL es el lenguaje de fórmulas que Alvys Reports utiliza para las medidas (métricas personalizadas, campos calculados). Se asemeja a SQL, pero se ejecuta dentro del Diseñador de informes. Algunos términos relacionados con este tema son MAQL, medida, métrica, métrica personalizada, campo calculado, fórmula y Catálogo de análisis.

Este artículo está pensado para los casos excepcionales en los que el Catálogo de Analytics no incluye la métrica que necesitas; por ejemplo, un recuento con un filtro muy específico o una operación aritmética con dos datos que aún no se han configurado. En esos casos, deberás escribir tú mismo la medida que falta en MAQL.

Antes de escribir nada, consulta el Catálogo. El Catálogo de Analytics de tu inquilino es muy completo: cientos de métricas predefinidas que abarcan viajes, ingresos, costes, puntualidad, kilómetros, conductores y mucho más. Busca primero en el Catálogo; es muy probable que la métrica que necesitas ya exista. Para ver un tutorial sobre cómo usar la función de arrastrar y soltar con métricas existentes, consulta «Crea visualizaciones con la función de arrastrar y soltar» en la sección «Profundiza».

Esto devuelve el número total de viajes, segmentado según los atributos que aparezcan en la visualización. Para seleccionar una referencia, escriba la llave de apertura y el editor le ofrecerá la opción de autocompletar desde el catálogo de su inquilino (métricas, datos, atributos y etiquetas). Seleccione el elemento que desee y el editor insertará la referencia completa.

Tu nueva medida se guarda en el Catálogo de Analytics y se comporta exactamente como una métrica predefinida: puedes arrastrarla a cualquier visualización, segmentarla por atributos y reutilizarla en distintos paneles. Gracias a que MAQL tiene en cuenta el contexto, el valor se adapta a los atributos presentes en la visualización.

Estos son ejemplos reales de paneles de control seleccionados por Alvys. Copie uno, cambie las referencias de métricas o etiquetas según la pregunta que esté formulando y guarde el resultado.

Dos consejos para nombrar y probar: Asigne nombres a las métricas personalizadas para que sean comprensibles para el público (por ejemplo, "Ingresos % interanual" se lee mejor que "rev_yoy_pct"). Pruebe la misma métrica en diferentes segmentaciones antes de guardarla; MAQL tiene en cuenta el contexto y el valor puede variar según los atributos que aparezcan en la visualización.

Esta es la regla de multidimensionalidad. Envuelva la función CASE o IF dentro de SUM(...) cuando la condición WHEN haga referencia a un atributo que no esté presente en la visualización. De lo contrario, la fórmula fallará.

Las operaciones aritméticas con un valor NULL dan como resultado NULL. Utilice IF o CASE para sustituirlo por cero:

Para garantizar la seguridad en la división, protéjase contra un denominador cero o nulo con una condición IF que devuelva 0 cuando el denominador sea 0 o nulo.

MAQL tiene en cuenta el contexto, por lo que el resultado depende de los atributos presentes en la visualización. Este comportamiento es normal y no constituye un error. Pruebe la métrica en cada segmentación antes de guardarla y utilice una cláusula BY para anular el contexto cuando necesite una agrupación fija.

Para crear informes, se requiere el nivel Personalizado y el rol de informes "Analítico" . Si su cuenta está en el nivel Gratuito de solo lectura o su usuario tiene el rol "Lector" , podrá ver los paneles, pero no guardar métricas personalizadas. Solicite a un administrador que habilite los informes personalizados en Gestionar > Integraciones , confirme que su rol de informes esté configurado como "Analítico" y póngase en contacto con el soporte de Alvys si necesita actualizar su nivel.

P: ¿Tengo que escribir MAQL para obtener la métrica que quiero?

R: Normalmente no. El catálogo de análisis de tu inquilino ya cuenta con cientos de métricas predefinidas. Busca primero en el catálogo y solo escribe consultas MAQL cuando la métrica específica aún no exista.

P: ¿Cómo es una métrica MAQL como mínimo?

A: Cada métrica MAQL comienza con SELECT. La métrica válida más simple hace referencia directamente a una existente, por ejemplo, SELECT {metric/trip_count_all}. Las referencias se encierran entre llaves: {fact/...} para una columna numérica sin procesar, {metric/...} para una métrica guardada, {attribute/...} para un atributo categórico y {label/...} para una etiqueta de texto utilizada en los valores de filtro. Las operaciones aritméticas usan suma, resta, multiplicación y división; las cadenas usan comillas dobles; los comentarios comienzan con una almohadilla.

P: ¿Quién puede ver las métricas personalizadas que guardo?

A: Todos los usuarios de tu inquilino que tengan acceso al Diseñador de informes. Las métricas personalizadas son visibles para todos los inquilinos, al igual que las visualizaciones guardadas, así que asígnales nombres claros y descriptivos.

P: ¿Cómo puedo controlar cómo se muestra el número?

A: El formato numérico reside en la métrica, no en la propia MAQL. Abra el menú desplegable Formato en el editor de métricas. Las cadenas de formato utilizan marcadores de posición: 0 es un dígito obligatorio que se rellena con ceros, hash es un dígito opcional sin relleno, punto es el separador decimal, coma es el separador de miles, porcentaje multiplica el valor por 100 y añade un signo de porcentaje. Los sufijos de truncamiento son K para miles, M para millones, B para miles de millones. También puede añadir colores y formato condicional, donde las reglas se aplican de izquierda a derecha y la primera coincidencia es la que prevalece.

Esta referencia se conserva textualmente del original; se ha tomado de la fuente autorizada ya que el lenguaje de fórmulas analíticas integradas no está definido en el código del producto.

Sintaxis básica: cada métrica MAQL comienza con SELECT. El orden de las cláusulas es alfabético: BY, WHERE, WITHOUT. Agregación: SUM, AVG, MIN, MAX, COUNT, MEDIAN, APPROXIMATE_COUNT. Matemáticas: ABS, ROUND, CEILING, FLOOR, POWER, SQRT, LN, LOG, EXP, GREATEST, LEAST, SIGN, TRUNC. Condicional: IF/THEN/ELSE/END y CASE/WHEN/THEN/ELSE/END (la ausencia de coincidencia ELSE produce null); se aplica la regla de multidimensionalidad. Filtrado: WHERE en valores de etiquetas, IN, NOT, LIKE (% cualquier secuencia, _ carácter único), HAVING en resultados agregados, TOP(n)/BOTTOM(n). Operadores lógicos: AND, OR, NOT, IN, NOT IN, comparaciones. Series temporales: FOR Previous, FOR Next, FOR Each, FOR PreviousPeriod, FOR NextPeriod. Macros de tiempo: THIS, PREVIOUS, NEXT con granularidades DAY, WEEK, MONTH, QUARTER, YEAR y variantes. Totales acumulados: RUNSUM, RUNAVG, RUNMIN, RUNMAX, RUNVAR, RUNSTDEV con WITHIN. Clasificación: RANK, TOP, BOTTOM. Las cláusulas BY anulan el contexto: BY attr, BY ALL attr, BY ALL OTHER, BY attr ALL OTHER. Estadísticas: STDEV, VAR, PERCENTILE, CORREL, MOVING_AVG. Próximamente estará disponible una referencia de configuración y tipos de gráficos.