Le Proprietà personalizzate memorizzano i dati di contatto in modo permanente e operano su tutte le campagne e le automazioni. I Custom fields si collegano agli eventi e sono disponibili solo nelle automazioni attivate da tali eventi.
Continua a leggere per saperne di più sulle differenze chiave tra custom properties e custom fields.
Custom Properties
Custom Properties sono campi dati memorizzati in ogni profilo del contatto. Esempi includono punti fedeltà, livelli di iscrizione o qualsiasi altro dettaglio unico per quel contatto.
Puoi raccogliere custom properties tramite:
Moduli di iscrizione: aggiungi campi personalizzati (ad es. interessi) ai tuoi moduli. Quando i contatti inviano il modulo, le loro risposte vengono salvate come custom properties.
Inserimento manuale: vai a Audience → Contatti, aprire un contatto e fare clic su Modifica Contatto per aggiungere o aggiornare manualmente le proprietà personalizzate.
Importazione contatti: Carica un file CSV con le email dei contatti e colonne di dati aggiuntivi. Omnisend mappa ogni colonna a una proprietà personalizzata durante l'importazione.
API o integrazioni: le app di terze parti (ad es. programmi fedeltà, CRM, piattaforme e-commerce) possono passare proprietà personalizzate tramite API quando i contatti vengono creati o aggiornati.
Individuazione delle Custom Properties
Per visualizzare le proprietà personalizzate, vai a Audience → Contatti, cerca il contatto per Email o numero di telefono, clicca per aprire il profilo e trova la sezione Proprietà Personalizzate nel menu a sinistra.
Utilizzo delle Custom Properties
Poiché le proprietà personalizzate vengono salvate direttamente nel profilo del contatto, è possibile utilizzarle per:
Personalizza il contenuto del messaggionelle campagne e nelle automazioni;
Crea Audience segmenti basato su dati personali del contatto
💡 Se un'app di terze parti passa dati di proprietà personalizzata tramite l'API, puoi rivedere il payload della richiesta in Impostazioni Negozio → API → Registri API.
Custom Fields
Custom fields(chiamate proprietà evento nella documentazione API)sono dati specifici dell'evento passati con Custom events. Descrivono i dettagli di un'azione specifica, come un numero di tracciamento, il nome di un prodotto o una data/ora dell'evento.
Pensala in questo modo:
Un evento personalizzato è l'azione stessa (ad es., Ordine Spedito, Webinar Registrato, Recensione Inviata).
I campi personalizzati sono i dettagli relativi a quella specifica istanza dell'azione (ad esempio, quale prodotto è stato spedito, quale webinar, quale tipo di recensione).
Esempio:
Quando il tuo Negozio invia unReview Submitted evento a Omnisend, potrebbe includere i seguenti custom fields:
rating:"3 stelle"productId:"1Z999AA10123456784"commento:"questo prodotto è stato fantastico!"reviewDate:"2026-01-20"
Questi dettagli si applicano solo a quella singola recensione per quel contatto specifico in quel momento.
Nota: in Documentazione API, i campi personalizzati sono indicati come "proprietà dell'evento." Una volta sincronizzati con Omnisend, appaiono nell'interfaccia utente del prodotto come "custom fields." Entrambi i termini descrivono gli stessi dati: i dettagli specifici dell'evento passati con ogni custom event.
Individuazione dei Custom Fields
È possibile rivedere quali campi personalizzati vengono passati con ogni evento personalizzato andando su Impostazioni Negozio → API → Eventi Personalizzati. Questa sezione mostra una lista completa dei tuoi eventi personalizzati insieme ai campi personalizzati inclusi in ciascuno di essi.
A differenza delle proprietà personalizzate, i campi personalizzati non sono salvati in modo permanente nel profilo del contatto.
Per visualizzarli, aprire il profilo del contatto, selezionare l'evento dal menu a discesa inattività del contatto. Clicca sui tre puntini() accanto all'evento, quindi seleziona Event details. Questa visualizzazione mostra tutti i dati passati con quello specifico custom event.
Utilizzo dei Custom Fields
I campi personalizzati possono essere utilizzati in diversi modi all'interno delle automazioni e della segmentazione:
Filtri del Trigger del Flusso automatizzato - Dopo aver selezionato un evento personalizzato come Trigger nel tuo Flusso, i campi personalizzati disponibili appariranno in filtri trigger menu a discesa.
Regole di divisione del flusso automatizzato - Usa campi personalizzati per creare blocchi divisi nel tuo flusso.
Personalizzazione del messaggio nelle automazioni - I campi personalizzati possono essere inseriti nei messaggi utilizzando personalizzazione tag (ad esempio,
[[event.trackingNumber]]). Questo si applica asolo flussi di lavoro automatizzati, non campagne.
Segments - Dopo aver selezionato l'evento personalizzato come filtro principale nel tuo segmento, i campi personalizzati diventano disponibili come subfilters.
Aspetti chiave
Custom properties e custom fields possono sembrare simili, ma servono a scopi molto diversi all'interno di Omnisend. Ecco cosa devi sapere:
Sia le custom properties che i custom fields possono essere utilizzati nel contenuto del messaggio tramite il Personalizzazione menu nei flussi automatizzati. Tuttavia, solo custom properties possono essere utilizzate nelle campagne.
I Custom fields sono legati allo specifico custom event con cui vengono passati. Sono temporanei, si applicano solo al momento in cui l'evento viene attivato e sono disponibile solo all'interno del flusso automatizzato attivato da quell'evento.
Non puoi utilizzare i campi personalizzati come regole di segmento autonome. Possono essere utilizzati solo come subfilters all'interno di una condizione di custom event quando si creano i segmenti.
Le Custom properties sono memorizzate e permanentementevisibile nel profilo del contatto. Possono essere modificati manualmente, importati o aggiornati tramite moduli, API o integrazioni.
I Custom fields sono non visibili nella scheda del contatto a meno che non si aprano i dettagli dell'evento dalla cronologia delle attività del contatto.
FAQ
Posso usare i custom fields nelle campagne?
No. I Custom fields sono disponibili solo nelle automazioni attivate dal custom event che li passa.
Dove posso vedere quali custom fields esistono?
Vai a Store Settings API Custom events. Clicca su un evento per visualizzare i suoi custom fields.
Se avete ancora domande o avete bisogno di assistenza, vi preghiamo di contattarci a [email protected] o tramite chat in-app.