Glosario

Explore Meshline

Products Pricing Blog Support Log In

Empecemos por tus objetivos.

Agenda una llamada
Operaciones autónomas

CrUX Vis o un panel personalizado con la History API: cuál encaja con tu revisión semanal

¿CrUX Vis o un panel propio con la CrUX History API para tu revisión semanal? Haz una verificación de cobertura y sabrás cuándo basta el panel fijo y cuándo conviene construir.

Ilustración plana con un engranaje naranja junto a un ícono de panel en azul marino y turquesa sobre un fondo circular claro.

Tu equipo quiere seguir la evolución de los Core Web Vitals semana a semana.

Está evaluando dos opciones: el panel CrUX Vis o una construcción propia sobre la CrUX History API.

La respuesta correcta depende de una sola verificación: si el diseño fijo del panel responde todas las preguntas fijas que tu revisión semanal realmente hace.

Este artículo recorre esa verificación de cobertura paso a paso.

Si el panel preconstruido cubre tus preguntas, guardas una URL compartible y no construyes nada.

Si una pregunta concreta queda sin respuesta, ese vacío —y no una preferencia general por personalizar— es lo que justifica una construcción propia.

Qué te ofrece realmente CrUX Vis

CrUX Vis es un panel que visualiza los datos históricos semanales de la CrUX History API.

Entras en cruxvis.withgoogle.com, escribes un origin o una URL, pulsas Go y obtienes gráficos.

La URL luego puede compartirse y guardarse en favoritos como referencia rápida, algo útil si varias personas del equipo revisan las mismas páginas.

El panel tiene seis páginas: Core Web Vitals, Loading Performance, Interactivity, Visual Stability, Ad Metrics y All Metrics.

Cada página muestra distribuciones a lo largo del tiempo para las últimas 40 semanas donde hay datos disponibles.

Los datos semanales se actualizan cada lunes, y cada punto de datos incluye los 28 días anteriores, de modo que las ventanas se superponen.

Cada página tiene una sección de controles.

Permite alternar entre datos a nivel de origin y de URL, y entre teléfono, escritorio, tablet o todos los dispositivos.

También permite cambiar los periodos de tiempo mostrados y elegir el percentil 75, las distribuciones o ambas.

La cobertura de métricas es amplia.

La página Loading Performance incluye Largest Contentful Paint, First Contentful Paint, Time to First Byte, el tipo de recurso del LCP y las subpartes de imágenes del LCP.

También cubre Round Trip Time, tipos de navegación y factores de forma.

Interactivity cubre Interaction to Next Paint.

Visual Stability cubre Cumulative Layout Shift.

La página Ad Metrics incluye el número de anuncios, la densidad publicitaria y el peso de los anuncios por CPU y por red.

All Metrics reúne todo en un solo lugar.

Lo que no ofrece es personalización.

La documentación es explícita: CrUX Vis no ofrece opciones de personalización más allá de los controles.

A quienes quieren un panel propio se les remite a la CrUX History API que lo alimenta, para que muestren los datos como quieran.

Haz la verificación de cobertura antes de decidir

Antes de elegir un camino, anota las preguntas fijas que hace tu revisión semanal.

Luego mapea cada una a una página y un control del panel.

Esta es toda la decisión en miniatura.

  • Si una pregunta se mapea a una de las seis páginas con los controles existentes, CrUX Vis la responde.
  • Si una pregunta necesita un diseño distinto, una vista combinada entre páginas o una entrega automatizada en un informe que tu equipo ya lee, el panel no puede responderla, porque su única flexibilidad son los controles integrados.
  • Si todas las preguntas se mapean, ya terminaste: guarda la URL compartible de CrUX Vis en favoritos y omite la construcción por completo.

Una advertencia sobre el paso de mapeo: una pregunta que parece sin mapeo puede responderse cambiando un control.

Por ejemplo, una pregunta sobre usuarios móviles en particular queda cubierta por el control de dispositivo, no por una función faltante.

Revisa los controles antes de declarar un vacío.

Verifica primero la disponibilidad de datos, en cualquier caso

Sea cual sea la opción que te incline, confirma que existen datos para tu sitio antes de comprometerte.

CrUX Vis no funciona para todos los sitios web.

