Show Menu
ARGOMENTI×

Mappare un file CSV su uno schema XDM

Per assimilare i dati CSV in Adobe Experience Platform, questi devono essere mappati su uno schema Experience Data Model (XDM). Questa esercitazione illustra come mappare un file CSV su uno schema XDM mediante l’interfaccia utente della piattaforma Experience.
Inoltre, l'appendice di questa esercitazione fornisce ulteriori informazioni sull'utilizzo delle funzioni di mappatura.

Introduzione

Questa esercitazione richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
  • Modello dati esperienza (XDM System) : Il framework standardizzato tramite il quale Experience Platform organizza i dati sull'esperienza dei clienti.
  • Caricamento batch: Metodo con cui la piattaforma acquisisce i dati dai file di dati forniti dall'utente.
Questa esercitazione richiede anche che sia già stato creato un set di dati in cui assimilare i dati CSV. Per i passaggi sulla creazione di un dataset nell'interfaccia utente, consulta l'esercitazione sull'acquisizione dei dati.

Aggiungi dati

Nell’interfaccia utente della piattaforma Esperienza, fai clic su Flussi di lavoro nella barra di navigazione a sinistra, quindi fai clic su Mappa CSV nello schema XDM. Nella barra a destra visualizzata, fate clic su Avvia .
Viene visualizzato il flusso di lavoro Mappa CSV a schema XDM, a partire dal passaggio Aggiungi dati .
Trascinate e rilasciate il file CSV nello spazio disponibile oppure fate clic su Sfoglia per selezionare direttamente un file. Una volta caricato il file, viene visualizzata una sezione di dati di esempio che mostra le prime dieci righe di dati. Dopo aver confermato che i dati sono stati caricati come previsto, fate clic su Avanti .

Scegliere una destinazione

Viene visualizzato il passaggio Destinazione . Dall’elenco fornito, selezionate il set di dati in cui saranno inviati i dati CSV, quindi fate clic su Avanti .

Mappatura di campi CSV nei campi dello schema XDM

Viene visualizzato il passaggio Mapping . Le colonne del file CSV sono elencate in Campo di origine, con i campi dello schema XDM corrispondenti elencati in Campo di destinazione. I campi di destinazione non selezionati sono evidenziati in rosso.
Per mappare una colonna CSV su un campo XDM, fate clic sull'icona dello schema accanto al campo di destinazione corrispondente della colonna.
Viene visualizzata la finestra del campo __ Seleziona schema. Qui puoi spostarti nella struttura dello schema XDM e individuare il campo a cui mappare la colonna CSV. Fate clic su un campo XDM per selezionarlo, quindi fate clic su Seleziona .
La schermata Mappatura viene visualizzata di nuovo, con il campo XDM selezionato ora sotto il campo __ Target.
Se non desiderate mappare una particolare colonna CSV, potete rimuovere la mappatura facendo clic sull'icona di rimozione accanto al campo di destinazione. Per aggiungere una nuova mappatura, fate clic su Aggiungi nuova mappatura in fondo all’elenco.
Quando mappate i campi, potete anche includere funzioni per calcolare i valori in base ai campi di origine di input. Per ulteriori informazioni, consulta la sezione delle funzioni di mappatura nell’appendice.
Ripetete i passaggi indicati sopra per continuare la mappatura delle colonne CSV ai campi XDM. Al termine, fate clic su Avanti .

Dati di assimilazione

Viene visualizzato il passaggio Assegna , che consente di controllare i dettagli del file di origine e del set di dati di destinazione. Fate clic su Assegna per iniziare a assimilare i dati CSV. A seconda delle dimensioni del file CSV, questo processo potrebbe richiedere alcuni minuti. Lo schermo si aggiorna una volta completata l'assimilazione, indicando se l'operazione ha esito positivo o negativo. Fate clic su Fine per completare il flusso di lavoro.

Passaggi successivi

Seguendo questa esercitazione, avete mappato correttamente un file CSV semplice su uno schema XDM e lo avete assimilato in Piattaforma. Questi dati possono ora essere utilizzati dai servizi della piattaforma a valle, ad esempio Profilo cliente in tempo reale. Per ulteriori informazioni, consulta la panoramica Profilo cliente in tempo reale.

Appendice

La sezione seguente fornisce informazioni aggiuntive per la mappatura delle colonne CSV ai campi XDM.

Funzioni di mappatura

