> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo se calculan las métricas

> La fórmula detrás de cada métrica de los informes, un ejemplo práctico y cómo reproducir cada número desde la Answers API.

Cada métrica de los informes se calcula por separado para cada modelo de IA y
luego se promedia entre los modelos con el mismo peso. Un modelo con muchas
ejecuciones cuenta lo mismo que un modelo con pocas.

$$
\text{puntuación} = \frac{\text{puntuación}_{\text{modelo 1}} + \text{puntuación}_{\text{modelo 2}} + \dots + \text{puntuación}_{\text{modelo } M}}{M}
$$

`M` es el número de modelos con al menos una mención de marca en el período. Un
modelo que mencionó otras marcas pero no la tuya cuenta en `M` con una
puntuación de 0. La posición promedio es la excepción: se promedia entre los
modelos en los que apareció tu marca. Los recuentos, como el número de
menciones o citas, se suman entre modelos en lugar de promediarse.

## Fórmulas por modelo

### Puntuación de visibilidad

$$
\frac{\text{ejecuciones que mencionan tu marca}}{\text{ejecuciones que mencionan cualquier marca}}
$$

Cuenta cualquier marca nombrada en la respuesta, no solo tus competidores
configurados, a menos que la hayas excluido en Configure Competitors, en la
configuración de marca. Las ejecuciones en las que no se mencionó ninguna marca
se excluyen tanto del numerador como del denominador. La API la devuelve como
un valor de 0 a 1 y la plataforma la muestra como porcentaje.

### Cuota de voz

$$
\frac{\text{menciones de tu marca}}{\text{menciones de todas las marcas}}
$$

Cada marca cuenta una vez por ejecución. La API la devuelve como un valor de 0
a 1 y la plataforma la muestra como porcentaje.

### Posición promedio

$$
\frac{\text{suma de las posiciones de tu marca}}{\text{ejecuciones que mencionan tu marca}}
$$

La primera marca mencionada en una respuesta ocupa la posición 1. Cuanto más
bajo, mejor.

### Cuota de citas

$$
\frac{\text{citas de tu dominio}}{\text{todas las citas}}
$$

La API la devuelve como un valor de 0 a 1 y la plataforma la muestra como
porcentaje. La misma fórmula se aplica por página al agrupar por `page`.

### Sentimiento positivo y negativo

$$
100 \times \frac{\text{afirmaciones positivas sobre tu marca}}{\text{todas las afirmaciones sobre tu marca}}
$$

El sentimiento negativo es igual, pero con las afirmaciones negativas. Cada
afirmación se califica como positiva o negativa, por lo que los dos valores
suman 100. Ambos se devuelven como valores de 0 a 100.

## Ejemplo: dos modelos

| | Modelo A | Modelo B | Resultado |
| - | - | - | - |
| Ejecuciones que mencionaron cualquier marca | 10 | 20 | |
| Ejecuciones que mencionaron tu marca | 4 | 12 | |
| **Puntuación de visibilidad** | 4 / 10 = 0.40 | 12 / 20 = 0.60 | (0.40 + 0.60) / 2 = **0.50** |
| Menciones de todas las marcas | 25 | 40 | |
| **Cuota de voz** | 4 / 25 = 0.16 | 12 / 40 = 0.30 | (0.16 + 0.30) / 2 = **0.23** |
| Suma de las posiciones de tu marca | 7 | 27 | |
| **Posición promedio** | 7 / 4 = 1.75 | 27 / 12 = 2.25 | (1.75 + 2.25) / 2 = **2.00** |
| Citas, todos los dominios | 50 | 100 | |
| Citas de tu dominio | 5 | 25 | |
| **Cuota de citas** | 5 / 50 = 0.10 | 25 / 100 = 0.25 | (0.10 + 0.25) / 2 = **0.175** |
| Afirmaciones sobre tu marca | 20 | 10 | |
| Afirmaciones positivas | 12 | 8 | |
| **Sentimiento positivo** | 12 / 20 = 60 | 8 / 10 = 80 | (60 + 80) / 2 = **70** |
| Afirmaciones negativas | 8 | 2 | |
| **Sentimiento negativo** | 8 / 20 = 40 | 2 / 10 = 20 | (40 + 20) / 2 = **30** |

<Warning>
  Agrupar primero las ejecuciones de todos los modelos (16 / 30 = 0.53 para la
  visibilidad) es incorrecto porque cada modelo tiene el mismo peso. Promediar
  las puntuaciones diarias para obtener una puntuación mensual también es
  incorrecto. Una puntuación mensual se calcula a partir de todas las
  ejecuciones del mes. Consulta [Convenciones y errores comunes](/es/cookbook/setup/conventions#dont-average-daily-rows-to-get-a-period-score).
</Warning>

## Reproducir las métricas desde la Answers API

[Get Answers](/es/rest-api/reports/query-answers-v2) devuelve una fila por
ejecución. Los campos que necesitas:

| Campo | Contenido |
| - | - |
| `run_id` | Identificador de la ejecución. |
| `model` | El modelo de IA, como un id y un nombre. |
| `mentions` | Nombres de las marcas en la respuesta, en orden de primera aparición, cada marca una vez. Se incluyen todas las marcas que Profound detectó, incluidas las que hayas excluido en Configure Competitors. |
| `citations` | URL citadas en la respuesta. `citation_details` agrega el nombre de host y el título de cada una, y debe solicitarse explícitamente en `include`. |
| `sentiment_claims` | Afirmaciones extraídas de la respuesta, cada una con `asset` (la marca a la que se refiere), `theme`, `claim` y `sentiment` (`positive` o `negative`). |
| `date`, `topic`, `tags`, `prompt`, `prompt_id`, `region`, `persona` | Etiquetas actuales de la ejecución. Úsalas para seleccionar filas. |

Selecciona las filas de las fechas, temas, etiquetas y regiones que quieras. Si
has excluido marcas en Configure Competitors, elimínalas primero de `mentions`.
Para cada métrica, calcula la fracción siguiente para cada modelo por separado
y luego promedia los valores por modelo. Multiplica los valores de sentimiento
por 100.

| Métrica | Numerador | Denominador |
| - | - | - |
| Puntuación de visibilidad | `run_id` distintos en los que tu marca está en `mentions` | `run_id` distintos en los que `mentions` no está vacío |
| Cuota de voz | `run_id` distintos en los que tu marca está en `mentions` | Entradas de `mentions`, sumadas en todas las ejecuciones |
| Posición promedio | Suma de las posiciones de tu marca en `mentions`, con la primera entrada como 1 | `run_id` distintos en los que tu marca está en `mentions` |
| Cuota de citas | Entradas de `citations` cuyo nombre de host es tu dominio | Entradas de `citations`, sumadas en todas las ejecuciones |
| Sentimiento positivo | Entradas de `sentiment_claims` en las que `asset` es tu marca y `sentiment` es `positive` | Entradas de `sentiment_claims` en las que `asset` es tu marca |
| Sentimiento negativo | Entradas de `sentiment_claims` en las que `asset` es tu marca y `sentiment` es `negative` | Entradas de `sentiment_claims` en las que `asset` es tu marca |

Cuenta por `run_id`, une los temas y los prompts por sus id, haz coincidir las
marcas por nombre y usa fechas en hora del Este (Eastern Time).

<Note>
  La Answers API devuelve el tema, las etiquetas y la lista de marcas tal como
  están configurados hoy, por lo que los números que reconstruyas a partir de
  ella cambian cuando cambia tu configuración. Consulta [Por qué cambian los
  números pasados](/es/cookbook/metrics/why-past-numbers-change).
</Note>
