Crear una conexión de flujo continuo HTTP API mediante la IU

Este tutorial proporciona los pasos para crear una conexión de origen de flujo continuo usando el espacio de trabajo Sources.

Introducción

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

Creación de una conexión de flujo continuo

En la interfaz de usuario de Platform, seleccione Sources en el panel de navegación izquierdo para acceder al área de trabajo Sources. La pantalla Catálogo muestra una variedad de orígenes con los 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 utilizando la opción de búsqueda.

En la categoría Transmisión, seleccione API HTTP y, a continuación, seleccione Agregar datos.

catálogo

Aparecerá la página Conectar cuenta de API HTTP. En esta página, puede usar credenciales nuevas o existentes.

Cuenta existente

Para usar una cuenta existente, selecciona la cuenta de la API HTTP con la que deseas crear un nuevo flujo de datos y luego selecciona Siguiente para continuar.

cuenta existente

Nueva cuenta

Si está creando una cuenta nueva, seleccione Cuenta nueva. En el formulario de entrada que aparece, proporcione un nombre de cuenta y una descripción opcional. También tendrá la opción de proporcionar las siguientes propiedades de configuración:

  • Autenticación: Esta propiedad determina si la conexión de flujo continuo requiere o no autenticación. La autenticación garantiza que los datos se recopilen de fuentes de confianza. Si está tratando con información de identificación personal (PII), esta propiedad debe estar activada. De forma predeterminada, esta propiedad está desactivada.
  • Compatible con XDM: Esta propiedad indica si esta conexión de flujo continuo enviará eventos compatibles con esquemas XDM. De forma predeterminada, esta propiedad está desactivada.

Cuando termine, seleccione Conectarse al origen y, a continuación, seleccione Siguiente para continuar.

nueva cuenta

Seleccionar datos

Después de crear la conexión HTTP API, aparece el paso Seleccionar datos, que le proporciona una interfaz para cargar y previsualizar los datos.

Seleccione Cargar archivos para cargar los datos. También puede arrastrar y soltar sus datos en la sección Arrastrar y soltar archivos de la interfaz.

add-data

Con los datos cargados, puede utilizar el lado derecho de la interfaz para obtener una vista previa de la jerarquía de archivos. Seleccione Siguiente para continuar.

preview-sample-data

Asignación de campos de datos a un esquema XDM

Aparecerá el paso Mapping, que proporciona una interfaz para asignar los datos de origen a un conjunto de datos de Platform.

El origen HTTP API admite la ingesta de archivos JSON. Los archivos JSON no requieren configuración manual si están marcados como quejas de XDM. Si no es así, debe configurar explícitamente la asignación.

Elija un conjunto de datos para los datos de entrada que se van a introducir en. Puede utilizar un conjunto de datos existente o crear uno nuevo.

Crear un nuevo conjunto de datos

Para crear un nuevo conjunto de datos, seleccione Nuevo conjunto de datos. En el formulario que aparece, proporcione el nombre, una descripción opcional, así como el esquema de destino del conjunto de datos. Si selecciona un esquema habilitado para Profile, puede elegir si el conjunto de datos también debe estar habilitado para Profile.

nuevo conjunto de datos

Usar un conjunto de datos existente

Para usar un conjunto de datos existente, seleccione Conjunto de datos existente. En el formulario que aparece, seleccione el conjunto de datos que desee utilizar. Una vez que seleccione un conjunto de datos, puede elegir si este debería estar habilitado para Profile.

conjunto de datos existente

Asignar campos estándar

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.

Para agregar un nuevo campo de origen, seleccione Agregar nueva asignación.

add-new-mapping

Aparece un nuevo emparejamiento de campo de origen y campo de destino. Para agregar un nuevo campo de origen, seleccione el icono de flecha al lado de la barra de entrada Seleccionar campo de origen.

select-source-field

El panel Seleccionar atributos le permite explorar la jerarquía de archivos y seleccionar un campo de origen específico para asignarlo a un campo XDM de destino. Una vez que haya seleccionado el campo de origen que desea asignar, seleccione Seleccionar para continuar.

select-attributes

Con un campo de origen seleccionado, ahora puede identificar el campo XDM de destino adecuado al que asignar. Seleccione el icono de esquema en la sección del campo de destino.

select-target-field

Aparecerá la ventana Asignar campo de origen al campo de destino, que le proporcionará una interfaz para explorar el esquema del conjunto de datos de destino. Seleccione el campo de destino que coincida con el campo de origen y, a continuación, seleccione Seleccionar para continuar.

campo de asignación a destino

Una vez que todos los campos de origen estén asignados a los campos XDM de destino correspondientes, seleccione Siguiente

data-prep-complete

Detalles del flujo de datos

Aparece el paso Detalle del flujo de datos. En esta página, puede proporcionar detalles para el flujo de datos creado proporcionando un nombre y una descripción opcional.

Después de proporcionar detalles para el flujo de datos, seleccione Siguiente.

detalle de flujo de datos

Revisar

Aparece el paso Revisar, que le permite revisar los detalles del flujo de datos antes de crearlo. Los detalles se agrupan en las siguientes categorías:

  • Conexión: muestra el nombre de cuenta, la plataforma de origen y el nombre de origen.
  • Asignar campos de conjunto de datos y asignación: muestra el conjunto de datos de destino y el esquema al que se adhiere el conjunto de datos.

Después de confirmar que los detalles son correctos, seleccione Finalizar.

revisión

Obtener URL del extremo de flujo continuo

Con la conexión creada, aparecerá la página de detalles de orígenes. Esta página muestra detalles de la conexión recién creada, incluidos los flujos de datos ejecutados anteriormente, el ID y la URL del extremo de flujo continuo.

extremo

Pasos siguientes

Al seguir este tutorial, ha creado una conexión HTTP de flujo continuo que le permite utilizar el extremo de flujo continuo para acceder a una variedad de API de Data Ingestion. Para obtener instrucciones para crear una conexión de flujo continuo en la API, lea el tutorial sobre la creación de una conexión de flujo continuo.

Para aprender a transmitir datos a Platform, lea el tutorial sobre transmisión de datos de series temporales o el tutorial sobre transmisión de datos de registros.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089