Crea una connessione in streaming HTTP API tramite l'interfaccia utente

Questa esercitazione fornisce i passaggi per la creazione di una connessione a un'origine di streaming utilizzando l'area di lavoro Sources.

Introduzione

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

Creare una connessione in streaming

Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini con cui è 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 Streaming, selezionare API HTTP, quindi Aggiungi dati.

catalogo

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

Account esistente

Per utilizzare un account esistente, seleziona l'account API HTTP con cui vuoi creare un nuovo flusso di dati, quindi seleziona Avanti per continuare.

account-esistente

Nuovo account

Se stai creando un nuovo account, seleziona Nuovo account. Nel modulo di input visualizzato, fornisci un nome account e una descrizione facoltativa. È inoltre possibile specificare le seguenti proprietà di configurazione:

  • Autenticazione: Questa proprietà determina se la connessione streaming richiede o meno l'autenticazione. L’autenticazione garantisce 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.
  • Compatibile con XDM: Questa proprietà indica se la connessione di streaming invierà eventi compatibili con gli schemi XDM. Per impostazione predefinita, questa proprietà è disattivata.

Al termine, selezionare Connetti all'origine, quindi selezionare Avanti per continuare.

nuovo-account

Selezionare i dati

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

Seleziona Carica file per caricare i dati. In alternativa, è possibile trascinare e rilasciare i dati nella sezione Trascinare i file dell'interfaccia.

add-data

Con i dati caricati, puoi utilizzare il lato destro dell’interfaccia per visualizzare in anteprima la gerarchia dei file. Seleziona Avanti per procedere.

preview-sample-data

Mappare i campi dati su uno schema XDM

Viene visualizzato il passaggio Mappatura che fornisce un'interfaccia per mappare i dati di origine su un set di dati di Platform.

L'origine HTTP API supporta l'acquisizione di file JSON. I file JSON non richiedono la configurazione manuale se sono contrassegnati come XDM-complaints. In caso contrario, devi configurare esplicitamente la mappatura.

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

Creare un nuovo set di dati

Per creare un nuovo set di dati, selezionare Nuovo set di dati. Nel modulo visualizzato, fornisci il nome, una descrizione facoltativa e lo schema di destinazione per il set di dati. Se si seleziona uno schema abilitato per Profile, è possibile scegliere se anche il set di dati deve essere abilitato per Profile.

nuovo-set di dati

Usa un set di dati esistente

Per utilizzare un set di dati esistente, selezionare Set di dati esistente. Nella maschera visualizzata selezionare il set di dati che si desidera utilizzare. Dopo aver selezionato un set di dati, puoi scegliere se il set di dati deve essere abilitato per Profile.

set di dati esistente

Mappa campi standard

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 mapper e dei campi calcolati, consulta la guida dell'interfaccia utente della preparazione dati.

Per aggiungere un nuovo campo di origine, selezionare Aggiungi nuova mappatura.

aggiungi-nuovo-mapping

Viene visualizzata una nuova coppia di campi sorgente e di destinazione. Per aggiungere un nuovo campo di origine, selezionare l'icona freccia accanto alla barra di input Seleziona campo di origine.

select-source-field

Il pannello Seleziona attributi 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, seleziona Seleziona per continuare.

select-attributes

Con un campo sorgente selezionato, ora puoi identificare il campo XDM di destinazione appropriato a cui eseguire il mapping. Seleziona l’icona schema nella sezione del campo di destinazione.

select-target-field

Viene visualizzata la finestra Mappa il campo di origine al campo di destinazione, che fornisce un'interfaccia per esplorare lo schema del set di dati di destinazione. Seleziona il campo di destinazione che corrisponde al campo di origine, quindi seleziona Seleziona per continuare.

mappa-campo-destinazione

Una volta mappati tutti i campi sorgente ai campi XDM di destinazione appropriati, seleziona Successivo

preparazione dati-completata

Dettaglio del flusso di dati

Viene visualizzato il passaggio Dettagli flusso di dati. In questa pagina puoi fornire dettagli per il flusso di dati creato assegnando un nome e una descrizione facoltativa.

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

dettagli flusso di dati

Controlla

Viene visualizzato il passaggio Rivedi, che consente di rivedere i dettagli del flusso di dati prima che venga creato. I dettagli sono raggruppati nelle seguenti categorie:

  • Connessione: mostra il nome dell'account, la piattaforma di origine e il nome dell'origine.
  • Assegna set di dati e mappa campi: mostra il set di dati di destinazione e lo schema a cui il set di dati è conforme.

Dopo aver confermato che i dettagli sono corretti, selezionare Fine.

revisione

Ottieni URL endpoint di streaming

Una volta creata la connessione, viene visualizzata la pagina dei dettagli delle origini. Questa pagina mostra i dettagli della connessione appena creata, inclusi i flussi di dati, l’ID e l’URL dell’endpoint di streaming eseguiti in precedenza.

endpoint

Passaggi successivi

Seguendo questa esercitazione, è stata creata una connessione HTTP di streaming che consente di utilizzare l'endpoint di streaming per accedere a diverse API Data Ingestion. Per istruzioni su come creare una connessione in streaming nell'API, consulta l'esercitazione sulla creazione di una connessione in streaming.

Per informazioni su come inviare dati a Platform in streaming, leggi l'esercitazione su dati di streaming serie temporale o l'esercitazione su dati di streaming record.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089