Puoi utilizzare un file CSV o XLSX per importare più prodotti in Positive User in una sola volta. È un modo pratico per trasferire i dati dei tuoi prodotti nella piattaforma più velocemente e mantenere tutto organizzato fin dall'inizio. In questo articolo scoprirai come formattare correttamente il file e completare l'importazione senza problemi.
Se vuoi saperne di più sui prodotti in Positive User, consulta questo articolo.
Prima di iniziare, assicurati che il tuo file sia strutturato correttamente e di aver compreso come vengono memorizzati i dati in Positive User. La piattaforma utilizza sia campi standard (campi predefiniti come l'indirizzo email o il numero di telefono) sia campi personalizzati (campi che crei tu stesso).
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 necessari. Segui i passaggi indicati 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 file, puoi scaricare un template pronto all'uso direttamente dall'app cliccando sul pulsante "xlsx" o "csv" nella sezione "Dati" → "Importazione".
Per ulteriori consigli sulla formattazione dei dati, consulta il nostro articolo dedicato.
Campi obbligatori
Devi avere un identificatore univoco per ogni prodotto. Può essere un nome oppure un Custom ID. Puoi avere più prodotti con lo stesso nome, ma con Custom ID differenti.
Il campo "custom_id" non dovrebbe mai essere un semplice intero. Ti consigliamo vivamente di codificarlo.
Intestazioni delle colonne
Includi sempre le intestazioni delle colonne nella prima riga del tuo file. Cerca di dare alle tue 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 vivamente 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), il separatore è il segno di punteggiatura utilizzato per dividere il testo in colonne distinte del foglio di calcolo. I separatori più comuni sono la virgola (,) o il punto e virgola (;).
Controlla come il tuo software di fogli di calcolo ha esportato il file e assicurati di sapere quale carattere divide i tuoi dati.
Campi a valori multipli
Se una colonna contiene più valori (ad esempio "Tag" o qualsiasi campo di tipo scelta fissa con più valori consentiti), separali utilizzando il carattere pipe: "|"
Esempio: tag1|tag2|tag3
Se stai esportando da Excel, assicurati di impostare i formati dati corretti per ogni cella.
Vai su "Dati" → "Importer" e scegli "Importa Prodotti".


OPPURE
Puoi procedere tramite "Dati" → "Prodotti" → "Aggiungi prodotti" → "Importa prodotti".

Carica o trascina il file con drag & drop.
Scegli la codifica adatta al tuo file (UTF-8 è quella predefinita).
Scegli il separatore utilizzato nel tuo file.
Aggiungi tag se vuoi che vengano applicati ai prodotti.

Questo passaggio consiste nel mappare le intestazioni delle colonne del tuo file ai campi esistenti in Positive User.
Corrispondenza automatica: se il nome della colonna nel tuo file è esattamente lo stesso del nome del campo nel sistema, saranno abbinati automaticamente.
Corrispondenza manuale: per le colonne non abbinate, seleziona semplicemente il campo esistente corretto dal menu a discesa per collegarle.
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 "Avanti". Verrai reindirizzato al passaggio di "Conferma".
Nel passaggio "Conferma" rivedi 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 "Risultati importazione", dove verrai reindirizzato automaticamente.
Puoi visitare questa sezione in qualsiasi momento tramite il percorso "Dati" → "Importer" → "Risultati importazione".
Qui vedrai:
Stato dell'importazione (Avviato/In attesa/Completo/Archiviato)
Data di creazione
Completato 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 report dettagliato degli errori.
Per visualizzare i profili appena importati, vai su "Dati" → "Prodotti". Puoi filtrare il tuo database per campi specifici o per il tag applicato durante l'importazione per rivedere facilmente i dati importati.
Puoi utilizzare lo stesso processo di importazione per aggiornare prodotti esistenti. Per aggiornare un prodotto, il sistema deve riconoscerlo tramite il campo "custom_id".
Ricorda che i prodotti possono anche essere aggiornati tramite eventi di prodotto e data feed del prodotto.