Importazione di prodotti

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.

Tempo di implementazione: 10 min.
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.

Importazione_prodotti_-_1.png

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.

Importazione_prodotti_-_2.png

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  .

Importazione_prodotti_-_3.png

 

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.

Importazione_prodotti_-_4.png

 

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  .

Importazione_prodotti_-_5.png

 

FASE 3: Verifica dell'importazione

7. Fai clic su Vai all’elenco delle importazioni  .

Importazione_prodotti_-_6.png

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. 

Importazione_prodotti_-_7.png

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.

Importazione_prodotti_-_8.png

 

 

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: