Creare un HTTP API connessione in streaming tramite l’interfaccia utente
Questa esercitazione descrive i passaggi per la creazione di una connessione a un'origine di streaming mediante Sorgenti Workspace.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
-
Experience Data Model (XDM) Sistema: il quadro standardizzato mediante il quale Experience Platform organizza i dati sull’esperienza del cliente.
- Nozioni di base sulla composizione dello schema: scopri gli elementi di base degli schemi XDM, compresi i principi chiave e le best practice nella composizione dello schema.
- Esercitazione sull’editor di schemi: scopri come creare schemi personalizzati utilizzando l’interfaccia utente dell’Editor di schema.
-
Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Creare una connessione in streaming
Nell’interfaccia utente di Platform, seleziona Sorgenti dalla barra di navigazione a sinistra per accedere al Sorgenti Workspace. Il Catalogo Nella schermata vengono 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.
Sotto Streaming categoria, seleziona API HTTP e quindi seleziona Aggiungi dati.
Il Connetti account API HTTP viene visualizzata. In questa pagina è possibile utilizzare nuove credenziali o 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 Successivo per procedere.
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 in 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 in streaming invierà eventi compatibili con gli schemi XDM. Per impostazione predefinita, questa proprietà è disattivata.
Al termine, seleziona Connetti all'origine e quindi seleziona Successivo per procedere.
Selezionare i dati
Dopo aver creato la connessione API HTTP, il Seleziona dati viene visualizzata un'interfaccia per caricare e visualizzare in anteprima i dati.
Seleziona Carica file per caricare i dati. In alternativa, puoi trascinare e rilasciare i dati nel Trascinare i file dell'interfaccia.
Con i dati caricati, puoi utilizzare il lato destro dell’interfaccia per visualizzare in anteprima la gerarchia dei file. Seleziona Avanti per procedere.
Mappare i campi dati su uno schema XDM
Il Mappatura viene visualizzato un passaggio che fornisce un’interfaccia per mappare i dati di origine su un set di dati di Platform.
Il HTTP API L’origine 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, seleziona 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 un Profiledello schema abilitato, puoi scegliere se anche il set di dati deve essere Profile-abilitato.
Usa un set di dati esistente
Per utilizzare un set di dati esistente, seleziona 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 Profile-abilitato.
Mappare i 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, vedi la Guida dell’interfaccia utente per la preparazione dati.
Per aggiungere un nuovo campo di origine, seleziona Aggiungi nuova mappatura.
Viene visualizzata una nuova coppia di campi sorgente e di destinazione. Per aggiungere un nuovo campo di origine, selezionare l'icona freccia accanto al Seleziona campo di origine barra di input.
Il Seleziona attributi Il pannello 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 sorgente da mappare, seleziona Seleziona per procedere.
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.
Il Mappa campo di origine su campo di destinazione viene visualizzata una finestra 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 procedere.
Una volta mappati tutti i campi sorgente ai relativi campi XDM di destinazione appropriati, seleziona Successivo
Dettaglio del flusso di dati
Il Dettagli del flusso di dati viene visualizzato il passaggio. 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 Successivo.
Revisione
Il Revisione viene visualizzato un passaggio che consente di rivedere i dettagli del flusso di dati prima di crearlo. I dettagli sono raggruppati nelle seguenti categorie:
- Connessione: mostra il nome dell’account, la piattaforma di origine e il nome dell’origine.
- Assegnare set di dati e mappare i campi: mostra il set di dati di destinazione e lo schema a cui aderisce il set di dati.
Dopo aver confermato la correttezza dei dettagli, seleziona Fine.
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.
Passaggi successivi
Seguendo questa esercitazione, hai creato una connessione HTTP in streaming, che consente di utilizzare l’endpoint in streaming per accedere a diversi Data Ingestion API. Per istruzioni su come creare una connessione in streaming nell’API, leggi tutorial sulla creazione di una connessione in streaming.
Per informazioni su come inviare dati a Platform in streaming, leggi l’esercitazione su streaming di dati di serie temporali o il tutorial su dati di registrazione streaming.