(Beta) Crear un conector de origen Marketo Engage en la interfaz de usuario

IMPORTANTE

El origen Marketo Engage está actualmente en versión beta. La función y la documentación están sujetas a cambios. Además, debe asegurarse de que está utilizando un simulador para pruebas que no sean de producción al utilizar el conector durante el programa beta. Para obtener más información sobre los entornos limitados, consulte la documentación de los entornos limitados.

Este tutorial proporciona los pasos para crear un conector de origen Marketo Engage (denominado en adelante "Marketo") en la interfaz de usuario para introducir los datos de consumo en Adobe Experience Platform.

Primeros pasos

Este tutorial requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:

  • Fuentes: Experience Platform permite la ingesta de datos de varias fuentes, al mismo 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 el Experience Platform organiza los datos de experiencia del cliente.
  • Espacios de nombres de identidad: Las áreas de nombres de identidad son un componente de Identity Service que sirve 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 cliente unificado y en tiempo real basado en datos agregados de varias fuentes.
  • Simuladores para pruebas: Experience Platform proporciona entornos limitados virtuales que dividen una sola instancia de Platform en entornos virtuales independientes para ayudar a desarrollar y desarrollar aplicaciones de experiencia digital.

Recopilar las credenciales necesarias

Para acceder a su cuenta Marketo en Platform, debe proporcionar los siguientes valores:

Credencial Descripción
munchkinId El ID de Munchkin es el identificador único de una instancia Marketo específica.
clientId El ID de cliente único de su instancia Marketo.
clientSecret El secreto de cliente único de su instancia Marketo.

Para obtener más información sobre la adquisición de 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.

Conecte su cuenta Marketo

En la interfaz de usuario de Platform, seleccione Sources en la barra de navegación izquierda para acceder al espacio de trabajo Sources. La pantalla Catalog muestra una variedad de fuentes con las que puede crear una cuenta.

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 mediante la barra de búsqueda.

En la categoría Adobe applications, seleccione Marketo Engage. A continuación, seleccione Add data para crear un nuevo flujo de datos Marketo.

catálogo

Aparece la página Connect to Marketo Engage. En esta página puede usar una cuenta nueva o acceder a una existente.

Nueva cuenta

Si está creando una cuenta nueva, seleccione New account. En el formulario de entrada que aparece, proporcione un nombre de cuenta, una descripción opcional y sus credenciales de autenticación Marketo. Cuando termine, seleccione Connect to source y, a continuación, deje que se establezca la nueva conexión.

new-account

Cuenta existente

Para crear un flujo de datos con una cuenta existente, seleccione Existing account y luego seleccione la cuenta Marketo que desee utilizar. Seleccione Siguiente para continuar.

existente

Seleccionar un conjunto de datos

Después de crear su cuenta 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 Marketo conjuntos de datos. Una conexión de origen Marketo que funcione completamente requiere la ingesta de los nueve conjuntos de datos diferentes. Si también está utilizando la función de marketing basado en cuentas Marketo (ABM), también debe crear un décimo flujo de datos para ingerir el conjunto de datos Cuentas con nombre.

NOTA

Para abreviar, el siguiente tutorial utiliza Cuentas con nombre como ejemplo, pero los pasos descritos a continuación se aplican a cualquiera de los 10 Marketo conjuntos de datos.

Seleccione el conjunto de datos que desea ingerir primero y, a continuación, seleccione Siguiente.

select-data

Asignación de esquemas Marketo a la plataforma

Aparece el paso Mapping, que proporciona una interfaz para asignar Marketo esquemas a Platform.

Elija un conjunto de datos para los datos entrantes en los que se van a introducir. Puede usar un conjunto de datos existente o crear un conjunto de datos nuevo.

Usar un conjunto de datos existente

Para introducir datos en un conjunto de datos existente, seleccione Conjunto de datos existente y, a continuación, seleccione el icono del conjunto de datos.

conjunto de datos existente

