Guía de Métricas GEO — Iberostar

Documento de referencia para el proyecto GEO Iberostar. No incluye supuestos. Solo recoge definiciones desde:
1) /root/agents/geo/references/metrics/entity-metrics-system.md
2) meta.json del Unified Analytics Pack V2.

Fuentes de verdad

Entity metrics: entity_metrics.* Shares: unified pack (meta.json)

Regla: cualquier métrica de entidad (BIS, Position/Mention/Competitive/Sentiment Score, etc.) se reporta desde entity_metrics. Solo se permiten cálculos manuales para porcentajes simples (SOV/SBOV/share) con numerador/denominador + evidencia.

Unified Pack V2 (multi-run)

Campo	Valor
unified_pack_id	`014026b6-4a7f-496b-8164-8c67d789172c`
run_ids	`18e9a709-d22c-498d-9b34-793b3dc8c496` + `22d874d6-af09-4e87-88cc-b722cbd494ef`
unit_of_analysis	response-level
entity_metrics_source	entity_metrics only
competitive_score_mode	average_as_is

Nota: el pack puede emitir missing_segments si ciertos tags/segmentos no existen en uno de los runs (ej. Aruba vs run principal).

Métricas de entidad (desde entity-metrics-system.md)

Métrica	Rango	Definición / cálculo
Sentiment Score	-1 a 1	`sentimentScore = (sentiment - 3) / 2` (input 1–5)
Position Score	0 a 1	decay log: `weight(position)=1/log(position+2)`; `positionScore = entityWeightSum / totalWeightSum`
Mention Score	0 a 1	`mentionScore = entityMentionCount / totalMentionCount`
Competitive Score	0 a 1	`competitiveScore = (totalEntities - ranking + 1) / totalEntities`
BIS (Business Impact Score)	0 a 100	`normalizedSentiment=(sentimentScore+1)/2` `BIS=( normalizedSentiment0.30 + positionScore0.25 + mentionScore0.25 + competitiveScore0.20 )*100`

Shares (definición operativa del pack)

Métrica	Definición	Universo
SOV	`responses_marca / total_responses`	Todas las respuestas del estudio
SBOV	`responses_marca / total_branded_responses`	Solo respuestas con ≥1 marca

Importante: no asumir definiciones; validar siempre contra el meta.json del pack usado.

Consulta a DB (ejemplo)

Ejemplo (desde el archivo de métricas) para leer métricas de entidad desde entity_metrics:

radar analytics query --sql "
SELECT
  entity_identifier,
  avg(business_impact_score) as avg_bis,
  avg(sentiment_score) as avg_sentiment,
  avg(position_score) as avg_position,
  avg(mention_score) as avg_mention,
  avg(competitive_score) as avg_competitive
FROM entity_metrics
WHERE run_id = {runId:String}
GROUP BY entity_identifier
ORDER BY avg_bis DESC" \
--params '{"runId":"..."}'

Errores que NO se deben repetir

No recalcular BIS/Position/Mention/Competitive/Sentiment a mano desde entity_mentions.
No asumir definiciones de SOV/SBOV: comprobar meta.json del pack.
Si se calcula un porcentaje manual (SOV/SBOV/share), incluir siempre numerador/denominador + query + muestra.