Creare un connettore di origine per il caricamento di file locale nell’interfaccia utente

Ultimo aggiornamento: 4 aprile 2025
  • Argomenti:

Creato per:

  • Sviluppatore

Questo tutorial illustra i passaggi necessari per creare un connettore di origine per il caricamento di file locale con cui acquisire i file locali in Experience Platform utilizzando l’interfaccia utente.

Introduzione

Questo tutorial richiede una buona conoscenza dei seguenti componenti di Experience Platform:

Carica file locali in Experience Platform

Nell'interfaccia utente di Experience Platform, seleziona Origini dalla barra di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini per le quali è possibile creare un account.

Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.

Nella categoria Sistema locale, selezionare Caricamento file locale, quindi selezionare Aggiungi dati.

catalogo

Usa un set di dati esistente

La pagina Dettagli flusso di dati consente di scegliere se acquisire i dati CSV in un set di dati esistente o in un nuovo set di dati.

Per acquisire i dati CSV in un set di dati esistente, seleziona Set di dati esistente. Puoi recuperare un set di dati esistente utilizzando l'opzione Ricerca avanzata oppure scorrendo l'elenco dei set di dati esistenti nel menu a discesa.

Con un set di dati selezionato, fornisci un nome per il flusso di dati e una descrizione facoltativa.

Durante questo processo, puoi anche abilitare Diagnostica errori e Acquisizione parziale. Diagnostica errori consente la generazione di messaggi di errore dettagliati per eventuali record errati che si verificano nel flusso di dati, mentre L'acquisizione parziale consente di acquisire dati contenenti errori, fino a una determinata soglia definita manualmente. Per ulteriori informazioni, consulta la panoramica sull'acquisizione batch parziale.

set di dati esistente

Utilizza un nuovo set di dati

Per acquisire i dati CSV in un nuovo set di dati, seleziona Nuovo set di dati, quindi fornisci un nome per il set di dati di output e una descrizione facoltativa. Quindi, seleziona uno schema a cui mappare utilizzando l'opzione Ricerca avanzata o scorrendo l'elenco degli schemi esistenti nel menu a discesa.

Con uno schema selezionato, fornisci un nome per il flusso di dati e una descrizione facoltativa, quindi applica le impostazioni Diagnostica errori e Acquisizione parziale desiderate per il flusso di dati. Al termine, selezionare Avanti.

nuovo-set di dati

Selezionare i dati

Viene visualizzato il passaggio Seleziona dati, che fornisce un'interfaccia per caricare i file locali e visualizzarne in anteprima la struttura e il contenuto. Seleziona Scegli i file per caricare un file CSV dal tuo sistema locale. In alternativa, puoi trascinare e rilasciare il file CSV da caricare nel pannello Trascina i file.

SUGGERIMENTO
Al momento solo i file CSV sono supportati dal caricamento di file locali. La dimensione massima del file per ogni file è di 1 GB.

choose-files

Una volta caricato il file, l’interfaccia di anteprima viene aggiornata per visualizzarne il contenuto e la struttura.

preview-sample-data

A seconda del file, è possibile selezionare un delimitatore di colonna come tabulazioni, virgole, barre verticali o un delimitatore di colonna personalizzato per i dati di origine. Selezionare la freccia a discesa Delimitatore, quindi selezionare il delimitatore appropriato dal menu.

Al termine, selezionare Avanti.

delimitatore

Mappatura

Viene visualizzato il passaggio Mappatura che fornisce un'interfaccia per mappare i campi sorgente dallo schema sorgente ai campi XDM di destinazione appropriati nello schema di destinazione.

In base alle tue esigenze, puoi scegliere di mappare i campi direttamente o utilizzare le funzioni di preparazione dati per trasformare i dati sorgente in modo da derivare valori calcolati o calcolati. Per i passaggi completi sull'utilizzo dell'interfaccia di mappatura, consulta la Guida dell'interfaccia utente della preparazione dati.

Quando i set di mappatura sono pronti, seleziona Fine e consenti la creazione del nuovo flusso di dati per alcuni istanti.

mappatura

Monitorare l’acquisizione dei dati

Una volta mappato e creato il file CSV, puoi monitorare i dati che vengono acquisiti tramite di esso utilizzando il dashboard di monitoraggio. Per ulteriori informazioni, consulta l'esercitazione sui flussi di dati delle origini di monitoraggio nell'interfaccia utente.

Passaggi successivi

Seguendo questa esercitazione, hai mappato correttamente un file CSV semplice su uno schema XDM e lo hai acquisito in Experience Platform. Questi dati possono ora essere utilizzati dai servizi Experience Platform downstream come Real-Time Customer Profile. Per ulteriori informazioni, vedere la panoramica di Real-Time Customer Profile.

Pagina precedenteShopify Streaming
Pagina successivaBraze Currents

Experience Platform