Respostas de Conteúdo conectado em cache

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

O que é e o que não é armazenado

• Corpo da resposta do Conteúdo conectado: Não é armazenado permanentemente pela Braze. Pode ser mantido temporariamente em 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: Metadados da solicitação, como a URL totalmente renderizada, o código de status HTTP e a 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 em 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 mensagem 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 provedor, como e-mail, SMS e push. Canais entregues via 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 de uma mensagem quando ela está sendo preparada para entrega.
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 de múltiplas camadas. Se não existir valor em cache (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 provedor, a mensagem renderizada é enviada ao provedor do canal e depois ao usuário. Para canais entregues via 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 é mostrado ao usuário.

Onde as respostas de Conteúdo conectado podem existir temporariamente

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

• Cache em memória do processo: Cache transitório dentro do processo do worker. Os dados existem apenas durante a execução do job (até ~11 minutos com base no timeout do worker).
• Cache local da máquina: Um cache por worker, como uma instância local do Memcached.
• Cache do cluster: Um cache distribuído compartilhado entre workers, como um cluster 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 existe apenas na memória do processo do worker durante a execução do job 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 Invalidação de cache.

Onde a saída final renderizada pode existir

• Arquivamento de mensagem: Se o Arquivamento de mensagem estiver ativado, a Braze pode gravar a mensagem final renderizada no bucket de armazenamento em nuvem configurado. Se a resposta do 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 da mensagem totalmente renderizada pode persistir nos dispositivos dos usuários por um período 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.