Puoi importare eventi di prodotto in Positive User da un file CSV o XLSX per aggiungere più record in modo più rapido ed efficiente. Questo ti permette di evitare la configurazione manuale e di portare più facilmente dati strutturati sugli eventi nella piattaforma. In questo articolo scoprirai come preparare il tuo file e importare correttamente gli eventi di prodotto.
Prima di iniziare, assicurati che il tuo file sia strutturato correttamente e di aver compreso come i dati vengono archiviati in Positive User. La piattaforma utilizza sia campi standard (campi predefiniti come indirizzo email o numero di telefono) sia campi personalizzati (campi che crei tu stesso).
Origine dei prodotti: definisci una strategia di gestione dei prodotti: come devono essere creati i nuovi prodotti nell'app, come vuoi aggiornarli e inviare nuove occorrenze di eventi di prodotto.
Tipi di eventi di prodotto: consulta l'elenco dei tipi di eventi di prodotto disponibili in questo articolo. Nessun altro tipo può essere importato nel workspace.
Corrispondenza con i campi standard: se le colonne del tuo foglio di calcolo corrispondono ai campi standard, puoi importare il file immediatamente.
Crea campi personalizzati: se vuoi includere informazioni aggiuntive non supportate di default, dovrai prima creare i campi personalizzati corrispondenti. Segui i passaggi in "Come creare un campo personalizzato".
Verifica i tipi di dati: assicurati che ogni colonna abbia il tipo di valore del campo corretto. Ad esempio, se vuoi importare "Scoring", assicurati che il tuo campo sia un intero. Se vuoi importare una "Data", imposta il campo come datetime. Consulta "Cos'è un campo" per i dettagli sui tipi di dati specifici.
Prima di caricarlo, assicurati che il tuo file sia formattato correttamente. Se non sei sicuro di come debba apparire il tuo file, puoi scaricare un modello pronto all'uso direttamente dall'app cliccando sul pulsante "xlsx" o "csv" nella sezione "Data" → "Import".
Per trovare altri consigli sulla formattazione dei dati, consulta il nostro articolo dedicato.
Campi obbligatori
Importare eventi di prodotto significa caricare occorrenze specifiche di eventi di prodotto su due cronologie: quella del contatto che li ha eseguiti e quella del prodotto con cui è avvenuta l'interazione. (Ad esempio, la cronologia degli acquisti di un prodotto specifico). Per questo motivo è obbligatorio collegare ogni occorrenza a un contatto specifico e a un prodotto specifico. Ciò può essere fatto tramite "user_id"/"email" del contatto e "product_id" per il prodotto.
Il campo "product_id" non dovrebbe mai essere un semplice intero. Consigliamo vivamente di codificarlo.
Il file deve includere le seguenti colonne:
product_id (ID personalizzato del prodotto dal tuo database)
user_id / email (identificativo del contatto che ha eseguito l'azione)
timestamp (timestamp dell'occorrenza dell'evento in formato ISO 8601, es. 2017-07-25T14:14:08.612Z)
event_type (quello tratto da l'elenco)
Passare il nome del prodotto è facoltativo. Se non lo includi e il prodotto non esiste già, il prodotto verrà creato senza nome.
Intestazioni delle colonne
Includi sempre le intestazioni delle colonne nella prima riga del tuo file. Cerca di dare alle colonne esattamente gli stessi nomi dei campi esistenti in Positive User. Se il nome della colonna è identico al nome del campo, il sistema li abbinerà automaticamente durante l'importazione.
Codifica
Cos'è la codifica? La codifica indica al computer come interpretare i caratteri di testo nel tuo file. Il formato predefinito e altamente consigliato è UTF-8. Scegliere UTF-8 garantisce che caratteri speciali, accenti e simboli vengano importati correttamente senza trasformarsi in simboli casuali.
Separatore
Cos'è un separatore? Nei file CSV (Comma Separated Values), un separatore è il segno di punteggiatura utilizzato per dividere il testo in distinte colonne del foglio di calcolo. I separatori più comuni sono la virgola (,) o il punto e virgola (;).
Controlla come il tuo software di foglio di calcolo ha esportato il file e assicurati di sapere quale carattere divide i tuoi dati.
Campi multi-valore
Se una colonna contiene più valori (ad esempio, un campo di tipo scelta fissa con più valori consentiti), separali usando il carattere pipe: "|"
Esempio: valore1|valore2|valore3
Se stai esportando da Excel, assicurati di impostare i formati dati corretti per ogni cella.
Vai su "Data" → "Importers" e scegli "Import Product events".
Carica o trascina il file con drag & drop.
Scegli la codifica adatta al tuo file. (UTF-8 è quella predefinita)
Scegli il separatore usato nel tuo file.
Questo passaggio riguarda la mappatura delle intestazioni delle colonne del tuo file con i campi esistenti in Positive User.
Corrispondenza automatica: se il nome della colonna nel tuo file è esattamente uguale al nome del campo nel sistema, verranno abbinati automaticamente.
Corrispondenza manuale: per le colonne non abbinate, seleziona semplicemente il campo esistente corretto dal menu a tendina per collegarli.
Assicurati di collegare tutte le intestazioni delle colonne con i campi! Le colonne non abbinate non verranno importate!
Una volta che tutte le colonne del tuo file sono abbinate ai campi, clicca su "Next". Verrai reindirizzato al passaggio "Confirmation".
Nel passaggio "Confirmation", esamini il riepilogo dell'importazione e confermi il processo. Dopo la conferma, il sistema inizia a elaborare il tuo file.
Puoi monitorare il processo di importazione e verificare i risultati finali nella sezione "Import Results", dove vieni reindirizzato automaticamente.
Puoi accedere a questa sezione in qualsiasi momento tramite il percorso "Data" → "Importers" → "Import Results".
Qui vedrai:
Stato dell'importazione (Started/Pending/Complete/Archived)
Data di creazione
Completata il
Tipo (che tipo di dati è stato importato)
Creato da (membro del team che ha caricato il file)
Nome del file
Righe totali (dal tuo file)
Riuscite (numero finale di righe importate)
Fallite (mostra il numero di errori)
Se qualcosa va storto durante l'importazione, clicca sul nome del file per visualizzare un rapporto dettagliato degli errori.
Personalizza i dati del tuo prodotto aggiungendo campi in linea con le esigenze del tuo business, per un monitoraggio e un'analisi più precisi.
Positive User non archivia i valori storici dei campi degli eventi di prodotto (tranne event_type). Ogni nuovo evento di prodotto aggiorna i valori attuali dei campi sul profilo del prodotto. Ciò significa che i valori più vecchi vengono sovrascritti.
