[Beta]{class="badge informative"}

Crea una connessione di origine e un flusso di dati per inviare in streaming i dati di YOURSOURCE tramite l'interfaccia utente

Sostituire o eliminare tutti i paragrafi in corsivo a partire da questo modello.

Per iniziare, aggiorna i metadati (titolo e descrizione) nella parte superiore della pagina. Ignora tutte le istanze di UICONTROL in questa pagina. Questo tag aiuta i nostri processi di traduzione automatica a tradurre correttamente la pagina nelle diverse lingue supportate. Dopo l'invio aggiungeremo i tag alla documentazione.

Questo tutorial illustra i passaggi per la creazione di un connettore di origine YOURSOURCE tramite l'interfaccia utente di Experience Platform.

Panoramica

Fornisci una breve panoramica della tua azienda, compreso il valore che offre ai clienti. Includi un collegamento alla home page della documentazione del prodotto, per ulteriori informazioni.

IMPORTANT
Il connettore di origine e la pagina della documentazione vengono creati e gestiti dal team YOURSOURCE. Per eventuali richieste di informazioni o richieste di aggiornamento, è possibile contattarle direttamente all'indirizzo Inserire il collegamento o l'indirizzo di posta elettronica a cui è possibile accedere per gli aggiornamenti.

Prerequisiti

Aggiungere informazioni in questa sezione su qualsiasi elemento di cui i clienti devono essere a conoscenza prima di iniziare a configurare l'origine nell'interfaccia utente di Adobe Experience Platform. Informazioni su:

  • da aggiungere a un elenco consentiti
  • requisiti per l'hashing delle e-mail
  • qualsiasi specifica account sul tuo lato
  • come ottenere le credenziali di autenticazione per connettersi alla piattaforma

Raccogli le credenziali richieste

Per connettere YOURSOURCE ad Experience Platform, è necessario fornire i valori per le proprietà di connessione seguenti:

Credenziali
Descrizione
Esempio
credenziali uno
Aggiungere qui una breve descrizione alle credenziali di autenticazione dell'origine
Aggiungi qui un esempio delle credenziali di autenticazione dell'origine
credenziali due
Aggiungere qui una breve descrizione alle credenziali di autenticazione dell'origine
Aggiungi qui un esempio delle credenziali di autenticazione dell'origine
credenziali tre
Aggiungere qui una breve descrizione alle credenziali di autenticazione dell'origine
Aggiungi qui un esempio delle credenziali di autenticazione dell'origine

Per ulteriori informazioni su queste credenziali, vedere la documentazione relativa all'autenticazione di YOURSOURCE. Aggiungi qui il collegamento alla documentazione di autenticazione della tua piattaforma.

Integra YOURSOURCE con il tuo webhook

Streaming SDK richiede che l'origine supporti i webhook per comunicare con Experience Platform. In questa sezione è necessario specificare i passaggi che gli utenti dovranno seguire per integrare YOURSOURCE con un webhook.

Connetti il tuo account YOURSOURCE

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 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 YOURSOURCE, quindi Aggiungi dati.

TIP
Di seguito sono riportati alcuni esempi di schermate. Durante la creazione della documentazione, sostituisci le immagini con le schermate della sorgente effettiva. È possibile utilizzare lo stesso motivo e colore di marcatura, nonché gli stessi nomi di file. Assicurati che la schermata acquisisca l’intera schermata dell’interfaccia utente di Experience Platform. Per informazioni su come caricare le schermate, consulta la guida in invio della documentazione per la revisione.

Catalogo origini Experience Platform

Selezionare i dati

Viene visualizzato il passaggio Seleziona dati, che fornisce un'interfaccia per la selezione dei dati da portare in Experience Platform.

  • La parte sinistra dell’interfaccia è un browser che ti consente di visualizzare i flussi di dati disponibili all’interno del tuo account;
  • La parte destra dell’interfaccia consente di visualizzare in anteprima fino a 100 righe di dati da un file JSON.

Seleziona Carica file per caricare un file JSON dal sistema locale. In alternativa, puoi trascinare e rilasciare il file JSON da caricare nel pannello Trascina i file.

Passaggio Aggiungi dati del flusso di lavoro origini.

Una volta caricato il file, l’interfaccia di anteprima si aggiorna e mostra un’anteprima dello schema caricato. L’interfaccia di anteprima consente di esaminare il contenuto e la struttura di un file. È inoltre possibile utilizzare l'utilità Cerca campo per accedere a elementi specifici dallo schema.

Al termine, selezionare Avanti.

Passaggio di anteprima del flusso di lavoro origini.

Dettaglio del flusso di dati

Viene visualizzato il passaggio Dettagli flusso di dati che fornisce le opzioni per utilizzare un set di dati esistente o stabilirne uno nuovo per il flusso di dati, nonché l'opportunità di fornire un nome e una descrizione per il flusso di dati. Durante questo passaggio, puoi anche configurare le impostazioni per l’acquisizione del profilo, la diagnostica degli errori, l’acquisizione parziale e gli avvisi.

Al termine, selezionare Avanti.

Passaggio del flusso di dati dei dettagli del flusso di lavoro delle origini.

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.

Experience Platform fornisce consigli intelligenti per campi mappati automaticamente in base allo schema o al set di dati di destinazione selezionato. Puoi regolare manualmente le regole di mappatura in base ai tuoi casi d’uso. 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.

Una volta mappati correttamente i dati di origine, seleziona Avanti.

Passaggio di mappatura del flusso di lavoro di origine.

Rivisione

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

  • Connessione: mostra il tipo di origine, il percorso pertinente del file di origine scelto e la quantità di colonne all'interno di tale file di origine.
  • Assegna set di dati e mappa i campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui il set di dati aderisce.

Dopo aver rivisto il flusso di dati, fai clic su Fine e attendi un po' di tempo per la creazione del flusso di dati.

Passaggio di revisione del flusso di lavoro origini.

Ottieni l’URL dell’endpoint di streaming

Una volta creato il flusso di dati di streaming, ora puoi recuperare l’URL dell’endpoint di streaming. Questo endpoint verrà utilizzato per abbonarsi al webhook, consentendo alla tua origine di streaming di comunicare con Experience Platform.

Per recuperare l'endpoint di streaming, vai alla pagina Attività flusso di dati del flusso di dati appena creato e copia l'endpoint dalla parte inferiore del pannello Proprietà.

Endpoint di streaming nellattività del flusso di dati.

Passaggi successivi

I flussi di lavoro per i passaggi rimanenti della creazione di un flusso di dati sono modulari. In caso di chiamate specifiche che si desidera effettuare per quanto riguarda la propria origine, vedere la sezione Risorse aggiuntive di seguito.

Seguendo questa esercitazione, hai stabilito una connessione al tuo account YOURSOURCE. Ora puoi continuare con l'esercitazione successiva e configurare un flusso di dati per inserire dati in Experience Platform.

Risorse aggiuntive

Questa è una sezione facoltativa in cui puoi fornire ulteriori collegamenti alla documentazione del tuo prodotto o qualsiasi altro passaggio, schermata, sfumature che ritieni importanti per il successo del cliente. È possibile utilizzare questa sezione per aggiungere informazioni o suggerimenti sull'intero flusso di lavoro dell'origine, soprattutto se sono presenti particolari "gotchas" che un utente finale potrebbe incontrare.

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