[Beta]{class="badge informative"}

Crea un flusso di dati della connessione di origine Pendo e nell'interfaccia utente

Questo tutorial illustra i passaggi per la creazione di una connessione di origine Pendo e di un 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:

Prerequisiti prerequisites

Nella sezione seguente vengono fornite informazioni sui prerequisiti da completare prima di creare una connessione di origine Pendo.

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

Prima di creare una connessione di origine Pendo, è 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 la Pendo guida sui webhook.

Crea uno schema di Platform per Pendo create-platform-schema

Devi anche assicurarti di creare prima uno schema Platform da utilizzare per la tua origine. Consulta il tutorial su creazione di uno schema di Platform per i passaggi completi sulla creazione di uno schema.

Connetti il tuo account Pendo connect-account

Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini e visualizzare un catalogo delle origini disponibili in Experience Platform.

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

Vai alla categoria Analytics per visualizzare la scheda di origine Pendo. Per iniziare, selezionare Aggiungi dati.

Selezionare i dati select-data

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

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.

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.

Dettaglio del flusso di dati dataflow-detail

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.

Mappatura mapping

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.

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.

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

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

Controlla review

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:

Dopo aver rivisto il flusso di dati, seleziona Fine e attendi che venga creato un po' di tempo.

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

Per creare l'URL utilizzato per configurare il webhook in Pendo, è necessario recuperare quanto segue:

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

Dopo aver recuperato l'endpoint di streaming e l'ID del flusso di dati, generare 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 seguente: https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95

Configura webhook in Pendo set-up-webhook

Quindi, accedi al tuo account il Pendo e crea un webhook. Per i passaggi su come creare un webhook utilizzando l'interfaccia utente Pendo, fare riferimento alla Pendo guida sulla creazione di un webhook.

Una volta creato il webhook, passare alla pagina delle impostazioni del webhook Pendo e immettere l'URL del webhook nel campo URL.

Passaggi successivi next-steps

Seguendo questa esercitazione hai configurato correttamente un flusso di dati in streaming per portare i tuoi dati di Pendo all'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 fare riferimento quando si utilizza l'origine Pendo.

Convalida validation

Per verificare la corretta configurazione dell'origine e l'acquisizione di Pendo messaggi, effettua le seguenti operazioni:

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 il mapping uniqueID sia stato configurato. Per ulteriori informazioni, consulta la sezione Mapping.

Per ulteriori informazioni, visitare il Pendo Centro assistenza.