Inserire dati in Adobe Experience Platform

Adobe Experience Platform consente di importare facilmente i dati in Platform come file batch. Esempi di dati da acquisire possono includere dati di profilo provenienti da un file flat 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, devi disporre dell'accesso a Experience Platform. Se non hai accesso a un'organizzazione IMS in Experience Platform, rivolgiti all'amministratore di sistema prima di procedere.

Se preferisci acquisire dati utilizzando le API di inserimento dati, inizia leggendo la Guida per gli sviluppatori di inserimento in batch.

Area di lavoro dei set di dati

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 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 stato dell’ultimo batch, nonché la data e l’ora dell’ultimo aggiornamento del set di dati.

Creare un set di dati

Per creare un set di dati, fai clic su Create Dataset nell’angolo in alto a destra dell’area di lavoro Set di dati.

Nella schermata Create Dataset, seleziona se desideri "Create Dataset from Schema" o "Create Dataset from CSV File".

Per questa esercitazione, verrà utilizzato uno schema per creare il set di dati. Fai clic su Create Dataset from Schema per continuare.

Seleziona schema set di dati

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

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

Configurare il set di dati

Nella schermata Configure Dataset, ti verrà richiesto di assegnare un nome al set di dati e può 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 anche essere sufficientemente specifici da non essere riutilizzati in futuro.
• È consigliabile fornire informazioni aggiuntive sul set di dati utilizzando il campo descrizione, in quanto potrebbe aiutare altri utenti a distinguere tra set di dati in futuro.

Una volta che il set di dati ha un nome e una descrizione, fai clic su Finish.

Attività set di dati

Ora è stato creato un set di dati vuoto e sei stato riportato alla scheda Dataset Activity nell’area di lavoro Set di dati. Dovresti visualizzare il nome del set di dati nell’angolo in alto a sinistra dell’area di lavoro, insieme a una notifica che indica che non sono stati aggiunti batch. Questo è da aspettarsi, in quanto non hai ancora aggiunto 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 set di dati, nome, descrizione, nome tabella, schema, streaming e origine. La scheda Informazioni include anche informazioni su quando è stato creato il set di dati e la sua ultima data di modifica.

Nella scheda Informazioni è presente anche un'opzione Profile utilizzata per abilitare il set di dati per l'utilizzo con Real-time Customer Profile. L’utilizzo di questa opzione e di Real-time Customer Profile verranno descritti più dettagliatamente nella sezione che segue.

Abilita set di dati per Real-time Customer Profile

I set di dati vengono utilizzati per l’acquisizione di dati in Experience Platform e tali dati vengono utilizzati in ultima analisi per identificare gli individui e unire le informazioni provenienti da più sorgenti. Le informazioni unite si chiamano Real-Time Customer Profile. Affinché Platform sappia quali informazioni includere nel Real-Time Profile, i set di dati possono essere contrassegnati per l’inclusione utilizzando l’opzione Profile.

Per impostazione predefinita, questa opzione è disattivata. Se scegli di attivare Profile, tutti i dati acquisiti nel set di dati verranno utilizzati per identificare un singolo utente e unire i relativi Real-Time Profile.

Per ulteriori informazioni su Real-time Customer Profile e sull’utilizzo delle identità, consulta la documentazione Servizio identità .

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

Viene visualizzata una finestra di dialogo in cui viene richiesto di confermare l’abilitazione del set di dati per Real-time Customer Profile.

Fai clic su Enable e l’interruttore diventa blu e indica che è attivato.

Aggiungere dati al set di dati

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

Per iniziare ad aggiungere dati al set di dati, fai clic sulla scheda Add Data . È ora possibile trascinare e rilasciare i file o cercare nel computer i file che si desidera aggiungere.

Caricare un file

Una volta trascinato e rilasciato (o sfogliato e selezionato) un file Parquet o JSON da caricare, Platform inizierà immediatamente l’elaborazione del file e nella scheda Uploading verrà visualizzata una finestra di dialogo Add Data che mostra l’avanzamento del caricamento del file.

Metriche del set di dati

Al termine del caricamento del file, la scheda Dataset Activity non mostra più che "non sono stati aggiunti batch". Al contrario, la scheda Dataset Activity ora mostra le metriche del set di dati. Tutte le metriche mostrano "0" in questa fase, in quanto il batch non è ancora caricato.

In fondo alla scheda c'è un elenco che mostra la Batch ID dei dati appena acquisiti tramite il processo "Aggiungi dati al set di dati". Sono incluse anche le informazioni relative al batch, tra cui data di acquisizione, numero di record acquisiti e stato del batch corrente.

Dettagli batch

Fai clic su Batch ID per visualizzare un Batch Overview, mostrando ulteriori dettagli relativi al batch. Al termine del caricamento del batch, le informazioni sul batch verranno aggiornate per mostrare il numero di record acquisiti e le dimensioni del file. Lo stato viene modificato anche in "Completato" o "Non riuscito". Se il batch non riesce, la sezione Error Code conterrà i dettagli relativi a eventuali errori durante l'acquisizione.

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

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

Anteprima set di dati

Quando il set di dati è pronto, un’opzione per Preview Dataset viene visualizzata nella parte superiore della scheda Dataset Activity .

Fai clic su Preview Dataset per aprire una finestra di dialogo che mostra i dati di esempio dall’interno del set di dati. Se il set di dati è stato creato utilizzando uno schema, i dettagli dello 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 set di dati.

Passaggi successivi e risorse aggiuntive

Dopo aver creato un set di dati e aver acquisito correttamente i dati in Experience Platform, puoi ripetere questi passaggi per creare un nuovo set di dati o acquisire più dati nel set di dati esistente.

Per ulteriori informazioni sull'acquisizione in batch, leggi la panoramica sull'acquisizione in batch e completa l'apprendimento guardando il video seguente.