Mise en cache des réponses du contenu connecté

Les réponses au contenu connecté peuvent être mises en cache dans différentes campagnes ou messages (dans le même espace de travail) afin d’optimiser les vitesses d’envoi.

Braze n’enregistre ni ne stocke en permanence les réponses au contenu connecté. Si vous choisissez explicitement de stocker une réponse à un appel de contenu connecté en tant que variable Liquid, Braze ne la stocke qu’en mémoire, c’est-à-dire sur un stockage temporaire qui est supprimé après un court laps de temps, pour effectuer le rendu de la variable Liquid et envoyer le message.

Pour empêcher la mise en cache, vous pouvez spécifier :no_cache, ce qui peut entraîner une augmentation du trafic réseau. Pour faciliter la résolution des problèmes et le suivi de l’état du système, Braze peut également enregistrer les appels au contenu connecté qui échouent (tels que 404 et 429). Ces journaux sont conservés jusqu’à 30 jours.

Paramètres de cache par défaut

L’âge du cache peut aller jusqu’à cinq minutes (300 secondes). Vous pouvez le mettre à jour en ajoutant le paramètre :cache_max_age à l’appel de contenu connecté. Voici un exemple :

1
{{ {% connected_content [https://example.com/webservice.json] :cache_max_age 900 %}}}

Les demandes GET sont mises en cache. Vous pouvez configurer cela en ajoutant le paramètre :no_cache à l’appel Contenu connecté.

Les requêtes POST ne sont pas mises en cache. Vous pouvez forcer ce paramètre en ajoutant le paramètre :cache_max_age à l’appel du contenu connecté. La durée minimale du cache est de 5 minutes et la durée maximale de 4 heures.

Limite de la taille du cache

Le corps de la réponse au contenu connecté peut atteindre 1 Mo. Si le corps de la réponse est supérieur à 1 Mo, il ne sera pas mis en cache.

Temps cache

Le contenu connecté met en cache la valeur renvoyée par les endpoints GET pendant au moins cinq minutes. Si aucune durée de cache n’est spécifiée, la durée de cache par défaut est de cinq minutes.

Le temps de cache du contenu connecté peut être configuré pour être plus long avec :cache_max_age, comme le montre l’exemple suivant. La durée minimale du cache est de cinq minutes et la durée maximale de quatre heures. Les données de contenu connecté sont mises en cache en mémoire à l’aide d’un système de cache volatil, tel que Memcached.

Par conséquent, quelle que soit la durée de mise en cache spécifiée, les données de contenu connecté peuvent être expulsées du cache en mémoire de Braze plus tôt que prévu. Cela signifie que les durées de cache sont des suggestions et qu’elles ne représentent pas réellement la durée pendant laquelle les données sont garanties à être mises en cache par Braze et que vous pouvez voir plus de requêtes de contenu connecté que vous ne pouvez attendre avec une durée de cache donnée.

Cache pour les secondes spécifiées

Cet exemple se cache pendant 900 secondes (ou 15 minutes).

1
{% connected_content https://example.com/webservice.json :cache_max_age 900 %}

Mise en cache du cache

Pour empêcher le contenu connecté de mettre en cache la valeur qu’il renvoie à partir d’une demande GET, vous pouvez utiliser la configuration :no_cache. Toutefois, les réponses provenant d’hôtes internes à Braze seront toujours mises en cache.

1
{% connected_content https://example.com/webservice.json :no_cache %}

Avec un POST, vous n’avez pas besoin de mettre le buste en cache, car Braze ne met jamais en cache les résultats des requêtes POST.

Choses à savoir

• La mise en cache peut contribuer à réduire les appels au contenu connecté en double. Cependant, il n’est pas garanti qu’il en résulte toujours un seul appel au contenu connecté par utilisateur.
• La mise en cache du contenu connecté est basée sur l’URL et l’espace de travail. Si l’appel au contenu connecté se fait vers l’URL identique, il peut être mis en cache à travers les campagnes et les Canvas.
• Le cache est basé sur une URL unique, et non sur un ID d’utilisateur ou une campagne. Cela signifie que la version mise en cache d’un appel au contenu connecté peut être utilisée par plusieurs utilisateurs et campagnes dans un espace de travail si l’URL est la même.