Crear una conexión de origen y un flujo de datos de Marketo Engage en la interfaz de usuario
Este tutorial proporciona los pasos para crear un conector de origen Marketo Engage (denominado en adelante "Marketo") en la interfaz de usuario para incorporar datos B2B a Adobe Experience Platform.
Introducción
Este tutorial requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Utilidad de generación automática de esquemas y áreas de nombres B2B: La utilidad de generación automática de esquemas y áreas de nombres B2B le permite usar Postman para generar automáticamente valores para sus esquemas y áreas de nombres B2B. Primero debe completar los esquemas y áreas de nombres B2B antes de crear una conexión de origen y un flujo de datos de Marketo.
- Fuentes: El Experience Platform permite la ingesta de datos de varias fuentes, al tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Platform.
- Modelo de datos de experiencia (XDM): El marco estandarizado mediante el cual Experience Platform organiza los datos de experiencia del cliente.
- Crear y editar esquemas en la interfaz de usuario: Aprenda a crear y editar esquemas en la interfaz de usuario.
- Áreas de nombres de identidad: Las áreas de nombres de identidad son un componente de Identity Service que sirven como indicadores del contexto al que se relaciona una identidad. Una identidad completa incluye un valor de ID y un área de nombres.
- Real-Time Customer Profile: proporciona un perfil de consumidor unificado y en tiempo real basado en los datos agregados de varias fuentes.
- Zonas protegidas: El Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Recopilar credenciales necesarias
Para acceder a su cuenta de Marketo en el Experience Platform, debe proporcionar los siguientes valores:
munchkinIdclientIdclientSecretPara obtener más información sobre cómo adquirir estos valores, consulte la Marketo guía de autenticación.
Una vez que haya recopilado las credenciales necesarias, puede seguir los pasos de la siguiente sección.
Conectar su cuenta de Marketo
En la interfaz de usuario de Platform, seleccione Sources en el panel de navegación izquierdo para acceder al área de trabajo Sources. Puede seleccionar la categoría adecuada del catálogo en la parte izquierda de la pantalla. También puede encontrar la fuente específica con la que desea trabajar utilizando la opción de búsqueda.
En la categoría aplicaciones de Adobe, seleccione Marketo Engage y, a continuación, seleccione Agregar datos.
Aparecerá la página Conectar cuenta de Marketo Engage. En esta página, puede utilizar una cuenta nueva o acceder a una cuenta existente.
Para crear una cuenta nueva, selecciona Cuenta nueva y proporciona un nombre, una descripción opcional y tus credenciales.
Cuando termine, seleccione Conectarse al origen y deje pasar un tiempo para que se establezca la nueva conexión.
Para usar una cuenta existente, seleccione Cuenta existente y luego seleccione la cuenta que desee usar del catálogo de cuentas existente.
Seleccione Siguiente para continuar.
Selección de un conjunto de datos
Después de crear su cuenta de Marketo, el siguiente paso proporciona una interfaz para explorar Marketo conjuntos de datos.
La mitad izquierda de la interfaz es un explorador de directorios que muestra los 10 conjuntos de datos de Marketo. Una conexión de origen Marketo que funciona completamente requiere la ingesta de los nueve conjuntos de datos diferentes. Si también está usando la característica de marketing basado en cuentas (ABM) de Marketo, también debe crear un décimo flujo de datos para ingerir el conjunto de datos de Cuentas con nombre.
Seleccione el conjunto de datos que desea introducir. Esto actualiza la interfaz para mostrar una previsualización del conjunto de datos. Cuando termine, seleccione Siguiente.
Proporcionar detalles del conjunto de datos y flujo de datos provide-dataset-and-dataflow-details
A continuación, debe proporcionar información sobre el conjunto de datos y el flujo de datos.
Detalles del conjunto de datos dataset-details
Un conjunto de datos es una construcción de almacenamiento y administración para una colección de datos, normalmente una tabla, que contiene un esquema (columnas) y campos (filas). Los datos que se incorporan correctamente en Experience Platform se almacenan dentro del lago de datos como conjuntos de datos. Durante este paso, puede crear un nuevo conjunto de datos o utilizar uno existente.
Para usar un nuevo conjunto de datos, seleccione Nuevo conjunto de datos y proporcione un nombre y una descripción opcional para su conjunto de datos. También debe seleccionar un esquema del Modelo de datos de experiencia (XDM) al que se adhiera el conjunto de datos.
Si ya tiene un conjunto de datos, seleccione Conjunto de datos existente y, a continuación, utilice la opción Búsqueda avanzada para ver una ventana de todos los conjuntos de datos de su organización, incluidos sus detalles respectivos, como si están habilitados para la ingesta en el Perfil del cliente en tiempo real o no.
Configuraciones de flujo de datos dataflow-configurations
Si el conjunto de datos está habilitado para Perfil del cliente en tiempo real, durante este paso, puede alternar Conjunto de datos de perfil para habilitar los datos para la ingesta de perfiles. También puede usar este paso para habilitar diagnósticos de error y ingesta parcial.
- Diagnósticos de error: seleccione Diagnósticos de error para indicar a la fuente que produzca diagnósticos de error a los que pueda hacer referencia posteriormente al supervisar la actividad del conjunto de datos y el estado del flujo de datos.
- Ingesta parcial: La ingesta parcial por lotes es la capacidad de ingerir datos que contengan errores, hasta un determinado umbral configurable. Esta función le permite introducir correctamente todos los datos precisos en Experience Platform, mientras que todos los datos incorrectos se agrupan por separado con información sobre los motivos por los que no son válidos.
Durante este paso, puede habilitar Flujo de datos de ejemplo para limitar la ingesta de datos y evitar costos adicionales que se producen con la ingesta de todos los datos históricos, incluidas las identidades de persona.
Guía rápida sobre el uso del flujo de datos de ejemplo
El flujo de datos de ejemplo es una configuración que puede establecer para su flujo de datos de Marketo a fin de limitar la tasa de ingesta y, a continuación, probar las funciones de Experience Platform sin tener que ingerir grandes cantidades de datos.
- Habilite el flujo de datos de ejemplo para limitar los datos históricos mediante la ingesta de hasta 100 000 registros (desde el ID de registro más grande) o hasta los últimos 10 días de actividad durante el trabajo de relleno.
- Al utilizar la configuración de flujo de datos de ejemplo para todas las entidades B2B, debe tener en cuenta que es posible que falten algunos registros relacionados porque no se incorpora todo el historial de los datos de origen.
Además, si está asimilando datos del conjunto de datos de compañías, puede habilitar Excluir cuentas no reclamadas para excluir las cuentas no reclamadas de la ingesta.
Cuando las personas rellenan un formulario, Marketo crea un registro de cuenta fantasma basado en el Nombre de la compañía que no contiene otros datos. Para los nuevos flujos de datos, la opción para excluir las cuentas no reclamadas está habilitada de forma predeterminada. Para los flujos de datos existentes, puede habilitar o deshabilitar la función, con cambios que se aplican a los datos recién ingeridos y no a los datos existentes.
Asignar los campos de origen del conjunto de datos Marketo a los campos XDM de destino
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.
Cada conjunto de datos Marketo tiene sus propias reglas de asignación específicas que seguir. Consulte lo siguiente para obtener más información sobre cómo asignar Marketo conjuntos de datos a XDM:
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 asignación, consulte la Guía de la interfaz de usuario para la preparación de datos.
Una vez que los conjuntos de asignaciones estén listos, seleccione Siguiente y espere unos momentos para crear el nuevo flujo de datos.
Revisión del flujo de datos
Aparece el paso Revisar, que le permite revisar el nuevo flujo de datos antes de crearlo. Los detalles se agrupan en las siguientes categorías:
- Conexión: muestra el tipo de origen, la ruta de acceso relevante de la entidad de origen elegida y la cantidad de columnas dentro de esa entidad de origen.
- Asignar campos de conjunto de datos y asignación: muestra en 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 Guardar e ingerir y espere un poco para que se cree el flujo de datos.
Monitorización del flujo de datos
Una vez creado el flujo de datos, puede monitorizar los datos que se están ingiriendo a través de él para ver información sobre las tasas de ingesta, el éxito y los errores. Para obtener más información sobre cómo supervisar flujos de datos, consulte el tutorial sobre supervisión de flujos de datos en la interfaz de usuario.
Eliminar los atributos
Los atributos personalizados de los conjuntos de datos no se pueden ocultar ni eliminar de forma retroactiva. Si desea ocultar o quitar un atributo personalizado de un conjunto de datos existente, debe crear un nuevo conjunto de datos sin este atributo personalizado, un nuevo esquema XDM y configurar un nuevo flujo de datos para el nuevo conjunto de datos que cree. También debe deshabilitar o eliminar el flujo de datos original que consta del conjunto de datos con el atributo personalizado que desea ocultar o quitar.
Eliminar el flujo de datos
Puede eliminar flujos de datos que ya no sean necesarios o que se hayan creado incorrectamente mediante la función Delete disponible en el área de trabajo Flujos de datos. Para obtener más información sobre cómo eliminar flujos de datos, consulte el tutorial sobre eliminar flujos de datos en la interfaz de usuario.
Pasos siguientes
Al seguir este tutorial, ha creado correctamente un flujo de datos para introducir datos B2B de su origen de Marketo Engage en el Experience Platform.
Apéndice appendix
Las secciones siguientes proporcionan directrices adicionales que puede seguir al utilizar el origen Marketo.
Mensajes de error en la IU error-messages
Los siguientes mensajes de error se muestran en la interfaz de usuario cuando Platform detecta problemas con la configuración:
Munchkin ID no está asignado a la organización apropiada
Se denegará la autenticación si Munchkin ID no está asignado a la organización de Platform que está utilizando. Configure la asignación entre su Munchkin ID y su organización mediante la Marketo interfaz.
Falta la identidad principal
Un flujo de datos no se puede guardar ni introducir si falta una identidad principal. Asegúrese de que existe una identidad principal dentro del esquema XDM antes de intentar configurar un flujo de datos.
