Passa al contenuto principale

Marcatura da file

Obiettivo​

La marcatura da file è una funzionalità che consente di aggiornare automaticamente i marker associati ai contatti presenti nel database tramite un processo di import giornaliero da file CSV.
L’obiettivo è permettere una marcatura centralizzata, automatizzata e governata dei contatti, supportando in modo flessibile differenti strategie di segmentazione, analisi e controllo, riducendo attività manuali e rischi di errore.
Grazie all’import automatico e alla sovrascrittura controllata dei campi di marker, i dati risultano immediatamente utilizzabili nei processi di segmentazione, indipendentemente dagli altri flussi di integrazione presenti.

Casi d’uso principali​

La funzionalità supporta tre principali esigenze operative e di business:

  • Marcatura per la selezione di target: consente l’identificazione puntuale di specifici segmenti di contatti da includere in campagne, comunicazioni o iniziative dedicate, sulla base di criteri esterni forniti tramite file CSV.
  • Marcatura per l’esclusione di target (Exclusion List): permette di definire liste di esclusione dinamiche per prevenire l’invio di comunicazioni a determinati contatti (ad esempio utenti già coinvolti in altre iniziative, soggetti non idonei o vincoli normativi), senza impattare gli altri dati presenti nel database.
  • Marcatura per la creazione di gruppi di controllo: supporta la creazione e la gestione di control group per analisi sperimentali e di performance (es. A/B test, misurazione dell’incrementalità delle campagne), garantendo la tracciabilità nel tempo dei contatti appartenenti a tali gruppi.

Descrizione generale​

Il sistema esegue con cadenza giornaliera un processo di import che legge un file CSV denominato marker.csv e aggiorna sui contatti presenti nel database i seguenti campi:

  • marker1 (string)
  • marker1_date (date)

L’import opera esclusivamente sui contatti presenti nel file e identificati tramite una chiave di matching configurabile.

Configurazione tecnica​

Sorgente file​

  • Accesso a uno spazio SFTP dedicato, fornito e gestito da Contactlab
  • Presenza di una folder dedicata all’import
  • Nome file obbligatorio: marker.csv

Parametri di parsing​

Configurabili dal team Contactlab:

  • Separatore di campo (es. ;, ,)
  • Delimitatore di campo (es. ")

Chiave di matching​

La chiave utilizzata per identificare il contatto nel database è configurabile e può assumere uno dei seguenti valori:

  • intId
  • id
  • base.contacts.email
  • base.contacts.phone
  • base.contacts.mobilePhone

Struttura del file​

Il file CSV deve contenere esattamente 3 campi, nel seguente ordine:

  1. Campo chiave di matching configurato
  2. marker1 (string)
  3. marker1_date (date, nel formato YYYY-MM-DD)

Comportamento del caricamento​

Il processo di import segue le seguenti regole:

  • Vengono aggiornati esclusivamente i contatti presenti nel file CSV per i quali viene trovato un match valido sulla chiave configurata.
  • I contatti presenti nel database ma non inclusi nel file CSV non vengono modificati (eventuali marcature precedenti vengono mantenute).
  • I valori presenti nel CSV per i campi:
    • marker1
    • marker1_date
      sovrascrivono sempre i valori esistenti nel database, inclusi valori vuoti o null.
  • In assenza del file giornaliero marker.csv, nessuna modifica viene applicata e i campi marker1 e marker1_date rimangono invariati.

Reporting e monitoraggio​

Al termine di ogni esecuzione, l’esito dell’import è consultabile nell’interfaccia della piattaforma, dalla sezione:

Segmenti > Monitor

Per ciascun import vengono mostrati i seguenti indicatori:

  • Totale righe processate
  • Totale contatti aggiornati
  • Totale errori riscontrati

Questo consente un monitoraggio puntuale della qualità e dell’effettiva applicazione dei dati importati.

Caricamento marcatura contatti

Gestione e pulizia dei marker​

È disponibile una funzione di gestione manuale accessibile agli utenti con ruolo Admin, raggiungibile dalla sezione:

Impostazioni > Segmenti > Marcatori

Da questa sezione è possibile:

  • Svuotare tutti i campi marker per l’intero database
  • Svuotare uno specifico marker selezionato

Questa funzionalità consente rapide operazioni di reset o pulizia in caso di necessità operative o di riallineamento dei dati. Svuota campi marcatura contatti.