Caricamento di dati in Adobe Experience Platform

Adobe Experience Platform consente di importare facilmente i dati in Platform come file batch. Esempi di dati da assimilare possono includere dati di profilo da un file semplice in un sistema CRM (ad esempio un file Parquet) o dati conformi a uno schema Experience Data Model (XDM) noto nel Registro di sistema dello schema.

Introduzione

Per completare questa esercitazione, è necessario avere accesso a Experience Platform. Se non disponete dell'accesso a un'organizzazione IMS in Experience Platform, rivolgetevi all'amministratore di sistema prima di procedere.

Se preferisci assimilare i dati utilizzando le API di inserimento dati, inizia leggendo la Guida per sviluppatori di inserimento batch.

Area di lavoro DataSet

L'area di lavoro Set di dati all'interno di Experience Platform consente di visualizzare e gestire tutti i set di dati creati dall'organizzazione IMS e di crearne di nuovi.

Visualizzare l'area di lavoro Set di dati facendo clic su Datasets nella barra di navigazione a sinistra. L'area di lavoro Set di dati contiene un elenco di set di dati, tra cui colonne che mostrano nome, data e ora create, origine, schema e ultimo stato batch, nonché la data e l'ora dell'ultimo aggiornamento del set di dati.

Creare un dataset

Per creare un set di dati, fare clic su Create Dataset nell'angolo superiore destro dell'area di lavoro Set di dati.

Nella schermata Create Dataset, selezionare se si desidera "Create Dataset from Schema" o "Create Dataset from CSV File".

Per questa esercitazione, verrà utilizzato uno schema per creare il dataset. Fare clic su Create Dataset from Schema per continuare.

Seleziona schema set di dati

Nella schermata Select Schema, scegliere uno schema facendo clic sul pulsante di scelta accanto allo schema da utilizzare. Per questa esercitazione, il dataset verrà creato utilizzando lo schema Membri fedeltà. L'utilizzo della barra di ricerca per filtrare gli schemi è un modo utile per individuare lo schema esatto che si sta cercando.

Dopo aver selezionato il pulsante di scelta accanto allo schema da utilizzare, fare clic su Next.

Configura set di dati

Nella schermata Configure Dataset, sarà necessario assegnare al dataset un nome e potrebbe anche fornire una descrizione del set di dati.

Note sui nomi dei set di dati:

• I nomi dei set di dati devono essere brevi e descrittivi in modo che il set di dati possa essere facilmente trovato nella libreria in un secondo momento.
• I nomi dei set di dati devono essere univoci, il che significa che devono essere sufficientemente specifici da non essere riutilizzati in futuro.
• È consigliabile fornire informazioni aggiuntive sul set di dati utilizzando il campo di descrizione, in quanto potrebbe aiutare altri utenti a distinguere tra set di dati in futuro.

Una volta che il dataset ha un nome e una descrizione, fare clic su Finish.

Attività DataSet

È stato creato un set di dati vuoto e si è tornati alla scheda Dataset Activity nell'area di lavoro Set di dati. Il nome del set di dati deve essere visualizzato nell’angolo in alto a sinistra dell’area di lavoro, insieme alla notifica che "Non sono stati aggiunti batch". Questo è previsto perché non avete ancora aggiunto alcun batch a questo set di dati.

Sul lato destro dell'area di lavoro Set di dati viene visualizzata la scheda Info contenente informazioni relative al nuovo set di dati come ID dataset, nome, descrizione, nome tabella, schema, streaming e origine. La scheda Informazioni include inoltre informazioni sulla data di creazione del set di dati e sulla data dell'ultima modifica.

Nella scheda Informazioni è presente anche un interruttore Profile che viene utilizzato per abilitare il dataset per l'uso con Real-time Customer Profile. L'utilizzo di questa attivazione e Real-time Customer Profile verrà descritto più dettagliatamente nella sezione che segue.

Abilita set di dati per Real-time Customer Profile

