Glosario

Cada término, dos perspectivas. La columna izquierda muestra cómo lo entiende un comprador de medios. La columna derecha muestra cómo lo encuentra un ingeniero DevOps en el sistema.

Término	Definición para el comprador de medios	Definición DevOps / del sistema
Seat	Una cuenta de comprador en Google Authorized Buyers. Usted delimita su análisis y segmentación por seat.	buyer_account_id en Postgres. Almacenado en la tabla seats. Sincronizado vía GET /seats.
QPS	Consultas Por Segundo: la tasa máxima de solicitudes de puja que usted pide a Google que envíe. Google limita el volumen real según el nivel de su cuenta.	Límite configurado por configuración de pretargeting. Tasa real de entrada monitoreada a través de métricas del embudo RTB en rtb_daily.
Desperdicio	QPS consumido por solicitudes de puja que su bidder rechaza (geografías incorrectas, tamaños incorrectos, sin creatividad compatible). Dinero gastado en nada.	(total_qps - bids_placed) / total_qps. Calculado a partir de agregados de rtb_daily. Visible en la API del embudo.
Configuración de pretargeting	Las reglas que controlan qué solicitudes de puja llegan a su bidder. Tiene 10 por seat. Controla geografías, tamaños, formatos, plataformas, editores.	Entidad mutable sincronizada desde la API de Google AB. Almacenada en pretargeting_configs. Gestionada vía /settings/pretargeting. Los snapshots permiten la reversión.
Embudo	La progresión desde la solicitud de puja hasta el gasto: QPS -> Pujas -> Victorias -> Impresiones -> Clics -> Gasto. Cada paso tiene caída.	Calculado a partir de métricas de rtb_daily. Servido por GET /analytics/rtb-funnel. El frontend almacena en caché durante 30 minutos.
Creatividad	Un recurso publicitario: imagen, video, HTML o nativo. Tiene formato, tamaño, URL de destino e historial de rendimiento.	Fila en la tabla creatives. Miniaturas en almacenamiento de blobs. Sincronizado desde la API de Google AB. Rendimiento obtenido de joins con rtb_daily.
Campaña	Una agrupación lógica de creatividades. Se usa para organizar el análisis y la generación de informes.	Fila en la tabla ai_campaigns. Relación muchos-a-muchos con creatividades. Soporta agrupación automática por IA.
Tarjeta de configuración	El panel de la interfaz que muestra el estado de una configuración de pretargeting, QPS máximo, geografías, tamaños, formatos y plataformas.	Componente React PretargetingConfigCard. Datos de GET /settings/pretargeting-configs.
Frescura de datos	Una cuadrícula que muestra qué fechas tienen datos importados ("importado") vs. vacíos ("faltante") para cada tipo de informe.	GET /uploads/data-freshness. Usa consultas generate_series + EXISTS contra rtb_daily, rtb_bidstream, rtb_quality, rtb_bid_filtering. Timeout de 30s.
Importación	Obtener datos de rendimiento en CSV dentro de Cat-Scan, ya sea por carga manual o por importación automática de Gmail.	CSV parseado, validado, deduplicado (vía restricción única row_hash), insertado en las tablas destino. Carga fragmentada para archivos > 5MB.
Reversión	Revertir un cambio de configuración de pretargeting a su estado anterior. Vista previa con simulación y luego confirmación.	Restauración de snapshot: lee pretargeting_snapshots, aplica el delta a la API de Google AB, registra nuevo snapshot. POST /snapshots/rollback.
Optimizador / BYOM	Sistema automatizado que puntúa segmentos y propone cambios de configuración. Usa su propio modelo externo.	Endpoint de puntuación invocado vía HTTP POST. Propuestas almacenadas en optimizer_proposals. Ciclo de vida: puntuar -> proponer -> aprobar -> aplicar.
Preset de workflow	Seguro, equilibrado o agresivo. Controla cuán audaces son las propuestas del optimizador.	Parámetro canary_profile en la API de score-and-propose. Afecta los umbrales de confianza y los límites de magnitud de cambio.
CPM efectivo	Lo que realmente paga por cada mil impresiones, teniendo en cuenta el desperdicio y el costo de infraestructura.	Calculado en OptimizerEconomicsService. Combina datos de gasto de rtb_daily con el costo de alojamiento configurado.
Conversión	Una acción valiosa del usuario (compra, registro) rastreada después de una impresión. Se retroalimenta para optimizar la segmentación.	Evento ingerido vía píxel (GET /conversions/pixel) o webhook (POST /conversions/webhook). Almacenado en tablas de conversiones. Verificado con HMAC para webhooks.
Tasa de ganancia	Victorias / Pujas. Qué tan competitivas son sus pujas en la subasta.	auction_wins / bids_placed de rtb_daily.
CTR	Clics / Impresiones. Qué tan atractivas son sus creatividades.	clicks / impressions de rtb_daily.
Compuerta de salud en tiempo de ejecución	(No es un término de comprador)	Workflow CI v1-runtime-health-strict.yml. Ejecuta verificaciones de extremo a extremo: salud de la API, salud de datos, conversiones, optimizador, SLO de QPS. Devuelve PASS/FAIL/BLOCKED por verificación.
Verificación de contratos	(No es un término de comprador)	scripts/contracts_check.py. Valida contratos de datos (reglas no negociables desde la importación hasta la salida de la API). Se ejecuta post-despliegue. Bloquea el release en caso de fallo.
Cloud SQL Proxy	(No es un término de comprador)	Contenedor sidecar que proporciona acceso autenticado a Cloud SQL Postgres. Debe estar en buen estado antes de que arranque el contenedor de la API.
Encabezado X-Email	(No es un término de comprador)	Encabezado HTTP establecido por OAuth2 Proxy tras la autenticación de Google. El API lo considera confiable cuando OAUTH2_PROXY_ENABLED=true. Nginx lo elimina para solicitudes externas.