Règles de cache eCDN et purge du cache

Où les règles de cache et la purge du cache sont-elles disponibles ?

Pour configurer les règles de cache et purger le cache, dans Business Manager, accédez à Administration | Sites | Paramètres de CDN intégré, puis sélectionnez Configurer la zone pour la zone souhaitée. Les règles de cache et le bouton Purger le cache sont disponibles dans l’étendue de la zone pour ces types de zone.

En quoi les zones SCAPI diffèrent-elles ?

Pour les zones SCAPI, seule la purge du cache est disponible à partir de l’instance Production, et les règles de cache ne sont pas exposées. Ce comportement est intentionnel. Il existe une zone SCAPI pour le développement, l’instance Staging et la production. La zone n’apparaît pas dans Business Manager ni dans l’API CDN en développement ou en stading. Pour obtenir la matrice de contrôle de zone SCAPI complète, reportez-vous à la section Prise en charge des zones SCAPI pour B2C Commerce.

• La mise en cache SCAPI est une fonctionnalité gérée par la plateforme. Pour empêcher toute modification du comportement de mise en cache SCAPI, le libre-service des règles de cache est désactivé pour ces zones.
• Les workers SCAPI définissent automatiquement les balises de cache lorsqu’ils mettent une réponse en cache. Vous ne définissez pas vous-même de balises pour les zones SCAPI.
• Le flux d’invalidation côté ecom (JWA) synchronise l’invalidation du cache SCAPI.
• Purgez le contenu de la zone SCAPI par balise ou par chemin à partir de l’instance Production.

Comment l’eCDN décide des éléments à mettre en cache

Comprendre la décision de mise en cache vous aide à rédiger des règles efficaces.

Par défaut, lorsqu’aucune règle de cache n’est configurée, l’eCDN met en cache uniquement par extension de fichier. Les extensions statiques courantes (images, JS, CSS, polices, vidéos, documents et archives) sont mises en cache. L’eCDN ne met pas en cache les réponses HTML, JSON, XML ou TXT par défaut (sauf robots.txt). La taille maximale des objets pouvant être mis en cache est de 5 Go.

Une réponse n’est mise en cache que lorsque toutes ces conditions sont remplies.

• La méthode de requête est GET.
• La réponse n’a pas d’en-tête Set-Cookie.
• La réponse a Cache-Control : public avec max-age > 0, ou une date d’expiration future. Lorsque plusieurs valeurs sont présentes, la priorité est s-maxage, puis max-age, puis Expires.

Une réponse n’est pas mise en cache si l’une de ces conditions est remplie.

• Cache-Control est privé, no-store, no-cache ou max-age=0.
• Aucun en-tête Cache-Control n’est présent.
• Un en-tête Set-Cookie est présent.
• La méthode request n’est pas GET.

Remarque Une règle de cache ne rend éligible qu’un type de contenu (HTML ou JSON) qui ne peut pas être mis en cache. Les règles d’en-tête d’origine s’appliquent toujours.

Meilleures pratiques

• Mettez délibérément en cache HTML et JSON. Ne rendez le contenu dynamique éligible que si la réponse est réellement partagée entre les acheteurs et qu’elle peut être mise en cache en toute sécurité. Ne mettez jamais en cache les réponses personnalisées ou authentifiées. Assurez-vous que ces réponses portent Set-Cookie ou Cache-Control : private.
• Utilisez des balises de cache pour une invalidation coordonnée. Tamponnez le contenu associé à l’aide de balises partagées (par exemple, par produit, catégorie ou élément de contenu) afin de pouvoir purger un groupe logique en une seule requête au lieu de répertorier les chemins d’accès.
• Excluez les paramètres de suivi de la clé de cache (par exemple, gclid et utm_campaign) pour maximiser le taux de réussite du cache.
• Vérifiez la mise en cache à l’aide de l’en-tête de réponse Cf-Cache-Status. La valeur HIT confirme la mise en cache des bords. La valeur MISS ou DYNAMIC indique que le contenu n’a pas été diffusé à partir du cache.
• Testez d’abord dans une sandbox. Les zones par défaut ODS prennent en charge les règles de cache et de purge, ce qui vous permet de valider le comportement des règles sur une sandbox avant de l’appliquer à la production.

Dépannage

Le contenu n’est pas mis en cache comme prévu ? Vérifiez, dans l’ordre :

1. En-têtes d’origine : la réponse envoie-t-elle Cache-Control : public, max-age>0 (ou un futur Expires ?
2. Set-Cookie — un en-tête Set-Cookie supprime la mise en cache. Supprimez-le pour les réponses pouvant être mises en cache.
3. Request method — seul GET est mis en cache.
4. Précision de l’expression : l’expression de la règle correspond-elle réellement au chemin/à l’extension de la requête ?
5. Règle activée ? — confirmez que l’indicateur Activé de la règle est activé.
6. En-tête Cf-Cache-Status: HIT vs MISS/DYNAMIC vous indique si le dispositif Edge a servi à partir du cache.