Happy V – aplicação Shopify à medida

A atribuição de marketing e a automação do ciclo de vida do cliente da Happy V corriam numa aplicação web partilhada e envelhecida, assente em SQL Server, a par de um conjunto de utilitários de consola desligados entre si que eram executados manualmente. A configuração era difícil de operar, não oferecia visibilidade sobre as falhas e não conseguia acompanhar o crescimento da marca.

Concebemos e entregámos uma aplicação incorporada Shopify dedicada, que consolida todas as integrações e fluxos de trabalho de back-office num único sistema observável - e migrámos toda a operação para essa aplicação sem qualquer interrupção do tráfego em produção.

O desafio

• Os dados de atribuição de marketing (mais de 500.000 registos) estavam num SQL Server antigo, partilhado com sistemas sem relação com estes.
• Os eventos de conversão enviados para a plataforma de dados de clientes perdiam frequentemente os identificadores de clique, degradando a exatidão dos relatórios das plataformas de anúncios e do retargeting.
• Processos de negócio como a marcação promocional e a geração de descontos para profissionais eram executados à mão através de aplicações de consola.
• Não havia registo de eventos, nem mecanismo de repetição, nem forma de saber se um webhook recebido tinha efetivamente sido processado.

O que construímos

Uma aplicação incorporada Shopify (API em .NET 8 + interface de administração em React Router 7) organizada em módulos autónomos, cada um com a sua própria interface operacional:

• Atribuição de marketing - um endpoint público de captura regista os identificadores de clique (Meta, Google, TikTok) na finalização da compra e enriquece todas as conversões enviadas para o Twilio Segment, com um visualizador pesquisável sobre a totalidade dos dados.
• Pipeline de conversões - os webhooks do Shopify e do Recharge geram eventos Order Completed enriquecidos, com garantias estritas de uma única conversão por encomenda.
• Programa de amostras - o Shopify Flow notifica a aplicação quando um cliente recebe uma amostra de produto; a aplicação regista-a e envia propriedades de perfil e eventos personalizados para o Klaviyo, para acionar fluxos de seguimento.
• Marcação de compradores promocionais - analisa as encomendas efetuadas durante promoções automáticas e aplica uma etiqueta de cliente dedicada por campanha.
• Descontos para profissionais - lê um Google Sheet, gera códigos de desconto únicos por profissional e cria-os em massa no Shopify, com uma pré-visualização paginada antes da execução.
• Integração de afiliados - reconciliação de conversões da Refersion e da ShareASale, incluindo o cancelamento automático em caso de reembolso e a análise de sinais de fraude nas inscrições de afiliados.
• Ferramentas de operações - um registo de aplicação partilhado, um monitor de utilização de endpoints que mostra quais as integrações realmente em uso, e um inspetor de webhooks com repetição manual.

Destaques de engenharia

• Migração de dados sem tempo de inatividade - mais de 550.000 registos de atribuição movidos de SQL Server para PostgreSQL, seguidos de uma migração diferencial no momento da transição, para que nenhum registo capturado durante a passagem se perdesse.
• Processamento durável de webhooks - os webhooks recebidos são persistidos de imediato e processados por um worker em segundo plano com concorrência limitada, repetições com recuo exponencial e chaves de idempotência. Nada se perde em reinícios ou implementações, e os picos de tráfego não conseguem sobrecarregar o serviço.
• Fusão de atribuição - os identificadores de clique são consolidados entre as várias finalizações de compra de um cliente, para que uma conversão nunca seja reportada com um campo vazio quando o valor foi capturado numa visita anterior, melhorando de forma significativa as taxas de correspondência das plataformas de anúncios.
• Engenharia de desempenho - a análise do sistema em produção identificou uma camada de acesso a dados que materializava tabelas inteiras em memória. A reescrita dos caminhos críticos para SQL executado no servidor reduziu a utilização de memória da aplicação de 1,7 GB para 175 MB e eliminou os tempos limite dos pedidos sob carga de produção.
• Transição progressiva - cada endpoint de integração espelha o respetivo caminho antigo, pelo que migrar cada fornecedor de webhooks foi uma simples alteração de host, executada e verificada uma integração de cada vez.

Resultado

A Happy V executa agora toda a sua infraestrutura de atribuição de marketing e de automação do ciclo de vida numa única plataforma que é possível manter. Os procedimentos manuais de consola passaram a ecrãs de administração de autosserviço, as falhas de integração são visíveis e repetíveis em vez de silenciosas, e a dependência do antigo SQL Server foi desativada. A cobertura de atribuição melhorou de forma mensurável através da fusão dos identificadores de clique e da eliminação de eventos de webhook perdidos.