Creare un Pendo flusso di dati della connessione sorgente e nell’interfaccia utente
Questo tutorial descrive i passaggi necessari per creare Pendo connessione sorgente e flusso di dati tramite l’interfaccia utente di Adobe Experience Platform.
Introduzione getting-started
Questo tutorial richiede una buona conoscenza dei seguenti componenti di 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.
Prerequisiti prerequisites
La sezione seguente fornisce informazioni sui prerequisiti da completare prima di poter creare un Pendo connessione sorgente.
JSON di esempio per definire lo schema di origine per Pendo prerequisites-json-schema
Prima di creare un Pendo connessione di origine, sarà necessario specificare uno schema di origine. Puoi utilizzare il codice JSON qui sotto.
{
"accountId": "58f79ee324d3f",
"timestamp": 1673372516,
"visitorId": "test@test.com",
"uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
"properties": {
"guideProperties": {
"name": "Guide Conversion Test"
}
}
}
Per ulteriori informazioni, leggere Pendo guida sui webhook.
Creare uno schema di Platform per Pendo create-platform-schema
Devi anche assicurarti di creare prima uno schema Platform da utilizzare per la tua origine. Guarda il tutorial su creazione di uno schema di Platform per passaggi completi sulla creazione di uno schema.
Connetti Pendo 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 Analytics categoria per visualizzare Pendo scheda sorgente. Per iniziare, seleziona Aggiungi dati.
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.
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.
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.
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.
uniqueId
Una volta mappati correttamente i dati di origine, seleziona Successivo.
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.
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 Pendo è 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.
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/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95
Configurazione webhook in Pendo set-up-webhook
Quindi, accedi al tuo account su Pendo e creare un webhook. Per i passaggi su come creare un webhook utilizzando Pendo dell'interfaccia utente, fare riferimento al Pendo guida alla creazione di webhook.
Una volta creato il webhook, accedi alla pagina delle impostazioni del Pendo e immettere l'URL del webhook nel URL campo.
Passaggi successivi next-steps
Seguendo questa esercitazione hai configurato correttamente un flusso di dati in streaming per portare Pendo 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 Pendo sorgente.
Convalida validation
Per verificare di aver impostato correttamente l’origine e Pendo I messaggi vengono acquisiti, effettua le seguenti operazioni:
- Puoi controllare la Pendo Rapporti > Cronologia chat per identificare gli eventi acquisiti da Pendo.
- Nell’interfaccia utente di Platform, seleziona Visualizza flussi di dati accanto al Pendo nel catalogo sorgenti. Quindi, seleziona Anteprima set di dati per verificare i dati acquisiti per i webhook configurati in Pendo.
Errori e risoluzione problemi errors-and-troubleshooting
Durante il controllo di un’esecuzione del flusso di dati, è possibile che venga visualizzato il seguente messaggio di errore: The message can't be validated ... uniqueID:expected minLength:1, actual 0].
Per correggere questo errore, è necessario verificare che uniqueID la mappatura è stata impostata. Per ulteriori informazioni, consulta Mappatura sezione.
Per ulteriori informazioni, visitare il Pendo Centro risorse.