Si tu origin no está incluido en el conjunto de datos de CrUX, no habrá datos que mostrar.

El conjunto incluye más de 15 millones de origins, pero el que buscas puede no tener datos suficientes para estar incluido.

Algunos problemas habituales conviene revisar antes de concluir que faltan datos.

Uno es indicar el protocolo equivocado, por ejemplo http:// en lugar de https://.

Otro es omitir el subdominio cuando es necesario.

Algunos sitios redirigen, así que si http://example.com redirige a https://www.example.com, debes usar la segunda, que es la versión canónica del origin.

También revisa la granularidad.

Los datos a nivel de URL pueden no estar disponibles incluso cuando sí lo están a nivel de origin.

Si tu revisión semanal se centra en una landing page concreta, verifica que esa página tenga datos antes de montar un proceso de revisión sobre ella.

Estas comprobaciones de disponibilidad aplican también a una construcción propia, porque ambas superficies se apoyan en el mismo conjunto de datos de CrUX.

Un panel que construyas tú no conjurará datos que el conjunto subyacente no contiene.

Qué implica una construcción propia con la History API

Si la verificación de cobertura revela un vacío real, la CrUX History API es el camino documentado.

Da acceso a métricas históricas de experiencia de usuarios reales con granularidad de página y de origin.

Puedes solicitar entre 1 y 40 periodos de recolección semanales; por defecto se devuelven 25.

Usarla requiere una clave de API de Google Cloud aprovisionada para el uso de la Chrome UX Report API.

La misma clave sirve para las API diaria y de historial.

Los ejemplos de solicitud documentados incluyen la clave de API como parámetro de consulta.

Las consultas se envían como objetos JSON en una solicitud POST al endpoint queryHistoryRecord.

Especificas una propiedad origin o url, un formFactor como PHONE, y las métricas que quieres.

Si omites la propiedad metrics, se devuelven todas las métricas disponibles.

Si omites formFactor, los valores se agregan entre todos los factores de forma.

La estructura de la respuesta refleja la API diaria de CrUX, salvo que los valores llegan en arreglos con nombres en plural.

Por ejemplo, histogramTimeseries en lugar de histogram y p75s en lugar de p75.

El arreglo collectionPeriods lista la primera y la última fecha de cada ventana de agregación.

Por defecto se devuelven 25 periodos de recolección.

Puedes cambiarlo estableciendo collectionPeriodCount en la solicitud con un número entre 1 y 40.

La API se actualiza cada lunes alrededor de las 04:00 UTC y contiene datos hasta el sábado anterior, con el desfase estándar de dos días.

Entiende la forma de los datos antes de graficarlos

Dos características documentadas de los datos afectan a cualquier panel, propio o no.

Primera: las ventanas se superponen.

Cada periodo de recolección contiene los 28 días anteriores de datos agregados.

Los periodos son semanales, así que tres semanas de datos se arrastran a cada periodo siguiente y solo una semana es nueva.

La documentación lo describe como similar a un promedio móvil.

Un cambio brusco de una semana a otra en tu gráfico refleja una semana nueva de datos dentro de una ventana de 28 días.

Por eso los saltos de un solo periodo se suavizan.

Planifica tus umbrales de revisión con eso en mente, en lugar de tratar cada punto como una semana independiente.

Segunda: la elegibilidad puede cambiar con el tiempo.

Un origin o una URL puede ser elegible solo para algunos periodos de recolección.

En esos casos la API devuelve NaN para las densidades del histograma y null para los percentiles en los periodos sin datos elegibles.

Para URLs u origins que entran y salen de elegibilidad, puedes notificar muchas entradas faltantes.

Un ejemplo ilustrativo de la verificación de cobertura

Este ejemplo es ilustrativo, no un resultado de un cliente real.

Supón que un equipo de marketing pequeño hace una revisión los lunes con tres preguntas fijas.

¿Los Core Web Vitals del sitio en general van en la dirección correcta?

¿La experiencia móvil mantiene el ritmo de la de escritorio?

¿Y el rediseño de la portada del mes pasado cambió el comportamiento de carga en esa página concreta?

Mapeando cada pregunta: la de tendencia se mapea a la página Core Web Vitals.

