Skip to main content

Integração do Ledger com o Proxy

Este documento descreve como funciona a interação do Proxy com o Ledger.

1. Visão Geral​

  • Ledger: No front-end, é gerado um objeto Ledger que fica salvo em um cookie no navegador (ledger).

    • Contém a informação do email do usuário.
    • O front-end é responsável por “criar” e “atualizar” esse ledger.

  • Proxy: No proxy, quando chega uma requisição de um usuário, o middleware webPersonalizationMiddleware verifica se há um cookie ledger.

    • Se encontrar esse cookie, extrai o email para buscar dados adicionais e aplicar regras de personalização de página.
    • Se não houver ledger ou email no cookie, o proxy não consegue buscar dados de segmentação (ex.: score, assinaturas) e só aplica personalizações marcadas como “geral”.

2. Passo a Passo de Execução​

  1. Usuário navega no rdstation.com

    • Quando o usuário acessa uma página do domínio .rdstation.com, o ledger é iniciado.
    • Esse cookie é gravado no domínio .rdstation.com (ou localhost em ambiente local), ficando disponível para as requisições subsequentes ao proxy.
    • Quando uma página do domínio .rdstation.com é acessada o proxy age como mediador, entregando todo conteúdo.

  2. Usuário acessa uma página que passa pelo Proxy

    • Toda vez que o usuário acessa páginas que rodam pelo proxy, a requisição chega no Cloudflare Worker (ou infraestrutura equivalente) rodando o proxy.

  3. webPersonalizationMiddleware verifica o cookie ledger

    • O middleware faz getCookie(context, 'ledger').
    • Se não existir o cookie:
      • O middleware só personaliza páginas que forem marcadas como “geral” (sem segmentação por email).
      • Se não houver personalização geral, a rota segue para o site original.
    • Se existir o cookie:
      • Ele faz JSON.parse(ledger) e converte no formato Ledger.

  4. Extração do email

    • Do objeto Ledger, o proxy lê ledgerObject.email.
    • Se não houver email, segue como se não houvesse ledger (sem segmentação).
  • A partir daqui tudo acontece do lado do Mantis, onde é possível saber mais clicando aqui.

3. Resumo da Ligação​

  • Front-end (marketing-rdstation-frontend) cria/atualiza o cookie ledger com email e outros detalhes.
  • Proxy (marketing-proxy-br) lê esse cookie, extrai email, e faz consultas internas para decidir se personaliza a página.
  • Nenhum passo do proxy cria ou modifica o ledger — apenas consome.

4. Conclusão​

A integração entre o ledger (marketing-rdstation-frontend) e o proxy (marketing-proxy-br) é essencialmente um fluxo unidirecional:

  1. O front-end grava o ledger no cookie.
  2. O proxy consome o cookie e, se encontrar um email, enriquece os dados com RDSM e Billing para aplicar regras de personalização.
  3. Sem cookie ou sem email, o proxy só consegue aplicar personalizações gerais.

Dessa forma, o ledger serve como “ponto de partida” para identificar o usuário e proporcionar experiências personalizadas.

Leituras relacionadas​