Questo documento illustra come preparare un file per l'ambito "carrelli abbandonati" (abandonedcarts).
I file nell'ambito "abandonedcarts" sono molto simili ai file "orders", poiché i carrelli abbandonati rappresentano degli scontrini di acquisti che non sono mai stati completati. Splio rifiuterà ogni record "orderitems" se l'ordine corrispondente non è stato ancora creato.
I dati nell'ambito "abandonedcarts" possono essere aggiornati tramite successivi caricamenti. Splio rifiuterà ogni record "orderitems" se l'ordine corrispondente non è stato ancora creato.
Troverai un esempio di un file per questo ambito alla fine di questo articolo.
Considera che Splio inizia l'elaborazione degli import nell'ambito "abandonedcarts" rimuovendo dapprima tutti gli "ordersitems" per ogni "order_id" trovato nel file di import.
Prerequisiti
- Conoscenza di base del formato CSV e della codifica UTF-8
- Un editor di testo compatibile con la codifica UTF-8
- Un software di fogli di calcolo
- Generazione della sotto-sequenza nel file di configurazione nell'ambito di “abandonedcarts”
Preparazione di un file "carrelli abbandonati" (abandonedcarts)
Modifica il file di import con il tuo editor di testo preferito, compatibile con la codifica UTF-8. Se necessario, utilizza un software di fogli di calcolo che conosci per verificare il numero e il posizionamento delle colonne.
💡 | Ricordati sempre di salvare il tuo lavoro utilizzando la codifica UTF-8 senza BOM.
⚠️| Per favore, limita le dimensioni del file a 200K.
Intestazione e colonne
La prima linea del file, chiamata intestazione, viene utilizzata per identificare il contenuto delle linee successive e, pertanto, deve contenere solamente i nomi delle colonne.
⚠️ | Se Splio trova un nome di una colonna che non identifica, in questo caso non importerà il file.
Le seguenti colonne sono disponibili nell'ambito "abandonedcarts":
Colonna |
Necessaria |
Tipo di dati/ Lunghezza massima |
Descrizione |
id dell'ordine (order_id) |
Sì |
Testo (max. 50 caratteri) |
L'ID esterno del carrello abbandonato importato. Questo valore deve essere univoco per ogni carrello. |
chiave cliente (customer_key) |
Sì |
Testo |
Colonna speciale utilizzata da Splio per identificare i contatti nel database. |
codice carta (card_code) |
No |
Testo |
Codice di una carta loyalty che collega il carrello abbandonato e la carta loyalty. Vedi il paragrafo 0 "scontrini loyalty" in Import - Scontrini (orders) per maggiori dettagli. |
id del negozio (store_id) |
Sì |
Testo (max. 50 caratteri) |
L'ID esterno del negozio, dove è stato generato e abbandonato il carrello, collega "abandonedcarts" e "stores". I valori in questa colonna devono riferirsi ai negozi già importati. |
data dell'ordine (order_date) |
No |
Data |
Data associata al carrello abbandonato. Vedi il paragrafo "Date" qui sotto per maggiori dettagli sul formato.⚠️ | Per evitare errori, completa sempre i campi utilizzando ore, minuti e secondi. |
importo della spedizione (shipping_amount) |
No |
Decimale |
Rappresenta l'importo dovuto a titolo di pagamento per la spedizione di un ordine con lo stesso contenuto del carrello. |
importo dello sconto (discount_amount) |
No |
Decimale |
L'importo dello sconto totale applicato al carrello. |
importo delle imposte (tax_amount) |
No |
Decimale |
L'importo totale delle imposte (IVA, imposta sulle vendite) applicato al carrello. |
importo totale (total_amount) |
No |
Decimale |
L'importo totale pagato per gli articoli nel carrello (e la spedizione) meno lo sconto. |
valuta (currency) |
No |
Testo (max. 3 caratteri) |
Il codice a 3 lettere per la valuta del carrello abbandonato; si applica a tutti gli importi. Se non viene indicata alcuna valuta, Splio utilizzerà la valuta predefinita per l'universo. |
venditore (salesperson) |
No |
Testo (max. 120 caratteri) |
Il venditore collegato al carrello. |
c0 |
No |
|
Una colonna personalizzata definita nel tuo universo per "orders". Puoi includere fino a 32 colonne da "c0" a "c31". |
📗 | Nota che tutti i nomi delle colonne sono sempre in minuscolo.
💡 | La colonna customer_key identifica i contatti nel database del tuo universo Splio. Vedi Import - Contatti (Contacts) per saperne di più su come funziona.
⚠️ | Ricordati che Splio verifica i file di import per le colonne obbligatorie. Includi sempre "order_id", "customer_id" e "store_id" affinché l'import venga effettuato correttamente.
Esempio 1: chiave cliente predefinita
Le prime linee di un file di import "abandonedcarts" che utilizzano la chiave cliente predefinita (email del contatto) possono assomigliare a questa struttura:
order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bMhtt-1531745300";"misterspots@examplemail.org";"Internet";"2018-06-22 11:30:00;173.00";"EUR"
"70x1byTRJ-1531778200";"lady@examplemail.org";"Internet";"2018-06-21 12:10:00";"244.99";"EUR"
"70xb1KLio-1531723300";"8sk5k7g87@examplemail.org";"Internet";"2018-06-20 17:33:00";"25.50";"EUR"
📗 | Ogni linea è formata esattamente da 6 colonne. "order_id" è utilizzato per distinguere i carrelli, mentre "customer_key" correla l'ordine al contatto che ha generato e abbandonato il carrello.
Esempio 2: colonna personalizzata come chiave cliente
Confronta un file di import che utilizza una colonna personalizzata come chiave cliente rispetto all'esempio 1 di cui 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"
📗 | I due import sono molto simili, tuttavia soltanto il tipo di valori in "customer_key" è diverso. Devi sempre utilizzare la chiave cliente richiesta dal tuo universo Splio.
Denominare il file
Per salvare il file, utilizza un nome costutuito dal nome dell'universo, l'ambito ("abandonedcarts"), la sotto-sequenza e la data corrente. Ad esempio:
myuniverse_abandonedcarts_zoo_20210226.csv
Questo nome di file appartiene all'universo "myuniverse", sotto-sequenza "zoo" definita per i carrelli abbandonati, ed è datato 26 febbraio 2021.
Per maggiori informazioni, consulta il paragrafo "Linee guida per la denominazione dei file" nel documento panoramica.
Ora puoi procedere a caricare il file su SFTP/FTPS.
Date
Tutte le date utilizzate nei file di import di iscrizione vanno formattate nel seguente modo: 4 cifre per l'anno, 2 per il mese e 2 per il giorno, seguite da ore, minuti e secondi con 2 cifre per ciascuno. Il formato corretto per la data del 15 marzo 2021 alle 13:37 sarà:
2021-03-15 13:37:00
Il giorno e l'ora sono separati da uno spazio vuoto. Puoi omettere la parte dell'orario e utilizzare solo la data. In tal caso Splio utilizzerà il primo orario possibile del giorno (mezzanotte). Quindi,
2018-09-09
equivale
2018-09-09 00:00:00
⚠️ | Utilizzare le date senza un orario non dovrebbe mai essere un'opzione per le date e gli orari. 00:00:00 corrisponde alla mezzanotte e Splio tenterà di elaborare ogni data in questo modo. Quest'azione potrebbe generare degli errori e dei trigger associati alle date potrebbero non avvenire in modo corretto. Inoltre, tutti i dati loyalty si possono comparare a dati economici, pertanto è importante non trascurare nulla.
📗 | Un ulteriore vantaggio nell'utilizzare una data completa è che sarai in grado di cercare e filtrare per data con maggior precisione.
⚠️ | Utilizza sempre lo stesso fuso orario (GMT+1 per i clienti al di fuori della Cina e GMT+8 per i clienti cinesi) durante l'import delle date con l'orario.
Spiegazione: NULL e valori di cancellazione
NULL è un valore speciale che indica al database che il campo che lo contiene è vuoto.
Il tuo universo Splio può essere configurato in modo che interpreti i valori NULL come istruzioni per i campi vuoti. Puoi utilizzarlo per cancellare i valori archiviati nel database. Per farlo, assicurati che il valore importato sia esattamente NULL. Evita spazi iniziali e spazi finali: " NULL" o "NULL " saranno riconosciuti come valori di stringa.
Se questa opzione non è impostata, Splio considererà i valori per i campi dove il valore importato è NULL.
Differenza tra NULL e stringa vuota
"" è una stringa vuota. Nella maggior parte dei casi, sia NULL sia "" saranno importati come un valore vuoto.
L’aspetto più importante è che la stringa vuota "" non è mai considerata un valore NULL, pertanto non comporterà la cancellazione di un valore esistente.