Happy V – app Shopify su misura

L'attribuzione marketing e l'automazione del ciclo di vita del cliente di Happy V giravano su una datata applicazione web condivisa basata su SQL Server, insieme a una serie di utility da console scollegate tra loro ed eseguite manualmente. L'impianto era difficile da gestire, non offriva alcuna visibilità sugli errori e non poteva crescere insieme al marchio.

Abbiamo progettato e realizzato un'applicazione integrata Shopify dedicata che consolida ogni integrazione e ogni flusso di back office in un unico sistema osservabile - e abbiamo migrato su di essa l'intera operatività senza interruzioni del traffico live.

La sfida

• I dati di attribuzione marketing (oltre 500.000 record) risiedevano su un SQL Server legacy condiviso con sistemi non correlati.
• Gli eventi di conversione inviati alla customer data platform perdevano spesso gli identificativi di clic, riducendo l'accuratezza dei report delle piattaforme pubblicitarie e del retargeting.
• Processi aziendali come il tagging promozionale e la generazione degli sconti per i professionisti venivano eseguiti a mano tramite applicazioni da console.
• Non esistevano log, né un meccanismo di ripetizione, né un modo per sapere se un webhook in ingresso fosse stato effettivamente elaborato.

Cosa abbiamo realizzato

Un'applicazione integrata Shopify (API .NET 8 + interfaccia di amministrazione React Router 7) organizzata in moduli autonomi, ciascuno con la propria interfaccia operativa:

• Attribuzione marketing - un endpoint pubblico di acquisizione registra gli identificativi di clic (Meta, Google, TikTok) al checkout e arricchisce ogni conversione inviata a Twilio Segment, con un visualizzatore ricercabile sull'intero set di dati.
• Pipeline di conversione - i webhook di Shopify e Recharge generano eventi Order Completed arricchiti, con la garanzia rigorosa di una sola conversione per ordine.
• Programma di campionatura - Shopify Flow avvisa l'app quando un cliente riceve un campione di prodotto; l'app lo registra e invia a Klaviyo proprietà di profilo ed eventi personalizzati per attivare i flussi di follow-up.
• Tagging degli acquirenti promozionali - analizza gli ordini effettuati durante le promozioni automatiche e applica un tag cliente dedicato per ogni campagna.
• Sconti per i professionisti - legge un Google Sheet, genera codici sconto univoci per ciascun professionista e li crea in blocco su Shopify, con un'anteprima paginata prima dell'esecuzione.
• Integrazione con gli affiliati - riconciliazione delle conversioni di Refersion e ShareASale, con annullamento automatico in caso di rimborso e controllo dei segnali di frode sulle iscrizioni degli affiliati.
• Strumenti operativi - un log applicativo condiviso, un tracciatore di utilizzo degli endpoint che mostra quali integrazioni sono realmente in uso e un ispettore dei webhook con riesecuzione manuale.

Aspetti tecnici salienti

• Migrazione dei dati senza interruzioni - oltre 550.000 record di attribuzione spostati da SQL Server a PostgreSQL, seguiti da una migrazione delta al momento del passaggio, così nessun record acquisito durante la transizione è andato perso.
• Elaborazione durevole dei webhook - i webhook in ingresso vengono resi persistenti immediatamente ed elaborati da un worker in background con concorrenza limitata, ripetizioni con backoff esponenziale e chiavi di idempotenza. Nulla va perso tra riavvii e distribuzioni e i picchi di traffico non possono sovraccaricare il servizio.
• Unione delle attribuzioni - gli identificativi di clic vengono consolidati tra i checkout di uno stesso cliente, così una conversione non viene mai riportata con un campo vuoto quando il valore era stato acquisito in una visita precedente, migliorando in modo sensibile i tassi di corrispondenza delle piattaforme pubblicitarie.
• Ottimizzazione delle prestazioni - il profiling del sistema in produzione ha individuato uno strato di accesso ai dati che materializzava intere tabelle in memoria. La riscrittura dei percorsi critici con SQL lato server ha ridotto l'occupazione di memoria dell'applicazione da 1,7 GB a 175 MB e ha eliminato i timeout delle richieste sotto carico di produzione.
• Passaggio progressivo - ogni endpoint di integrazione rispecchia il proprio percorso legacy, quindi migrare ciascun provider di webhook è stato un semplice cambio di host, eseguito e verificato un'integrazione alla volta.

Risultato

Happy V gestisce ora l'intero stack di attribuzione marketing e automazione del ciclo di vita su un'unica piattaforma manutenibile. Le procedure manuali da console sono diventate schermate di amministrazione self-service, gli errori di integrazione sono visibili e ripetibili anziché silenziosi e la dipendenza dal SQL Server legacy è stata dismessa. La copertura dell'attribuzione è migliorata in modo misurabile grazie all'unione degli identificativi di clic e all'eliminazione degli eventi webhook persi.