Reglas de caché eCDN y purga de caché

donde están disponibles las reglas de caché y la purga de caché

Para configurar las reglas de caché y purgar la caché, en Business Manager, ve a Configuración de CDN | Embebidos de Sitios | de Administración y luego selecciona Configurar Zona para la zona que quieres. Las reglas de caché y el botón de Purgar caché están disponibles en el ámbito de zona para estos tipos de zona.

Cómo difieren las zonas SCAPI

Para las zonas SCAPI, solo está disponible la purga de caché desde la instancia de Producción, y las reglas de caché no se exponen. Este comportamiento es intencional. Hay una zona SCAPI para Desarrollo, Puesta en Escena y Producción. La zona no aparece en Business Manager ni en la API CDN en Desarrollo o Staging. Para la matriz completa de control de zonas SCAPI, véase Soporte de Zonas SCAPI para Comercio B2C.

• El almacenamiento en caché SCAPI es una capacidad gestionada por la plataforma. Para evitar cambios en el comportamiento de almacenamiento en caché SCAPI, el autoservicio de reglas de caché está deshabilitado para estas zonas.
• Los trabajadores de SCAPI establecen etiquetas de caché automáticamente cuando almacenan una respuesta en caché. No defines etiquetas para las zonas SCAPI tú mismo.
• El flujo de invalidación del lado ecom (JWA) sincroniza la invalidación de la caché SCAPI.
• Purga el contenido de la zona SCAPI por etiqueta o por ruta desde la instancia de Producción.

Cómo eCDN decide qué almacenar en caché

Entender la decisión de caché te ayuda a escribir reglas efectivas.

Por defecto, cuando no se configuran reglas de caché, eCDN almacena en caché solo por extensión de archivo. Las extensiones estáticas comunes (imágenes, JS, CSS, fuentes, videos, documentos y archivos) se almacenan en caché. eCDN no almacena en caché respuestas HTML, JSON, XML o TXT por defecto (excepto robots.txt). El tamaño máximo de objeto en caché es de 5 GB.

Una respuesta se almacena en caché solo cuando todas estas condiciones son verdaderas.

• El método de solicitud es GET.
• La respuesta no tiene encabezado Set-Cookie.
• La respuesta tiene Control de caché: público con edad > máxima 0, o una fecha de expiración futura. Cuando hay múltiples valores presentes, la precedencia es s-maxage, luego max-age, y después Expires.

Una respuesta no se guarda en caché si alguna de estas condiciones es cierta.

• Control de caché es privado, sin almacenamiento, sin caché o max-age=0.
• No hay ningún encabezado Cache-Control.
• Hay un encabezado Set-Cookie.
• El método de solicitud no es GET.

Nota Una regla de caché solo hace elegible un tipo de contenido que de otro modo no se puede almacenar en caché (HTML o JSON). Las reglas de encabezado de origen siguen aplicando.

Mejores prácticas

• Almacena en caché HTML y JSON deliberadamente. Haz que el contenido dinámico sea elegible solo cuando la respuesta sea genuinamente compartida entre los compradores y seguro para almacenar en caché. Nunca almacenes en caché respuestas personalizadas o autenticadas. Asegúrate de que esas respuestas lleven Set-Cookie o Cache-Control: private.
• Usa etiquetas de caché para invalidaciones coordinadas. Sella contenido relacionado con etiquetas compartidas (por ejemplo, por producto, categoría o activo de contenido) para que puedas eliminar un grupo lógico en una sola solicitud en lugar de listar rutas.
• Excluye los parámetros de seguimiento de la clave de caché (por ejemplo, gclid y utm_campaign) para maximizar la relación de aciertos de caché.
• Verifica la caché con el encabezado de respuesta Cf-Cache-Status. Un valor de HIT confirma el almacenamiento en caché de borde. Un valor de MISS o DYNAMIC indica que el contenido no fue servido desde la caché.
• Prueba primero en un sandbox. Las zonas predeterminadas de ODS soportan reglas de caché y purga, así que puedes validar el comportamiento de las reglas en un sandbox antes de aplicarlo a producción.

Solución de problemas

¿El contenido no está almacenando en caché como se esperaba? Chequeado, en orden:

1. Encabezados de origen — ¿la respuesta enviando Cache-Control: public, max-age>0 (o un futuro expira)?
2. Set-Cookie — Un encabezado Set-Cookie suprime la caché. Elimínalo para respuestas que puedan ser almacenadas en caché.
3. Método de solicitud — solo GET está almacenado en caché.
4. Precisión de la expresión: ¿la expresión de la regla realmente coincide con la ruta/extensión de la solicitud?
5. ¿Reglas activadas? — confirma que la bandera de Habilitado de la regla está activada.
6. Encabezado CF-Cache-Status — HIT vs MISS/DYNAMIC te indica si el borde se sirvió desde la caché.