Questo articolo spiega come preparare un file per la sezione “carrelli abbandonati”.

I file della sezione “carrelli abbandonati” sono molto simili ai file “ordini”, in quanto i carrelli abbandonati rappresentano ordini di acquisto che non sono mai stati completati. Inoltre, come per gli ordini, se ci sono articoli nei carrelli, è necessario importarli come “ordersitems”.

I dati dei carrelli abbandonati sono spesso raccolti dai negozi online, che devono memorizzare le scelte dei clienti nei carrelli virtuali e possono facilmente identificare i carrelli che non sono mai stati elaborati come ordini.

I dati dei carrelli abbandonati possono essere aggiornati con le importazioni successive. Splio non riconoscerà gli "orderitems" collegati a un ordine non ancora esistente nel database.

🚧
Si noti che Splio inizia a elaborare le importazioni dalla sezione “carrello abbandonato” cancellando prima tutte le voci d'ordine per ogni ID d'ordine trovato nel file di importazione.

Prerequisiti

Conoscenza di base del formato CSV e della codifica UTF-8.
Un editor di testo compatibile con UTF-8.
Un software per foglio elettronico.
La sottosequenza deve essere definita nel file di configurazione nella sezione “abandonedcarts”.

Preparare un file per carrelli abbandonati

Modifica il file di importazione con l'editor di testo UTF-8 che preferisci. Se necessario, utilizza un software di foglio di calcolo che già conosci per controllare il numero e la posizione delle colonne.

🚧

Ricordati di salvare utilizzando la codifica UTF-8 senza BOM.

Limita le dimensioni del file a 200K linee.

Header e Colonne

La prima riga del file, chiamata header, viene utilizzata per determinare il contenuto delle righe successive. Deve quindi essere costruita solo a partire dai nomi delle colonne.

🚧
Recuerda que si Splio encuentra un nombre de columna que no puede reconocer, saltará el archivo.

Colonna	Obbligatorio	Tipo di dati / Lunghezza massima	Descrizioni
order_id	Sì	Testo (max. 50 caratteri)	L'identificatore esterno dell'ordine importato (il numero unico di un ordine). Questo numero deve essere unico per ogni ordine.
customer_key	Sì	Testo	Colonna specifica utilizzata da Splio per identificare i contatti nel database. Se si tratta dell'indirizzo email, deve essere in minuscolo.
card_code	No	Testo	Codice di una carta Loyalty. Il codice crea un collegamento tra l'ordine e la carta fedeltà. Per maggiori dettagli, consulta la sezione “Ordini Loyalty”.
store_id	Sì	Testo (max. 50 caratteri)	ID esterno dello store in cui è stato effettuato l'ordine. Questo ID crea una relazione tra "orders" e "stores". I valori di questa colonna devono riferirsi agli stores già importati.
order_date	No	Data	Data in cui è stato effettuato l'ordine. Per ulteriori dettagli sulla formattazione, vedi “Date” di seguito. Per evitare errori, inserire sempre ore, minuti e secondi.
shipping_amount	No	Decimale	Rappresenta l'importo dovuto come pagamento per la spedizione dell'ordine.
discount_amount	No	Decimale	L'importo totale dello sconto applicato all'ordine.
tax_amount	No	Decimale	L'importo totale delle imposte (IVA, imposta sulle vendite) applicate all'ordine.
total_amount	No	Decimale	L'importo totale pagato per gli articoli dell'ordine (e la spedizione), meno lo sconto.
currency	No	Testo (max. 3 caratteri)	Codice di 3 lettere per la valuta dell'ordine; si applica a tutti gli importi. Se non viene indicata nessuna valuta, Splio adotterà quella predefinita nell'universo.
salesperson	No	Testo (max. 120 caratteri)	Il venditore responsabile dell'ordine.
c02	No		Una colonna personalizzata relativa agli ordini e definita nel tuo universo. È possibile aggiungere fino a 32 colonne denominate da “c0” a “c31”.

📘

Si noti che tutti i nomi delle colonne sono sempre scritti in minuscolo.

La colonna customer_key identifica i contatti nel database dell'universo Splio.

Si precisa che Splio esamina i file di importazione per verificare la presenza di colonne obbligatorie. È necessario includere “order_id”, “customer_key” e “store_id” affinché l'importazione vada a buon fine.