Alcune funzioni di mappatura possono essere utilizzate per calcolare e calcolare i valori in base a quanto immesso nei campi di origine. Per utilizzare una funzione, digitarla in Campo di origine con sintassi e input appropriati.
Ad esempio, per concatenare i campi CSV città e paese e assegnarli al campo XDM città , impostate il campo di origine come concat(city, ", ", county) .
Nella tabella seguente sono elencate tutte le funzioni di mappatura supportate, incluse le espressioni di esempio e i relativi output.
Funzione
Descrizione
Espressione esempio
Output di esempio
concat
Concatenate le stringhe date.
concat("Ciao, ", "lì", "!")
"Hi, there!"
esplodere
Divide la stringa in base a un regex e restituisce un array di parti.
esplode("Ciao, ciao!", " ")
["Hi,", "there"]
instr
Restituisce la posizione/indice di una sottostringa.
instr("adobe .com", "com")
6
sostituto
Sostituisce la stringa di ricerca, se presente nella stringa originale.
replace("Questa è una stringa ri test", "re", "replace")
"Questo è un test di sostituzione delle stringhe"
substr
Restituisce una sottostringa della lunghezza specificata.
substr("Questo è un test di sottostringa", 7, 8)
" a subst"
Lower /
lcase
Converte una stringa in caratteri minuscoli.
lower("HeLL")
lcase("HeLLo")
"hello"
Upper /
ucase
Converte una stringa in caratteri maiuscoli.
Upper("HeLL")
ucase("HeLLo")
"HELLO"
split
Divide una stringa di input su un separatore.
split("Hello world", " ")
["Hello", "world"]
join
Unisce un elenco di oggetti utilizzando il separatore.
join(" ", ["Hello", "world"] )
"Hello world"
fondersi
Restituisce il primo oggetto non-null in un elenco specificato.
coalesce(null, null, null, "first", null, "seconda")
"first"
decodificare
Data una chiave e un elenco di coppie di valori chiave appiattite come array, la funzione restituisce il valore se viene trovata una chiave o restituisce un valore predefinito se presente nell'array.
decode("k2", "k1", "v1", "k2", "v2", "default")
"v2"
iif
Valuta una determinata espressione booleana e restituisce il valore specificato in base al risultato.
iif("s".equalsIgnoreCase("S"), "True", "False")
"True"
min
Restituisce il minimo degli argomenti specificati. Utilizza l'ordine naturale.
min(3, 1, 4)
1
max
Restituisce il massimo degli argomenti specificati. Utilizza l'ordine naturale.
max(3, 1, 4)
4
first
Recupera il primo argomento specificato.
first("1", "2", "3")
"1"
last
Recupera l'ultimo argomento specificato.
last("1", "2", "3")
"3"
uuid /
guid
Genera un ID pseudo-casuale.
uid()
guid()
now
Recupera l'ora corrente.
now()
2019-10-23T10:10:24.556-07:00[America/Los_Angeles]
timestamp
Recupera l'ora Unix corrente.
timestamp()
1571850624571
format
Formatta la data di input in base a un formato specificato.
format(, "yyyy-MM-dd HH:mm:ss")
"2019-10-23 11:24:35"
dformat
Converte una marca temporale in una stringa data in base a un formato specificato.
dformat(1571829875, "dd-MMM-yyyy hh:mm")
"23-ott-2019 11:24"
date
Converte una stringa data in un oggetto ZoningDateTime (formato ISO 8601).
date("23-ott-2019 11:24")
"2019-10-23T11:24:00+00:00"
date_part
Recupera le parti della data. Sono supportati i seguenti valori di componente:
"anno"
"yyyy"
"yy"
"trimestre"
"qq"
"q"
"mese"
"mm"
"m"dayofyear""""y""giorno""d""d""settimana"d"ora""giorno feriale"
"dw""w""h" "hh24""hh12""minuto"mi""n""2"2""ss""s"""millisecond""ms"
date_part(date("2019-10-17 11:55:12"), "MM")
10
set_date_part
Sostituisce un componente in una data specificata. Sono accettati i seguenti componenti:
"anno"
"yyyy"
"yy"
"month"
"mm"
"m"
"day"
"dd"
"d"ora"
""hh""minuti""mi""n"""secondi"ss""s""
set_date_part("m", 4, date("2016-11-09T11:44:44.797")
"2016-04-09T11:44:44.797"
make_date_time /
make_timestamp
Crea una data da parti.
make_date_time(2019, 10, 17, 11, 55, 12, 999, "America/Los_Angeles")
2019-10-17T11:55:12.0​00000999-07:00[America/Los_Angeles]
current_timestamp
Restituisce il timestamp corrente.
current_timestamp()
1571850624571
current_date
Restituisce la data corrente senza un componente ora.
current_date()
"18-nov-2019"