Creare una connessione in streaming tramite l’interfaccia utente

Questa esercitazione descrive i passaggi necessari per creare una connessione sorgente in streaming utilizzando l’area di lavoro Sources.

Introduzione

Questa esercitazione richiede una buona comprensione dei seguenti componenti di Adobe Experience Platform:

  • Experience Data Model (XDM) Sistema: Il framework standardizzato in base al quale Experience Platform vengono organizzati i dati sulla customer experience.
    • Nozioni di base sulla composizione dello schema: Scopri i blocchi di base degli schemi XDM, inclusi i principi chiave e le best practice nella composizione dello schema.
    • Esercitazione dell’Editor di schema: Scopri come creare schemi personalizzati utilizzando l’interfaccia utente dell’Editor di schema.
  • Real-time Customer Profile: Fornisce un profilo di consumatore unificato e in tempo reale basato su dati aggregati provenienti da più origini.

Creare una connessione in streaming

Nell’interfaccia utente di Platform, seleziona Sources dal menu di navigazione a sinistra per accedere all’area di lavoro Sources. Nella schermata Catalog sono visualizzate diverse sorgenti con cui è possibile creare un account.

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

Sotto la categoria Streaming, selezionare HTTP API, quindi selezionare Add data.

catalogo

Viene visualizzata la pagina Connect HTTP API account . In questa pagina è possibile utilizzare le nuove credenziali o le credenziali esistenti.

Account esistente

Per utilizzare un account esistente, seleziona l’account API HTTP con cui desideri creare un nuovo flusso di dati, quindi seleziona Next per procedere.

account esistente

Nuovo account

Se stai creando un nuovo account, seleziona New account. Nel modulo di input visualizzato, specificare un nome account e una descrizione facoltativa. Otterrai anche la possibilità di fornire le seguenti proprietà di configurazione:

  • Authentication: questa proprietà determina se la connessione in streaming richiede o meno l’autenticazione. L'autenticazione assicura che i dati vengano raccolti da fonti attendibili. Se hai a che fare con Informazioni personali (PII, Personally Identifiable Information), devi attivare questa proprietà. Per impostazione predefinita, questa proprietà è disattivata.
  • XDM compatible: Questa proprietà indica se questa connessione streaming invierà eventi compatibili con gli schemi XDM. Per impostazione predefinita, questa proprietà è disattivata.

Al termine, selezionare Connect to source, quindi selezionare Next per continuare.

nuovo account

Seleziona dati

Dopo aver creato la connessione HTTP API, viene visualizzato il passaggio Select data , che fornisce un’interfaccia per caricare e visualizzare in anteprima i dati.

Seleziona Upload files per caricare i dati. In alternativa, puoi trascinare i dati nella sezione Drag and drop files dell’interfaccia.

add-data

Con i dati caricati, puoi utilizzare il lato destro dell’interfaccia per visualizzare un’anteprima della gerarchia dei file. Selezionare Next per continuare.

preview-sample-data

Mappatura di campi dati su uno schema XDM

Viene visualizzato il passaggio Mapping , che fornisce un’interfaccia per mappare i dati di origine a un set di dati di Platform.

I file di parquet devono essere conformi a XDM e non richiedono la configurazione manuale della mappatura, mentre i file CSV richiedono la configurazione esplicita della mappatura, ma consentono di scegliere quali campi di dati di origine mappare. I file JSON, se contrassegnati come reclamo XDM, non richiedono la configurazione manuale. Tuttavia, se non è contrassegnato come conforme a XDM, sarà necessario configurare esplicitamente la mappatura.

Scegli un set di dati in entrata in cui acquisire i dati. Puoi utilizzare un set di dati esistente o crearne uno nuovo.

Creare un nuovo set di dati

Per creare un nuovo set di dati, seleziona New dataset. Nel modulo visualizzato, fornisci il nome, una descrizione facoltativa e lo schema di destinazione per il set di dati. Se selezioni uno schema abilitato Profile, puoi scegliere se il set di dati deve essere abilitato anche Profile.

nuovo set di dati

Utilizzare un set di dati esistente

Per utilizzare un set di dati esistente, seleziona Existing dataset. Nel modulo visualizzato, selezionare il set di dati da utilizzare. Dopo aver selezionato un set di dati, puoi scegliere se il set di dati deve essere abilitato Profile.

set di dati esistente

Mappa campi standard

In base alle tue esigenze, puoi scegliere di mappare direttamente i campi oppure utilizzare le funzioni di preparazione dei dati per trasformare i dati di origine in valori calcolati o calcolati. Per ulteriori informazioni sulla mappatura dei dati e sulle funzioni di mappatura, consulta l’esercitazione sulla mappatura dei dati CSV nei campi dello schema XDM.

Per aggiungere un nuovo campo di origine, selezionare Add new mapping.

add-new-mapping

Viene visualizzata una nuova associazione di campi di origine e campo di destinazione. Per aggiungere un nuovo campo sorgente, seleziona l’icona a forma di freccia accanto alla barra di input Select source field.

select-source-field

Il pannello Select attributes ti consente di esplorare la gerarchia dei file e selezionare un campo di origine specifico da mappare a un campo XDM di destinazione. Dopo aver selezionato il campo di origine da mappare, selezionare Select per continuare.

select-attributes

Selezionando un campo di origine, ora è possibile identificare il campo XDM di destinazione appropriato da mappare. Seleziona l’icona dello schema nella sezione del campo di destinazione.

select-target-field

Viene visualizzata la finestra Map source field to target field che fornisce un’interfaccia per esplorare lo schema del set di dati di destinazione. Selezionare il campo di destinazione corrispondente al campo di origine, quindi selezionare Select per continuare.

map-to-target-field

Una volta mappati i campi di origine sui campi XDM di destinazione appropriati, seleziona Next

data-prep-complete

Dettaglio flusso di dati

Viene visualizzato il passaggio Dataflow detail . In questa pagina puoi fornire i dettagli del flusso di dati creato assegnando un nome e una descrizione facoltativa.

Dopo aver fornito i dettagli per il flusso di dati, seleziona Next.

dettaglio del flusso di dati

Revisione

Viene visualizzato il passaggio Review , che consente di controllare i dettagli del flusso di dati prima della creazione. I dettagli sono raggruppati nelle seguenti categorie:

  • Connection: Mostra il nome dell’account, la piattaforma di origine e il nome dell’origine.
  • Assign dataset and map fields: Mostra il set di dati di destinazione e lo schema a cui il set di dati aderisce.

Dopo aver confermato che i dettagli sono corretti, seleziona Finish.

revisione

Ottieni URL endpoint di streaming

Con la connessione creata, viene visualizzata la pagina dei dettagli delle sorgenti. Questa pagina mostra i dettagli della nuova connessione appena creata, inclusi i flussi di dati, l’ID e l’URL dell’endpoint di streaming precedentemente eseguiti.

endpoint

Passaggi successivi

Seguendo questa esercitazione, hai creato una connessione HTTP in streaming che ti consente di utilizzare l’endpoint di streaming per accedere a una varietà di API Data Ingestion. Per istruzioni su come creare una connessione in streaming nell'API, leggi l' esercitazione sulla creazione di una connessione in streaming.

Per informazioni su come eseguire lo streaming dei dati su Platform, leggi l’esercitazione su dati in streaming della serie temporale o l’esercitazione su dati in streaming record.

In questa pagina