Respostas de Conteúdo conectado em cache

Esta seção fornece uma visão mais detalhada, de ponta a ponta, de como a Braze renderiza Liquid e Conteúdo conectado e onde os dados podem existir temporariamente antes que uma mensagem seja enviada. Isso pode ajudar em revisões de privacidade e tratamento de dados.

O que é e o que não é armazenado

• Corpo da resposta de Conteúdo conectado: Não é armazenado permanentemente pela Braze. Pode ser mantido temporariamente na memória e, quando o cache está ativado, armazenado em cache com um tempo de vida (TTL).
• Metadados da solicitação de Conteúdo conectado: Os metadados da solicitação, como a URL totalmente renderizada, código de status HTTP e duração da resposta, são registrados para solução de problemas e monitoramento. Esses registros são mantidos por até 30 dias.
• Mensagem final renderizada: Existe na memória durante a renderização. Também pode ser armazenada em outro lugar, dependendo da sua configuração e canal (por exemplo, Arquivamento de Mensagens ou Cartões de conteúdo).

Fluxo de renderização (visão geral)

O fluxo a seguir descreve como a Braze renderiza e envia mensagens para canais baseados em provedores, como e-mail, SMS e push. Canais entregues pelo SDK, como Cartões de conteúdo, usam a mesma renderização subjacente de Liquid e Conteúdo conectado, mas diferem em quando o conteúdo é gerado e como é entregue.

1. Um worker em segundo plano renderiza o modelo Liquid para uma mensagem quando ela está preparada para ser entregue.
2. As tags de Conteúdo conectado são avaliadas durante a renderização do Liquid.
3. Para cada tag de Conteúdo conectado, a Braze verifica um cache em múltiplas camadas. Se nenhum valor em cache existir (ou se o cache estiver desativado), a Braze chama seu endpoint e recebe a resposta.
4. A resposta é injetada no modelo Liquid e a mensagem é totalmente renderizada.
5. Para canais baseados em provedores, a mensagem renderizada é enviada ao provedor do canal e, em seguida, ao usuário. Para canais entregues pelo SDK, como Cartões de conteúdo, o conteúdo renderizado é sincronizado com o SDK da Braze e pode ser gerado na primeira impressão ou no momento da exibição, quando então é mostrado ao usuário.

Onde as respostas de Conteúdo conectado podem existir temporariamente

A Braze usa um cache em múltiplas camadas para respostas de Conteúdo conectado com TTLs entre cinco minutos e quatro horas, dependendo do seu uso de :cache_max_age e outras regras de cache:

• Cache de memória em processo: Cache transitório dentro do processo do worker. Os dados existem apenas durante a duração do trabalho (até ~11 minutos com base no tempo limite do worker).
• Cache local da máquina: Um cache por worker, como uma instância local do Memcached.
• Cache em cluster: Um cache distribuído compartilhado entre workers, como um cluster do Memcached.

Essas camadas de cache são voláteis e podem remover dados antes do TTL configurado.

O que muda quando você usa :no_cache

Para endpoints que não estão hospedados dentro da infraestrutura da Braze, usar :no_cache impede que o corpo da resposta do Conteúdo conectado seja armazenado no Memcached. Nesses casos, a resposta só existe na memória do processo do worker durante a duração do trabalho de renderização (até ~11 minutos). Para endpoints que resolvem para hosts internos da Braze, as respostas ainda podem ser armazenadas em cache conforme descrito em Cache busting.

Onde a saída final renderizada pode existir

• Arquivamento de Mensagens: Se o Arquivamento de Mensagens estiver ativado, a Braze pode gravar a mensagem final renderizada no seu bucket de armazenamento em nuvem configurado. Se sua resposta de Conteúdo conectado estiver incluída na mensagem renderizada, ela será incluída na cópia arquivada.
• Dispositivos dos usuários: Após a entrega, o conteúdo totalmente renderizado da mensagem pode persistir nos dispositivos dos usuários por um tempo indeterminado.
• Cartões de conteúdo: O conteúdo renderizado para Cartões de conteúdo é armazenado em um banco de dados da Braze até que o cartão expire.