[Beta]{class="badge informative"}
Crear un flujo de datos de conexión de origen Pendo y en la interfaz de usuario
Este tutorial proporciona los pasos para crear una conexión de origen y un flujo de datos de Pendo mediante la interfaz de usuario de Adobe Experience Platform.
Introducción getting-started
Este tutorial requiere una comprensión práctica de los siguientes componentes de Experience Platform:
-
Experience Data Model (XDM) Sistema: El marco de trabajo estandarizado mediante el cual Experience Platform organiza los datos de la experiencia del cliente.
- Aspectos básicos de la composición de esquemas: obtenga información sobre los componentes básicos de los esquemas XDM, incluidos los principios clave y las prácticas recomendadas en la composición de esquemas.
- Tutorial del editor de esquemas: Aprenda a crear esquemas personalizados mediante la interfaz de usuario del editor de esquemas.
-
Real-Time Customer Profile: proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
Requisitos previos prerequisites
La siguiente sección proporciona información sobre los requisitos previos que se deben completar para poder crear una conexión de origen de Pendo.
Ejemplo de JSON para definir el esquema de origen de Pendo prerequisites-json-schema
Antes de crear una conexión de origen de Pendo, necesitará que se proporcione un esquema de origen. Puede utilizar el siguiente JSON.
{
"accountId": "58f79ee324d3f",
"timestamp": 1673372516,
"visitorId": "test@test.com",
"uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
"properties": {
"guideProperties": {
"name": "Guide Conversion Test"
}
}
}
Para obtener más información, lea la Pendo guía de webhooks.
Crear un esquema de Experience Platform para Pendo create-platform-schema
También debe asegurarse de crear primero un esquema de Experience Platform para utilizarlo en el origen. Consulte el tutorial de creación de un esquema de Experience Platform para ver los pasos detallados sobre cómo crear un esquema.
Conectar su cuenta de Pendo connect-account
En la interfaz de usuario de Experience Platform, seleccione Sources en el panel de navegación izquierdo para acceder al área de trabajo Sources y ver un catálogo de fuentes disponibles en Experience Platform.
Utilice el menú Categories para filtrar orígenes por categoría. También puede introducir un nombre de origen en la barra de búsqueda para buscar un origen específico del catálogo.
Vaya a la categoría Analytics para ver la tarjeta de origen Pendo. Para empezar, seleccione Add data.
Seleccionar datos select-data
Aparecerá el paso Select data, que proporciona una interfaz para que seleccione los datos que desea llevar a Experience Platform.
- La parte izquierda de la interfaz es un explorador que le permite ver los flujos de datos disponibles en su cuenta;
- La parte derecha de la interfaz de le permite previsualizar hasta 100 filas de datos de un archivo JSON.
Seleccione Upload files para cargar un archivo JSON desde su sistema local. También puede arrastrar y soltar el archivo JSON que desee cargar en el panel Drag and drop files.
Una vez cargado el archivo, la interfaz de vista previa se actualiza para mostrar una vista previa del esquema cargado. La interfaz de vista previa permite inspeccionar el contenido y la estructura de un archivo. También puede usar la utilidad Search field para tener acceso a elementos específicos desde el esquema.
Cuando termine, seleccione Next.
Detalles del flujo de datos dataflow-detail
Aparecerá el paso Detalle del flujo de datos, que le proporcionará opciones para usar un conjunto de datos existente o establecer uno nuevo para su flujo de datos, así como la oportunidad de proporcionar un nombre y una descripción para su flujo de datos. Durante este paso, también puede configurar las opciones de Ingesta de perfiles, diagnósticos de error, ingesta parcial y alertas.
Cuando termine, seleccione Next.
Asignación mapping
Aparecerá el paso Mapping, que le proporcionará una interfaz para asignar los campos de origen del esquema de origen a sus campos XDM de destino adecuados en el esquema de destino.
Experience Platform proporciona recomendaciones inteligentes para campos asignados automáticamente en función del esquema o conjunto de datos de destino seleccionado. Puede ajustar manualmente las reglas de asignación para adaptarlas a sus casos de uso. En función de sus necesidades, puede elegir asignar campos directamente o utilizar funciones de preparación de datos para transformar los datos de origen y derivar valores calculados o calculados. Para ver los pasos detallados sobre el uso de la interfaz de asignador y los campos calculados, consulte la guía de la interfaz de usuario de la preparación de datos.
Las asignaciones enumeradas a continuación son obligatorias y deben configurarse antes de continuar con la fase Review.
uniqueIdUna vez que los datos de origen se hayan asignado correctamente, seleccione Next.
Revisar review
Aparece el paso Review, que le permite revisar el nuevo flujo de datos antes de crearlo. Los detalles se agrupan en las siguientes categorías:
- Connection: muestra el tipo de origen, la ruta de acceso relevante del archivo de origen elegido y la cantidad de columnas dentro de ese archivo de origen.
- Assign dataset & map fields: muestra a qué conjunto de datos se están ingiriendo los datos de origen, incluido el esquema al que se adhiere el conjunto de datos.
Una vez que haya revisado el flujo de datos, seleccione Finish y espere un poco para que se cree el flujo de datos.
Obtener la URL del extremo de flujo continuo get-streaming-endpoint-url
Con el flujo de datos de flujo continuo creado, ahora puede recuperar la URL del extremo de flujo continuo. Este punto de conexión se utilizará para suscribirse al webhook, lo que permitirá que el origen de flujo se comunique con Experience Platform.
Para construir la dirección URL utilizada para configurar el webhook en Pendo, debe recuperar lo siguiente:
- Dataflow ID
- Streaming endpoint
Para recuperar sus Dataflow ID y Streaming endpoint, vaya a la página Dataflow activity del flujo de datos que acaba de crear y copie los detalles de la parte inferior del panel Properties.
Una vez que haya recuperado su extremo de flujo continuo y el ID de flujo de datos, genere una URL basada en el siguiente patrón: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Por ejemplo, una URL de gancho web construida puede tener el siguiente aspecto: https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95
Configurar webhook en Pendo set-up-webhook
A continuación, inicia sesión en tu cuenta el Pendo y crea un webhook. Para ver los pasos sobre cómo crear un webhook usando la interfaz de usuario de Pendo, consulte la Pendo guía sobre la creación de webhook.
Una vez creado el gancho web, vaya a la página de configuración del gancho web Pendo y escriba la dirección URL del gancho en el campo URL.
Próximos pasos next-steps
Al seguir este tutorial, configuró correctamente un flujo de datos de streaming para llevar los datos de Pendo a Experience Platform. Para supervisar los datos que se están ingiriendo, consulte la guía sobre supervisión de flujos de datos de flujo continuo mediante la interfaz de usuario de Experience Platform.
Recursos adicionales additional-resources
Las secciones siguientes proporcionan recursos adicionales a los que puede hacer referencia al usar el origen Pendo.
Validación validation
Para comprobar que ha configurado correctamente el origen y que se están introduciendo Pendo mensajes, siga los pasos a continuación:
- Puede marcar la página Pendo Reports > Chat History para identificar los eventos que está capturando Pendo.
- En la interfaz de usuario de Experience Platform, seleccione View Dataflows junto al menú de tarjeta Pendo en el catálogo de fuentes. A continuación, seleccione Preview dataset para verificar los datos introducidos para los enlaces web configurados en Pendo.
Errores y solución de problemas errors-and-troubleshooting
Al comprobar la ejecución de un flujo de datos, puede que aparezca el siguiente mensaje de error: The message can't be validated ... uniqueID:expected minLength:1, actual 0].
Para corregir este error, debe comprobar que la asignación uniqueID esté configurada. Para obtener más instrucciones, consulte la sección Asignación.
Para obtener más información, visite el Pendo Centro de ayuda.