L'importazione dei prodotti permette di aggiungere articoli al tuo catalogo manualmente tramite lo strumento di importazione, per averli immediatamente disponibili nelle tue strategie.
In questo articolo imparerai come effettuare un'importazione di prodotti in Connectif.
Difficoltà: Bassa.
Quando utilizzarlo: Durante l'integrazione del tuo account Connectif e in qualsiasi momento in modo occasionale.
Anche se l'etichetta "Il contatto ha visitato un prodotto" registrerà automaticamente i prodotti man mano che vengono visitati, è consigliabile effettuare un'importazione iniziale dell'intero catalogo al momento dell'integrazione con Connectif, per averlo disponibile fin da subito.
Prima di iniziare: preparazione del file dei prodotti
Per effettuare l'importazione è necessario un file CSV valido che contenga i campi dei prodotti da importare.
Nella tabella seguente, sono mostrati i campi che possono essere inclusi nel file CSV:
| Nome | Tipo | Descrizione | Esempio |
|---|---|---|---|
| productDetailUrl | Testo | URL della pagina del prodotto (l’URL deve essere non codificato). Questo valore è obbligatorio nel documento. | http://exple.com/productA |
| productId | Testo | Identificatore univoco del prodotto (nell’eCommerce). Questo valore è obbligatorio nel documento. | 101 |
| name | Testo | Nome del prodotto. Questo valore è obbligatorio nel documento. | Product A |
| unitPrice | Decimale | Prezzo unitario del prodotto. Questo valore è obbligatorio nel documento. | 20.99 |
| imageUrl | Testo | URL dell'immagine del prodotto. | http://exple.com/images/productA.jpg |
| description | Testo | Descrizione del prodotto. | An innovative gadget for modern homes. |
| thumbnailUrl | Testo | URL dell'immagine di anteprima del prodotto. | http://expl.com/thumbs/productA.jpg |
| categories | Lista di testi |
La categoria o le categorie a cui appartiene il prodotto. Se si vogliono indicare più categorie, si deve utilizzare il carattere "|" per separarle. Se l'eCommerce prevede sottocategorie, è necessario indicare il percorso completo separando ogni livello con il carattere "/". Ad esempio: "/Computer/Tastiere/Logitech". |
electronics/home/gadgets| electronics/home/accessories |
| tags | Lista di testi | Le etichette associate al prodotto. Per indicare più etichette, si deve utilizzare il carattere "|". | innovative|gadget |
| brand | Testo | Marca del prodotto. | GadgetPro |
| ratingCount | Intero | Numero di valutazioni che ha il prodotto. | 150 |
| rating | Decimale | Valutazione media del prodotto. | 4.5 |
| reviewCount | Intero | Numero di recensioni che ha il prodotto. | 75 |
| relatedExternalProductIds | Lista di testi | ID di prodotti correlati. Per indicare più prodotti, usare il carattere "|". | 200|201 |
| priority | Intero | Livello di priorità o preferenza di questo prodotto. Il valore predefinito è 0. | 5 |
| unitPriceOriginal | Decimale | Prezzo unitario originale del prodotto. | 25.99 |
| unitPriceWithoutVAT | Decimale | Prezzo unitario del prodotto senza tasse. | 17.49 |
| discountedPercentage | Decimale | Percentuale di sconto, valore compreso tra 0 e 100 senza simbolo di percentuale. | 20 |
| discountedAmount | Decimale | Importo scontato del prodotto (deve corrispondere a unit_price_original - unit_price). | 5.0 |
| publishedAt | Data | Data in formato ISO8601 della prima volta che il prodotto è apparso nel catalogo dello Store. | 2021-03-15T00:00:00Z |
| inStockUnits | Intero | Numero di unità del prodotto in stock. | 120 |
| availability | Testo | Si indica con instock o outofstock. Indica se il prodotto è disponibile oppure no. | instock |
| isBlacklisted | Booleano | Si indica con true o false e consente (se impostato su true) di escludere il prodotto dalle raccomandazioni. Se non specificato, il valore predefinito sarà false alla creazione del prodotto. | false |
| customField1 | Testo | Proprietà personalizzata. | CustomValueA1 |
| customField2 | Testo | Proprietà personalizzata. | CustomValueA2 |
I nomi della tabella devono rimanere esattamente uguali se l'importazione dei prodotti viene effettuata tramite API. In caso contrario, possono essere modificati, poiché dovranno successivamente essere associati nel mapping.
Di seguito è mostrato un esempio di dati estratti dal file CSV:
name,productDetailUrl,productId,unitPrice,imageUrl,thumbnailUrl,description,categories,tags,relatedExternalProductIds,priority,ratingCount,rating,reviewCount,brand,unitPriceOriginal,unitPriceWithoutVAT,discountedAmount,discountedPercentage,publishedAt,inStockUnits,availability,isBlacklisted,customField1,customField2,customField3 Product A,http://example.com/productA,101,20.99,http://example.com/images/productA.jpg,http://example.com/thumbs/productA.jpg,An innovative gadget for modern homes.,electronics/home/gadgets|electronics/home/accessories,innovative|gadget,200|201,5,150,4.5,75,GadgetPro,25.99,17.49,5.0,20,2021-03-15T00:00:00Z,120,instock,false,CustomValueA1,CustomValueA2,CustomValueA3 Product B,http://example.com/productB,102,45.5,http://example.com/images/productB.jpg,http://example.com/thumbs/productB.jpg,A durable and reliable tool for professionals.,tools/professional/hardware|tools/professional/accessories,durable|professional,300|301,3,200,4.7,90,ToolWorks,50.0,37.92,4.5,10,2021-06-20T00:00:00Z,80,outofstock,true,CustomValueB1,CustomValueB2,CustomValueB3
FASE 1: Selezione dell'origine dei dati
1. Accedi a "Ecommerce > Catalogo" e fai clic su Importa prodotti.
2. Nella sezione Seleziona una fonte dati scegli l'opzione Importa da file.
È possibile effettuare l'importazione copiando e incollando il contenuto del CSV nella casella di testo centrale, ma questa opzione è più limitata poiché non consente l'importazione di grandi quantità di prodotti.
3. Configura i parametri dell'importazione.
3.1. Seleziona Includi intestazione se il file CSV contiene un’intestazione con i nomi delle colonne.
3.2. Scegli, in Delimitatore, il carattere che separa le colonne nel tuo file.
3.3. Seleziona l'opzione Sovrascrivi esistenti se desideri sostituire le informazioni dei prodotti già esistenti in Connectif con quelle contenute nel file.
3.4. Seleziona l'opzione Aggiorna solo i campi vuoti se desideri che vengano aggiornati solo i campi privi di informazioni.
4. Fai clic su Avanti .
FASE 2: Configurazione dei campi da importare
Una volta importato il file, è necessario associare i campi del CSV importato (colonna di sinistra dell'interfaccia) con i campi dei prodotti in Connectif.
5. Seleziona il nome di ogni campo del file importato e trascinalo sul campo corrispondente di Connectif.
Nell'esempio, il campo del file ID è quello che assegna valore al campo ID esterno prodotto in Connectif, Nome prodotto lo assegna al campo Nome in Connectif, Categorie lo assegna a Categorie e Prezzo Unitario a Prezzo unitario.
Esiste anche un valore (sempre disponibile) chiamato Letterale. La sua utilità principale è quella di "simulare" l'importazione di una colonna che in realtà non è presente nel file CSV importato. Quando si assegna Letterale a un campo del prodotto, appare un editor che consente di assegnare il valore desiderato a quel campo per tutti i prodotti da importare.
6. Fai clic su Avanti .
FASE 3: Verifica dell'importazione
7. Fai clic su Vai all’elenco delle importazioni .
8. Verifica che i prodotti e le loro informazioni siano stati importati correttamente.
In questa schermata, viene visualizzata la percentuale di avanzamento dell'importazione dei prodotti e, una volta completata, il relativo riepilogo.
9. Se si verifica un errore, scarica il CSV con il report degli errori cliccando sul pulsante (Scarica report errori in CSV).
Il caso più comune di errore nell'importazione è che una delle righe del file CSV contenga un tipo di dato incompatibile con quello del campo assegnato. Ad esempio, se si assegna il valore di testo "PREZZO" al campo Prezzo unitario del prodotto, l'importazione di questo record genererà un errore.
Congratulazioni!
Hai completato la lezione.
Hai ancora dei dubbi?
Ricorda che hai a disposizione i nostri specialisti di Connectif. Per contattarli, ti basta aprire un ticket al Supporto cliccando sul pulsante blu “Aiuto” della tua Dashboard.
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account in Connectif, ti consigliamo di continuare con i seguenti articoli:
- Scheda prodotto, per conoscere le etichette e le categorie dei prodotti del tuo eCommerce.
- Sincronizzazione e verifica dei prodotti, per sfruttare tutto il potenziale del catalogo di Connectif.
- Segmenti di prodotti, per imparare come utilizzare in tempo reale gruppi di prodotti nelle tue strategie.
-
Raccomandatore di offerte, per aiutare i clienti indecisi a scegliere i prodotti in promozione sul sito.