Esempi
File XML:
<Profile>
<id>1</id>
<profileid>de02c53b</profileid>
<email>sbuckleigh0@test.nl</email>
<name>Jan Test</name>
<firstname>Jan</firstname>
<lastname>Test</lastname>
<country>Netherlands</country>
</Profile>
File CSV:
"profileid", "email", "naam", "voornaam", "achternaam", "land"
"13232", "test@test.nl", "Jan Test", "Jan", "Test", "Netherlands"
"23234", "max@test.de", "Max Test", "Max", "Test", "Germany"
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 Profiles.
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 profilo, 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 profilo caricato da 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 "profileid".
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
Sarà quindi possibile iniziare la mappatura delle informazioni del profilo sulla base del contenuto del file importato.
Nel seguente esempio, i campi "profileid" ed "email" sono assegnati al profilo utilizzando il prefisso "profile."
I profili possono contenere una serie di informazioni come ad esempio Nome, Cognome, Città, Cap, etc. che è possibile importare assegnando il prefisso "profile." al campo che verrà usato dentro Datatrics.
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.
Un esempio dei dati contenuti nel campo.
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 profili interessati, cliccare il tasto Next per avviare l'importazione. L'importazione potrebbe richiedere fino a qualche ora e al termine di essa saranno consultabili nella sezione Audience.
Se non si vuole aspettare o si vuole vedere il risultato immediatamente, si può sempre usare la seguente chiamata API:
La chiamata dovrebbe restituire la lista di tutti i profili importati. Per ulteriori informazioni su Come verificare la sincronizzazione dei profili, consultare questo articolo.