Almacenamiento
Personalización con almacenamiento local
Personalización con almacenamiento local. Estas son las claves que este origen tiene de verdad, qué cambian y los almacenes que este sitio deja vacíos. Con el consentimiento apagado, los registros de visitante y de sesión no se escriben y no se usan para cambiar la página.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Se listan las claves que este origen tiene de verdad, incluido el visitante y la sesión escritos en dos almacenes. El consentimiento apagado deja esos dos sin leer para la personalización, y este laboratorio no envía un evento propio.
Cómo usarlo
- Lee los almacenes que este origen tiene de verdad.
- El visitante y la sesión son dos almacenes distintos.
- El consentimiento apagado se salta esos registros para la personalización.
- Este laboratorio no encola un evento.
Resultado en vivo
Este bloque usa las mismas reglas que la página de inicio. Edita una clave de abajo y se actualiza aquí sin recargar. El consentimiento está apagado, así que esas dos claves no se leen. El hero se queda en el valor predeterminado.
Comprobando este navegador…
localStorage
No hay claves de localStorage en este origen.
site.consent.v1
Valor actual: ausente (se trata como denied). Tamaño 0 B. El banner de consentimiento y el interruptor del menú escriben granted o denied. Esta página no añade otro escritor.
site.consent.choice.v1
Valor actual: ausente (aún no hay elección del banner). Tamaño 0 B. Los campos JSON son choice, chosenAt y version. Una clave ausente sin valor de site.consent.v1 significa que el banner sigue esperando. Cuando se guarda esta versión, el banner permanece cerrado hasta que lo abre Privacidad.
sessionStorage
No hay claves de sessionStorage en esta pestaña.
site.path.v1
sessionStorage para el recorrido web. Los campos son id, sequence, lastPath, auth y scrolls. El id y la sequence se copian en cada evento de primera parte. La clave se escribe solo con el consentimiento encendido y termina cuando termina la pestaña. La personalización no la lee directamente. La página de recorrido lee los eventos a los que pertenecen esos números.
Cookies
Las cookies HttpOnly no están en document.cookie. La lista de abajo es lo que el servidor recibió con la petición de esta página. Recarga después de un beacon con consentimiento si bbp.visitor se acaba de crear. JavaScript puede ver: ningún nombre de cookie. Google Analytics añade _ga y _ga_JDE6BF33RY después de que aceptas. Microsoft Clarity puede añadir _clck y _clsk después de ese mismo Aceptar. _gid puede aparecer durante un día. Consent Mode las deja sin fijar mientras analytics storage está denied, y este sitio no las lee para la personalización.
No se envió ninguna cookie con esta petición. bbp.visitor aparece después de un beacon con consentimiento del Laboratorio de recolección. Las cookies de Auth.js aparecen cuando empiezas el inicio de sesión.
IndexedDB
Pidiendo al navegador los nombres de las bases de datos.
Cuota
Esperando navigator.storage.estimate().
Buenas prácticas
Cómo elige este sitio un almacén, y los límites que siguen aplicando. Los fragmentos son la implementación, no una muestra pegada de otro sitio.
Qué almacén
localStorage guarda el registro de visitante que vuelve y la elección de consentimiento. Ambos deben sobrevivir a la pestaña, y ambos son cadenas que la página puede leer en la visita siguiente. sessionStorage guarda el scroll, los clics y las páginas solo de esta pestaña, más site.path.v1 para el id y la secuencia de la sesión de recorrido. MDN define esa diferencia: localStorage no caduca, y sessionStorage dura la sesión de la página.
Las cookies son para valores que el servidor tiene que ver en la petición siguiente. bbp.visitor se fija con Set-Cookie para que la ruta collect pueda filtrar filas. La cookie de sesión de Auth.js es la sesión iniciada. Ninguna de las dos es una entrada de las reglas de personalización. Google Analytics añade _ga y _ga_JDE6BF33RY desde la página después de que analytics storage esté granted. _gid puede aparecer durante un día. Consent Mode deja esas cookies sin fijar mientras la elección está apagada.
IndexedDB es el sitio adecuado para datos estructurados grandes, archivos y consultas. Este sitio no tiene nada de eso, así que no abre una base de datos. El resumen de almacenamiento de web.dev hace el mismo corte: cookies para valores pequeños enviados al servidor, Web Storage para cadenas pequeñas solo de cliente, IndexedDB cuando los datos son más grandes o estructurados.
export const VISITOR_KEY = "site.visitor.v1" export const SESSION_KEY = "site.session.v1" export const VISITOR_COOKIE = "bbp.visitor"
Nada sensible en Web Storage
localStorage y sessionStorage los puede leer cualquier script del origen. Un token de sesión, un secreto OAuth o una dirección de correo no van ahí. Las cookies de sesión y CSRF de Auth.js son HttpOnly, así que el inventario puede ver que existen y seguir ocultando los valores. El registro de visitante guarda conteos de visitas, rutas y slugs de temas. No guarda un nombre ni un correo.
httpOnly: true, sameSite: "lax", path: "/", secure, maxAge: 60 * 60 * 24 * 400
Nombres, versiones y una migración pequeña
Las claves llevan el prefijo site. o bbp. para que no choquen con otro script del mismo origen. El sufijo .v1 es el esquema. loadVisitor rechaza un valor que no es JSON o no tiene un campo numérico visits, y quien llama lo trata como «sin registro» en lugar de lanzar un error. Un futuro site.visitor.v2 leería v1, escribiría v2 y borraría v1. Este sitio aún no tiene una segunda versión, así que esa migración no está implementada.
const parsed = JSON.parse(raw) as VisitorRecord if (!parsed || typeof parsed.visits !== "number") return null
TTL
Web Storage no tiene un argumento de caducidad. Un TTL es un campo que escribes tú y luego ignoras el registro cuando Date.now() lo supera. site.visitor.v1 y site.consent.v1 no tienen ese campo. site.consent.choice.v1 guarda chosenAt, que es el momento de la elección, no una caducidad. Permanecen hasta que se borran. site.session.v1 termina cuando termina el contexto de navegación de la pestaña, que es el TTL que sessionStorage ya tiene.
Las cookies sí tienen caducidad. bbp.visitor se fija con un Max-Age de 400 días, dentro del tope de 400 días que documenta MDN para la vida de las cookies. El navegador no devuelve Max-Age en peticiones posteriores, así que la tabla de arriba cita al que la escribió. El artículo de ITP 2.1 de WebKit describe un tope de siete días para las cookies creadas con document.cookie. Este sitio no crea sus cookies así.
Tamaño y errores de cuota
MDN documenta QuotaExceededError de setItem cuando el origen supera su cuota. El techo habitual de localStorage es unos 5 MB, y no es un estándar. saveVisitor y saveSession capturan ese fallo y devuelven false. Los editores de esta página lo dicen en lugar de romper el render. navigator.storage.estimate(), cuando el navegador lo ofrece, es la línea de cuota de arriba. web.dev describe esa estimación como el almacenamiento del origen, no una sola clave.
try {
localStorage.setItem(VISITOR_KEY, JSON.stringify(record))
return true
} catch {
return false
}ITP de Safari, particionado y desalojo
Intelligent Tracking Prevention clasifica dominios que pueden rastrear entre sitios y limita el almacenamiento que reciben. El artículo original de WebKit describe borrar los datos de sitios clasificados tras un periodo sin interacción. Un sitio de primera parte que el visitante está usando no es ese caso.
El particionado es aparte. La guía de particionado de estado de MDN y el artículo de cookies de terceros de WebKit describen un almacenamiento con clave del sitio de nivel superior y del origen del frame. Esta página es de nivel superior, así que su localStorage es el cubo propio del origen. El mismo origen dentro del iframe de otro sitio puede tener otro cubo, y puede desalojarse antes. No des por hecho que un frame insertado ve las claves listadas aquí.
Los navegadores también pueden borrar almacenamiento bajo presión. Las cuotas y los criterios de desalojo de MDN son la referencia. Una clave ausente tiene que parecerse a una primera visita.
Consentimiento
La guía de cookies del ICO trata el almacenamiento usado para un fin que el visitante no pidió como algo que necesita consentimiento. Este sitio usa una sola elección para medición y personalización. site.consent.v1 recuerda granted o denied. site.consent.choice.v1 guarda la misma elección con chosenAt y version, que es lo que evita que vuelva el banner. Mientras el consentimiento no es granted, persistActivity no escribe los registros de visitante ni de sesión, la ruta collect devuelve 403 y las reglas no leen el historial de visitas guardado. La única excepción es un consent_change guardado cuando la medición pasa de granted a denied. El campo consent de esa fila es denied. Los editores de arriba siguen la misma regla: guardar sigue desactivado y borrar sigue borrando.
if (consentState === "granted") {
persistActivity({ path, topics, maxScroll, clicks, lastClick })
}Apagar el consentimiento no borra claves escritas antes. Deja de leerlas para la personalización. El inventario sigue listándolas, porque el trabajo de esta página es mostrar qué hay guardado.
Sincronización con la sesión
El registro de localStorage no se sube como un blob. Un beacon con consentimiento ya lleva el perfil del cliente, y el servidor guarda ese perfil bajo bbp.visitor. Al iniciar sesión, y otra vez en la página de cuenta, claimVisitor adjunta las filas que tienen este id de visitante y aún ninguna cuenta. No toma filas que ya pertenezcan a otra persona. La página de cuenta es donde esa persona lee y borra la copia del servidor. Borrar localStorage no borra esas filas. Restablecer mis datos en la página de cookies sí borra las filas sin reclamar de este id anónimo.
.where(and(eq(collectEvents.visitorKey, visitorKey), isNull(collectEvents.userId)))
Hidratación
El servidor no puede ver localStorage. Leerlo durante el primer render de cliente no coincidiría con el HTML y React avisaría. useSyncExternalStore toma una instantánea de servidor: el consentimiento es denied, y la instantánea de personalización es null. La página de inicio renderiza el texto predeterminado y «Comprobando este navegador…». Después de la hidratación se ejecuta la instantánea de cliente, se lee el almacenamiento y el hero se actualiza. Eso es una actualización deliberada después de pintar, no una hidratación despareja. La referencia de React a useSyncExternalStore describe la instantánea de servidor por esta razón.
function getServerSnapshot(): ConsentState {
return "denied"
}Cuando falta el almacenamiento
Las ventanas privadas, el almacenamiento bloqueado y un SecurityError lanzado son el mismo resultado para la personalización: loadVisitor y loadSession devuelven null, y el consentimiento se lee como denied si la lectura lanza. La página se sigue renderizando. Las reglas que necesitaban una visita guardada caen en la hora del día, la URL y el viewport, que no necesitan almacenamiento.
try {
const raw = localStorage.getItem(VISITOR_KEY)
if (!raw) return null
// ...
} catch {
return null
}Fuentes
- MDN: Window.localStorage
- MDN: Window.sessionStorage
- MDN: Document.cookie
- MDN: Uso de cookies HTTP
- MDN: IndexedDB API
- MDN: Cuotas de almacenamiento y desalojo
- MDN: Storage.setItem
- MDN: Particionado de estado
- web.dev: Almacenamiento para la web
- web.dev: Recetas de cookies SameSite
- WebKit: Intelligent Tracking Prevention
- WebKit: Intelligent Tracking Prevention 2.1
- WebKit: Bloqueo total de cookies de terceros y más
- WebKit: Prevención de rastreo en WebKit
- React: useSyncExternalStore
- ICO: Cookies y tecnologías similares
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de almacenamiento lista las claves que este origen tiene de verdad y muestra que, con el consentimiento apagado, los registros de visitante y de sesión no se leen para la personalización. El laboratorio no envía un evento propio y no llama a Adobe.
Leer los almacenes que tiene este origen
El laboratorio recorre localStorage y sessionStorage, lista los nombres de cookies visibles para JavaScript, pide a IndexedDB los nombres de bases y pide a navigator.storage.estimate una cuota. Los valores HttpOnly llegan del render del servidor, con los de sesión y csrf ocultos.
Escribir el visitante y la sesión en dos almacenes
saveVisitor escribe site.visitor.v1 en localStorage. saveSession escribe site.session.v1 en sessionStorage. Un almacén bloqueado devuelve false y no lanza.
Saltarse esos registros cuando el consentimiento está apagado
buildSignals devuelve visitor not_read y un conteo de visitas null cuando el consentimiento no está concedido. Sigue usando la lista de páginas en memoria para esa vista. No carga el visitante ni la sesión almacenados.
No enviar nada desde este laboratorio
StorageLab no llama a trackLabEvent, pushEvent, pushDataLayerEvent ni demonstrateEvent. Editar una clave recarga las señales almacenadas en la página. No encola un evento de analítica.
Del código
El registro de visitante es localStorage. El registro de sesión es sessionStorage.
export function saveVisitor(record: VisitorRecord) {
try {
localStorage.setItem(VISITOR_KEY, JSON.stringify(record))
return true
} catch {
return false
}
}
export function saveSession(record: SessionRecord) {
try {
sessionStorage.setItem(SESSION_KEY, JSON.stringify(record))
return true
} catch {
return false
}
}Con el consentimiento apagado se devuelve not_read y no se carga el visitante almacenado.
if (consentState !== "granted") {
return {
...shared,
visitor: "not_read",
visitCount: null,
pagesViewed: memory.pages,
knownPages: memory.pages,
topicsViewed: memory.topics,
maxScrollDepth: memory.maxScroll,
clickCount: memory.clicks,
lastClick: memory.lastClick,
deepPosts: memory.deepPosts,
pathEvents: 0,
}
}Google y Adobe
Este laboratorio no encola un evento propio. El bloque de Google muestra un ejemplo de cómo rastrearías la interacción. Adobe también es un ejemplo.
Este laboratorio no encola un evento de analítica propio. Después de Aceptar, el sitio sigue encolando virtual_page_view de la página, con page_path y page_title. Los clics dentro de una región data-track-ignore no se registran. El push de abajo es un ejemplo, no una llamada de esta página. Este sitio no llama a gtag('set') ni a Adobe.
Solo ejemplo. Esta página no hace push de este objeto.
// Example only. This lab does not queue this event.
dataLayer.push({
event: "storage_key_example",
key: "site.visitor.v1",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar107, prop107 y event107 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar107 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
storageKey: "site.visitor.v1",
},
},
})Hit de ejemplo. eVar107 tiene alcance de hit en este ejemplo. prop107 muere en el mismo hit.
s.eVar107 = "site.visitor.v1"
s.prop107 = "site.visitor.v1"
s.events = "event107"
s.linkTrackVars = "eVar107,prop107,events"
s.linkTrackEvents = "event107"
s.tl(true, "o", "storage_key_example")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Clave de visitante
GA4. No se envía. site.visitor.v1 se queda en localStorage.
Adobe. eVar107 de ejemplo, expira en la visita si reflejaras el nombre de la clave. No se envía.
Alcance. Un almacén del navegador. No es un parámetro de evento ni un hit.
Clave de sesión
GA4. No se envía. site.session.v1 se queda en sessionStorage.
Adobe. prop107 de ejemplo, que muere en el hit. No se envía.
Alcance. La sesión del navegador. No es una propiedad de usuario en GA4.
Compuerta de consentimiento
GA4. No es un parámetro de este laboratorio. Con el consentimiento apagado, la personalización informa visitor not_read.
Adobe. eVar107 de ejemplo para la palabra not_read. No se envía.
Alcance. Una compuerta del hit. No es una propiedad de usuario.
Valor de la cookie
GA4. No se envía. Los valores de las cookies de sesión y csrf se ocultan antes de llegar a la página.
Adobe. prop107 de ejemplo. No pongas un valor de cookie en una prop. No se envía.
Alcance. Una credencial. No es un evento ni una propiedad de la visita.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…