Esempio 1: Default Customer Key

Le prime righe di un file di importazione "abandonedcarts" che utilizza la chiave cliente predefinita (l'email del contatto) potrebbero essere così:

order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bMhtt-1531745300";"[email protected]";"Internet";"2018-06-22 11:30:00;173.00";"EUR"
"70x1byTRJ-1531778200";"[email protected]";"Internet";"2018-06-21 12:10:00";"244.99";"EUR"
"70xb1KLio-1531723300";"[email protected]";"Internet";"2018-06-20 17:33:00";"25.50";"EUR"

Ogni riga è composta esattamente da 6 colonne. L'“order_id” serve a distinguere gli ordini, il “customer_key” collega l'ordine al contatto che lo ha acquistato.

Esempio 2: Personalizzare colonne come Customer Key

Confronta un file di importazione che utilizza una colonna personalizzata come Chiave Cliente con l'Esempio 1 riportato sopra:

order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bKkUt-1531738300";"PPL000000045732";"MGZOO";"2018-06-27 12:17:27";"225.00";"EUR"
"70x1bKooY-1531738300";"PPL000000007633";"MGZOO";"2018-06-27 12:19:23;17.00";"EUR"
"70x1bu9Gt-1531756600";"PPL000000045661";"MGZOO";"2018-06-27 12:22:07";"112.50";"EUR"

Entrambe le importazioni sono molto simili, solo il tipo di valori in “customer_key” è diverso. È necessario utilizzare sempre la Chiave Cliente richiesta dall'universo Splio.

Nominare il file

Per salvare il file, utilizza un nome composto dal nome dell'universo, dalla sezione (“carrelli abbandonati”), dalla sottosequenza e dalla data corrente. Ad esempio:

myuniverse_orders_zoo_20210226.csv

Questo file appartiene all'universo “myuniverse”, alla sottosequenza “zoo” definita per gli ordini ed è datato 26 febbraio 2021.

Ora è possibile caricare il file su SFTP/FTPS.

Date

Tutte le date utilizzate nei file di importazione delle iscrizioni devono essere nel seguente formato: 4 cifre per l'anno, 2 per il mese e 2 per il giorno, seguite da ore, minuti e secondi, ciascuno con 2 cifre. Il formato corretto per la data 15 marzo 2021, ore 13:37 è il seguente:

2021-03-15 13:37:00

La data e l'ora sono separate da uno spazio. È possibile omettere l'ora e utilizzare solo la data. Se si sceglie di utilizzare solo la data, senza l'ora, Splio considererà automaticamente la mezzanotte come l'ora di quel giorno. Pertanto,

2018-09-09 equivale a 2018-09-09-09 00:00:00.

🚧

L'uso di date senza orario non dovrebbe mai essere un'alternativa per le date e gli orari: 00:00:00 corrisponde alla mezzanotte e Splio elaborerà la data come tale. Questo potrebbe provocare errori e malfunzionamenti nei trigger associati alle date. Inoltre, i dati relativi a Loyalty sono trattati come informazioni di tipo economico, quindi tu e la tua azienda siete responsabili della loro accuratezza, così come di ogni altro dettaglio. Un ulteriore vantaggio dell’uso delle date complete è che sarai in grado di cercare e filtrare per data con maggiore precisione.

Quando si importano date con orario, assicurarsi di utilizzare sempre lo stesso fuso orario (GMT+1 per i clienti al di fuori della Cina e GMT+8 per i clienti cinesi).

Dettagli aggiuntivi: NULL e cancellazione dei dati

NULL è un valore specifico che indica al database che un campo è vuoto.

Nel tuo universo Splio, puoi configurare il sistema per interpretare i valori NULL come istruzioni per svuotare i campi. Questa configurazione ti permette di cancellare i dati memorizzati nel database. Per fare ciò, assicurati che il valore importato sia esattamente NULL, senza spazi aggiuntivi: "NULL" o "NULL" verranno trattati come valori di testo.

Se questa opzione non è attiva, Splio manterrà i valori nei campi per cui il valore importato è NULL.

Differenza tra NULL e stringa vuota

""è una stringa vuota. Nella maggior parte dei casi, sia NULL che "" saranno importati come valori vuoti.

Soprattutto, la stringa vuota “” non viene mai considerata un valore NULL, quindi non causa la cancellazione di un valore esistente.