La de móvil frente a escritorio se mapea al control de dispositivo en esa misma página.

La de la portada se mapea a datos a nivel de URL en la página Loading Performance.

Primero verifica que la URL de la portada tenga datos a nivel de URL, porque pueden faltar incluso cuando existen a nivel de origin.

Las tres se mapean, así que el equipo guarda en favoritos la URL de CrUX Vis para el origin y otra para la portada, y no construye nada.

Ahora supón que existiera una cuarta pregunta: llevar la tendencia del p75 de LCP al informe del equipo de pipeline.

El informe debería actualizarse automáticamente cada semana.

Esa pregunta necesita un diseño distinto y una entrega automatizada, que los controles del panel no pueden dar.

Esa única pregunta sin mapeo —no un deseo vago de más gráficos— justificaría una construcción con la History API.

Esa construcción requiere una clave de API y el manejo de periodos con NaN y null.

Una lista de decisión breve

Recorre estos puntos en orden.

Cada pregunta tiene su propia consecuencia.

  1. ¿Tu origin tiene datos en el conjunto de CrUX, usando la forma canónica https con el subdominio? Si no aparece ningún dato, corrige primero la forma del origin; si sigue sin mostrar nada, puede que el origin no tenga datos suficientes, y ninguna de las dos opciones ayudará.
  2. ¿Cada pregunta fija semanal se mapea a una de las seis páginas con los controles existentes? Si sí para todas, guarda la URL compartible y detente. Si una pregunta necesita un diseño distinto, una vista combinada o informes automatizados, ese vacío concreto apunta a una construcción propia.
  3. Para preguntas de página específica, ¿esa URL concreta tiene datos a nivel de URL, y no solo el origin? Si no, decide si los datos a nivel de origin responden la pregunta o si la pregunta a nivel de página queda sin respuesta en ambas opciones.
  4. Para una construcción propia, ¿el equipo tiene una clave de API de Google Cloud aprovisionada para el uso de la Chrome UX Report API, y un plan para manejar las entradas NaN y null de los vacíos de elegibilidad? Si falta cualquiera de las dos, eso es lo siguiente que hay que verificar antes de estimar la construcción.

Dónde aterriza cada opción

Para un equipo pequeño cuya revisión semanal encaja en las seis páginas y los cuatro controles, CrUX Vis es la opción de menor esfuerzo.

Es compartible por URL y se actualiza cada lunes, sin ninguna construcción propia que mantener.

Para un equipo con una pregunta concreta y documentada que el diseño fijo no puede responder, la History API ofrece los mismos datos subyacentes con flexibilidad de presentación.

El costo es una clave de API y tu propio manejo de las ventanas superpuestas y los vacíos de elegibilidad.

La decisión no trata sobre qué herramienta es mejor en abstracto.

Trata sobre si tus preguntas semanales reales encajan en el diseño documentado.

Haz la verificación de cobertura y verifica la disponibilidad de datos en la forma canónica del origin.

Deja que la pregunta concreta sin mapeo, no la personalización por la personalización, impulse la construcción.

Si estás comparando superficies de datos para una construcción de ingeniería, la elección entre la History API y BigQuery se cubre por separado en CrUX History API o BigQuery?

Si la pregunta es cómo fluyen los datos de monitoreo hacia tus sistemas existentes, consulta la entrada del glosario sobre run history.

Explica cómo se registran y revisan las ejecuciones automatizadas de flujos de trabajo.

Referencias de fuente: developer.chrome.com; developer.chrome.com.

Cómo ayuda Meshline.

Conecta automatización, Organic Marketing (generación de demanda) y gestión del ciclo de vida del cliente (Revenue Intelligence).

Lleva la planificación de temas, la publicación de contenido y el feedback de rendimiento a la conversación sobre tu flujo de trabajo. Agenda una demo de Meshline.

Revenue Intel

Consúltanos sobre este flujo de trabajo.

Cuéntanos qué quieres mejorar o automatizar. Te responderemos con el siguiente paso más útil.

Descubre cómo podemos ayudarte

Decisiones de implementación

Lleva esta idea a tu operación

Antes de elegir una solución, define el problema, los datos disponibles y quién revisará el resultado.