Utilizzando questa funzionalità, verranno creati una serie di articoli in base ai dati contenuti nel file importato.
Esempi
Ecco una serie di esempi di dati dei contenuti pronti per l'importazione:
File .XML:
<?xml version="1.0" encoding="UTF-8"?>
<items>
<item> #element name used for the importer
<name>Red shoe</name>
<category>Shoes</category>
<id>1234</id>
</item>
<item>
<name>Blue jeans</name>
<category>Jeans</category>
<id>1235</id>
</item>
</items>
Consulta questo articolo per vedere un feed completo di esempio.
File .CSV:
id,name,description,price #The header of the CSV file
1,test name,short description,12.50 #A row with values
....
....
Avviare l'importazione
Andare nelle impostazioni del progetto e premere Custom Importer per avviare l'importazione.
Nella schermata successiva, cliccare su Create Import e selezionare Product.
Scegliere fra XML e CSV
Una volta definito il tipo di contenuto, sarà necessario scegliere fra il caricamento di un file CSV o l'inserimento dell'URL di un file XML.
Caricare un file CSV
Per caricare un file CSV, fare click sul box Upload file e selezionare il file dal proprio computer. Una volta caricato con successo il file, il tasto Next diventerà cliccabile.
Caricare un file XML da un URL
Per caricare un file XML è necessario compilare una serie di campi:
Inserire nel campo Element il nome del tag che contiene tutte le informazioni del singolo prodotto, e in Resource Location l'URL del file XML.
Una volta caricato tutto il contenuto del file, l'icona a destra del campo contentene l'URL del feed diventerà un segno di spunta verde. Se compare invece un messaggio di errore, il file potrebbe non essere raggiungibile oppure il dato configurato dentro Element potrebbe essere errato.
Una volta importato correttamente il file XML, comparirà una nuova opzione per definire la frequenza di aggiornamento del feed.
Impostazioni di base per l'importazione
Una volta caricato correttamente il file, verrà visualizzata una panoramica del feed.
Sarà possibile inserire un nome per l'importazione, la tipologia di dati importati e il campo per identificare il singolo elemento.
Unique identifier
Ogni articolo caricato nel contenuto di Datatrics ha un identificativo unico per essere riconosciuto. A seconda della struttura del file importato, è possibile scegliere uno degli dati nel file da utilizzare come ID. Spesso, nella maggior parte dei feed, questi campi sono già denominati "id" o "itemid".
Se nel file non è presente un valore utilizzabile come ID, è anche possibile farne generare uno da Datatrics. Questo potrebbe però creare dei problemi nel tracciamento degli eventi ecommerce (carrello, conversioni, etc) in quanto questo dato potrebbe essere usato come identificativo nell'evento di conversione.
Mappatura dei dati
Una volta scelto il nome dell'import, un campo per l'ID e il tipo di dato da importare, i campi elencati nel feed devono essere collegati ai campi che verranno utilizzati in Datatrics.
Una volta caricata la pagina, essa conterrà un numero di righe pari ai campi presenti dentro un elemento del feed. Ogni riga ha le seguenti cinque colonne:
Questo interruttore serve per abilitare o meno l'importazione di questo campo.
Il nome del campo all'interno del feed.
Il nome del campo che verrà utilizzato all'interno di Datatrics.
Per garantire la compatibilità con una serie di automazioni e configurazioni all'interno della piattaforma, è consigliabile utilizzare determinati nomi per alcuni campi:
Name (string): Il nome dell'articolo.
Description (string): la sua descrizione.
price (decimal): il prezzo.
url (string): l'URL della pagina
image (string): l'URL dell'immagine.
categories (string): il tag che contiene tutte le categorie di appartenenza.
category (string): il tag che contiene una singola categoria.categoriescategory\name (string): il nome della singola categoria.
categories\category\categoryid (string): l'ID della singola categoria.
categories\category\url (string): l'URL della singola categoria.
Per chiarezza, ricordiamo che questa è la struttura corretta di una categoria all'interno di un feed XML:
La tipologia di dato contenuto nel campo:
Number: Un numero intero.
String: Una stringa di testo.
Decimal: Un numero decimale (es. 9.99)
Boolean: Un campo contente 1/0 o true/false
List: Una serie di valori separati da virgola (es. test1,test2,test3)
Date: Una data.
Una volta compilati tutti questi dati per i prodotti interessati, cliccare il tasto Next per avviare l'importazione.
Salvare la configurazione
Nell'ultima schermata saranno elencati il numero di campi che verranno importati. Una volta premuto il tasto di conferma, verrà avviata l'importazione di tutti i dati.
Il processo di importazione potrebbe richiedere del tempo in base alla mole di dati contenuta nel feed, fino a 15 minuti circa.
Una volta terminata l'importazione, l'icona del caricamento diventerà un segno di spunta verde e tutti gli articoli importati saranno elencati nella sezione Content di Datatrics.