Beta

Creare un Chatlio connessione sorgente nell’interfaccia utente

NOTE
Il Chatlio sorgente in versione beta. Leggi le panoramica sulle origini per ulteriori informazioni sull’utilizzo di fonti etichettate beta.

Questo tutorial descrive i passaggi necessari per creare Chatlio connessione sorgente mediante l’interfaccia utente di Adobe Experience Platform.

Introduzione getting-started

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

Prerequisiti prerequisites

La sezione seguente fornisce informazioni sui prerequisiti da completare prima di poter creare un Chatlio connessione sorgente.

JSON di esempio per definire lo schema di origine per Chatlio prerequisites-json-schema

Prima di creare un Chatlio connessione di origine, sarà necessario specificare uno schema di origine. Puoi utilizzare il codice JSON qui sotto.

{
  "visitor": {
    "email": "test@example.com",
    "UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
  },
   "message": "Hi",
  "channelId": "C04J7M7LCMQ",
  "slackChannelName": "aep",
  "slackChannelId": "C04JVR71WKS"
}

Creare uno schema di Platform per Chatlio create-platform-schema

Devi anche assicurarti di creare uno schema Platform da utilizzare per la tua origine. Leggi l’esercitazione su creazione di uno schema di Platform per passaggi completi sulla creazione di uno schema.

L’interfaccia utente di Platform mostra un esempio di schema per il catalogo

Connetti Chatlio account connect-account

Nell’interfaccia utente di Platform, seleziona Sorgenti dalla barra di navigazione a sinistra per accedere al Sorgenti e visualizzare un catalogo delle origini disponibili in Experienci Platform.

Utilizza il Categorie per filtrare le sorgenti per categoria. In alternativa, immettere un nome di origine nella barra di ricerca per trovare un'origine specifica dal catalogo.

Vai a Automazione del marketing categoria per visualizzare Chatlio scheda sorgente. Per iniziare, seleziona Aggiungi dati.

Catalogo dell’interfaccia utente di Platform con scheda Catalogo

Selezionare i dati select-data

Il Seleziona dati viene visualizzata un’interfaccia che consente di selezionare i dati da inserire in 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 nella Trascinare i file pannello.

Il 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 Campo di ricerca per accedere a elementi specifici dallo schema.

Al termine, seleziona Successivo.

Passaggio di anteprima del flusso di lavoro origini.

Dettaglio del flusso di dati dataflow-detail

Il Dettagli del flusso di dati Questo passaggio ti 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, seleziona Successivo.

Passaggio del flusso di dati dettagliato del flusso di lavoro sorgenti.

Mappatura mapping

Il Mappatura viene visualizzato un passaggio che fornisce un’interfaccia per mappare i campi sorgente dallo schema sorgente ai campi XDM di destinazione appropriati nello schema di destinazione.

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, vedi la Guida dell’interfaccia utente per la preparazione dati.

Le mappature elencate di seguito sono obbligatorie e devono essere configurate prima di procedere alla Revisione fase.

Campo di destinazione
Descrizione
UUID
Il Chatlio identificatore dell’evento.

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

Passaggio di mappatura del flusso di lavoro origini.

Revisione review

Il Revisione viene visualizzato un passaggio che consente di rivedere il nuovo flusso di dati prima di crearlo. 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 campi: mostra in quale set di dati vengono acquisiti i dati di origine, incluso lo schema a cui aderisce il set di dati.

Dopo aver rivisto il flusso di dati, seleziona Fine e lascia un po’ di tempo per creare il flusso di dati.

Passaggio di revisione del flusso di lavoro origini.

Ottieni l’URL dell’endpoint di streaming get-streaming-endpoint-url

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 Experienci Platform.

Per creare l’URL utilizzato per configurare il webhook su Chatlio è necessario recuperare quanto segue:

  • ID flusso di dati
  • Endpoint di streaming

Per recuperare ID flusso di dati e Endpoint di streaming, passare alla Attività flusso di dati pagina del flusso di dati appena creato e copia i dettagli dalla parte inferiore della sezione Proprietà pannello.

Endpoint di streaming nell’attività del flusso di dati.

Dopo aver recuperato l’endpoint di streaming e l’ID del flusso di dati, crea un URL in base al seguente pattern: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Ad esempio, un URL del webhook costruito potrebbe avere l’aspetto di: https://dcs.adobedc.net/collection/d56b47ee3985104beaf724efcd78a3e1a863d720471a482bebac0acc1ab95983

Configurazione webhook in Chatlio set-up-webhook

Dopo aver creato l’URL del webhook, puoi configurarlo utilizzando Chatlio dell'utente.

Accedi al tuo Chatlio account e follow la guida alla configurazione e all'installazione per creare un widget.

Una volta creato un widget, passa alla pagina delle impostazioni del widget per aggiungere l’URL del webhook a tale widget.

La pagina delle impostazioni del webhook su Chatlio.

Quindi, seleziona la Behavior e aggiungi l’URL del webhook al Webhook when a new conversation starts e qualsiasi altro campo di eventi webhook a cui desideri iscriverti.

Interfaccia utente di Chatlio che mostra il campo dell’endpoint del webhook.

TIP
È possibile iscriversi a diversi eventi per Chatlio webhook. Per ulteriori informazioni sui diversi eventi, consulta Chatlio documentazione sugli eventi.

Passaggi successivi next-steps

Seguendo questa esercitazione hai configurato correttamente un flusso di dati in streaming per portare Chatlio dati di Experience Platform. Per monitorare i dati che vengono acquisiti, consulta la guida su monitoraggio dei flussi di dati in streaming tramite l’interfaccia utente di Platform.

Risorse aggiuntive additional-resources

Le sezioni seguenti forniscono ulteriori risorse a cui puoi fare riferimento quando utilizzi il Chatlio sorgente.

Convalida validation

Per verificare di aver impostato correttamente l’origine e Chatlio I messaggi vengono acquisiti, effettua le seguenti operazioni:

  • Puoi controllare la Chatlio Rapporti > Cronologia chat per identificare gli eventi acquisiti da Chatlio.

Schermata dell’interfaccia utente di Chatlio che mostra la cronologia della chat

  • Nell’interfaccia utente di Platform, seleziona Visualizza flussi di dati accanto al Chatlio nel catalogo sorgenti. Quindi, seleziona Anteprima set di dati per verificare i dati acquisiti per i webhook configurati in Chatlio.

Schermata dell’interfaccia utente di Platform che mostra gli eventi acquisiti

Per ulteriori informazioni su Chatlio, visita il Chatlio documentazione e Domande frequenti.

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