I set di dati vengono utilizzati per l'assimilazione di dati in Experience Platform e tali dati vengono utilizzati per identificare individui e unire insieme informazioni provenienti da più origini. Le informazioni unite vengono denominate Real-Time Customer Profile. Affinché Platform sappia quali informazioni includere nella Real-Time Profile, i set di dati possono essere contrassegnati per l'inclusione utilizzando l'interruttore Profile.

Per impostazione predefinita, questa opzione è disattivata. Se si sceglie di attivare Profile, tutti i dati inseriti nel dataset verranno utilizzati per identificare un singolo e unire insieme il relativo Real-Time Profile.

Per ulteriori informazioni su Real-time Customer Profile e sull'utilizzo delle identità, consultare la documentazione relativa al Servizio identità.

Per abilitare il set di dati per Real-time Customer Profile, fare clic sull'opzione Profile nella scheda Info.

Viene visualizzata una finestra di dialogo in cui viene richiesto di confermare che si desidera abilitare il dataset per Real-time Customer Profile.

Fare clic su Enable e l'interruttore diventa blu, a indicare che è attivato.

Aggiungere dati al dataset

I dati possono essere aggiunti in un set di dati in diversi modi. Potete scegliere di utilizzare le Data Ingestion API o un partner ETL come Unifi o Informatica. Per questa esercitazione, i dati verranno aggiunti al dataset utilizzando la scheda Add Data nell'interfaccia utente.

Per iniziare ad aggiungere dati al dataset, fare clic sulla scheda Add Data. È ora possibile trascinare e rilasciare i file o cercare nel computer i file da aggiungere.

Caricare un file

Dopo aver trascinato e rilasciato (o sfogliare e selezionare) un file Parquet o JSON che si desidera caricare, Platform inizierà immediatamente a elaborare il file e nella scheda Uploading verrà visualizzata una finestra di dialogo che mostra l'avanzamento del caricamento del file.Add Data

Metriche DataSet

Al termine del caricamento del file, nella scheda Dataset Activity non viene più visualizzato "Nessun batch aggiunto". Al contrario, la scheda Dataset Activity ora mostra le metriche del set di dati. Tutte le metriche mostreranno "0" in questa fase perché il batch non è ancora caricato.

Nella parte inferiore della scheda è presente un elenco che mostra la Batch ID dei dati appena acquisiti tramite il processo "Add data to dataset". Sono incluse anche le informazioni relative al batch, inclusa la data di acquisizione, il numero di record acquisiti e lo stato corrente del batch.

Dettagli batch

Fare clic su Batch ID per visualizzare un Batch Overview, mostrando ulteriori dettagli relativi al batch. Al termine del caricamento del batch, le informazioni relative al batch verranno aggiornate per mostrare il numero di record acquisiti e la dimensione del file. Anche lo stato diventa "Success" o "Failed" (Successo). Se il batch non riesce, la sezione Error Code conterrà dettagli relativi a eventuali errori durante l'assimilazione.

Per ulteriori informazioni e domande frequenti sull'inserimento di batch, consultare la Guida alla risoluzione dei problemi di inserimento di batch.

Per tornare alla schermata Dataset Activity, fare clic sul nome del set di dati (Loyalty Details) nella breadcrumb.

Anteprima set di dati

Una volta pronto il set di dati, nella parte superiore della scheda Dataset Activity viene visualizzata l'opzione Preview Dataset.

Fare clic su Preview Dataset per aprire una finestra di dialogo che mostra i dati di esempio dall'interno del dataset. Se il set di dati è stato creato utilizzando uno schema, i dettagli per lo schema del set di dati verranno visualizzati sul lato sinistro dell'anteprima. È possibile espandere lo schema utilizzando le frecce per visualizzare la struttura dello schema. Ogni intestazione di colonna nei dati di anteprima rappresenta un campo nel dataset.

Passaggi successivi e risorse aggiuntive

Dopo aver creato un dataset e aver correttamente inserito i dati in Experience Platform, è possibile ripetere questi passaggi per creare un nuovo dataset o per inserire più dati nel dataset esistente.

Per saperne di più sull'inserimento in batch, leggere la Panoramica sull'inserimento in batch e completare l'apprendimento guardando il video sottostante.