Aparece el cuadro de diálogo Seleccionar conjunto de datos. Busque el conjunto de datos con el esquema adecuado que desee utilizar, selecciónelo y seleccione Confirm.

select-existing-dataset

Usar un nuevo conjunto de datos

Para introducir datos en un nuevo conjunto de datos, seleccione Nuevo conjunto de datos e introduzca un nombre y una descripción para el conjunto de datos en los campos proporcionados.

Puede buscar un esquema introduciendo su nombre en la barra de búsqueda Select schema. También puede seleccionar el icono desplegable para ver una lista de los esquemas existentes. Como alternativa, puede seleccionar Búsqueda avanzada para acceder a la página de esquemas existentes, incluidos sus respectivos detalles.

Alterne el botón Profile dataset para habilitar su conjunto de datos de destino para Profile, lo que le permite crear una vista holística de los atributos y comportamientos de una entidad. Los datos de todos los conjuntos de datos habilitados para Profile se incluirán en Profile y se aplicarán los cambios cuando guarde el flujo de datos.

create-new-dataset

Una vez que haya seleccionado un esquema, desplácese hacia abajo para ver el cuadro de diálogo de asignación para empezar a asignar los campos del conjunto de datos Marketo a los campos XDM de destino adecuados.

Asigne los campos de origen del conjunto de datos Marketo a los campos XDM de destino

Cada conjunto de datos Marketo tiene que seguir sus propias reglas de asignación específicas. Consulte lo siguiente para obtener más información sobre cómo asignar Marketo conjuntos de datos a XDM:

Seleccione Preview data para ver los resultados de la asignación en función del conjunto de datos seleccionado.

asignación

La ventana emergente Preview proporciona una interfaz para explorar los resultados de asignación de hasta 100 filas de datos de ejemplo del conjunto de datos seleccionado.

vista previa

Una vez que los campos de origen estén asignados a los campos de destino adecuados, seleccione Close.

Proporcionar detalles de flujo de datos

Aparece el paso Dataflow detail, que le permite proporcionar un nombre y una breve descripción sobre el nuevo flujo de datos.

dataflow-detail

Habilite la opción Error diagnostic para permitir la generación detallada de mensajes de error para lotes recién ingeridos, que puede descargar con la API. Para obtener más información, consulte el tutorial sobre recuperación de diagnósticos de error de ingesta de datos.

errors

El conector Marketo utiliza la ingesta por lotes para ingerir todos los registros históricos y la ingesta de transmisión para actualizaciones en tiempo real. Esto permite que el conector continúe transmitiendo durante la ingesta de registros erróneos. Active la opción Partial ingestion y, a continuación, establezca el Error threshold % en el máximo para evitar que falle el flujo de datos.

El cuestionario parcial permite introducir datos que contengan errores hasta un umbral determinado. Para obtener más información, consulte la información general sobre la ingesta parcial de lotes.

Una vez que haya proporcionado los detalles del flujo de datos y haya establecido el umbral de error en max, seleccione Next.

ingesta parcial

Revise el flujo de datos

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:

  • 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 incorporando 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 permita que se cree el flujo de datos.

review

Monitorizar el flujo de datos

Una vez creado el flujo de datos, puede monitorizar los datos que se incorporan 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 monitorizar los flujos de datos, consulte el tutorial sobre monitorizació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 eliminar 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 eliminar.

Eliminar el flujo de datos

Puede eliminar flujos de datos que ya no sean necesarios o que se hayan creado incorrectamente empleando la función Delete disponible en el espacio de trabajo Dataflows. Para obtener más información sobre cómo eliminar flujos de datos, consulte el tutorial sobre la eliminación de flujos de datos en la interfaz de usuario.

Pasos siguientes

Al seguir este tutorial, ha creado correctamente un flujo de datos para incorporar datos Marketo. Los datos entrantes ahora se pueden usar en servicios de Platform descendentes como Real-time Customer Profile y Data Science Workspace. Consulte los siguientes documentos para obtener más información:

En esta página