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

Última actualización: 2023-11-13
  • Temas:
  • Sources
    Ver más sobre este tema
  • Creado para:
  • Developer

En este tutorial se proporcionan los pasos para crear una conexión de origen de flujo continuo utilizando Fuentes workspace.

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 IU de Platform, seleccione Fuentes desde la navegación izquierda para acceder a Fuentes workspace. El Catálogo La pantalla 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 utilizando la opción de búsqueda.

En el Transmisión categoría, seleccionar API HTTP y luego seleccione Añadir datos.

catalogar

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

Cuenta existente

Para utilizar una cuenta existente, seleccione la cuenta de la API HTTP con la que desee crear un nuevo flujo de datos y, a continuación, seleccione Siguiente para continuar.

existing-account

Nueva cuenta

Si está creando una cuenta nueva, seleccione Nueva cuenta. 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 autenticación o no. 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 Conectar con el origen y luego seleccione Siguiente para continuar.

new-account

Seleccionar datos

Después de crear la conexión de la API HTTP, la variable Seleccionar datos Este paso se muestra y le proporciona una interfaz para cargar y previsualizar sus datos.

Seleccionar Cargar archivos para cargar los datos. También puede arrastrar y soltar los datos en el 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

El Asignación Este paso aparece y proporciona una interfaz para asignar los datos de origen a un conjunto de datos de Platform.

El HTTP API source 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 una ProfileUn esquema habilitado para, puede elegir si el conjunto de datos también debe ser Profile-habilitado.

new-dataset

Usar un conjunto de datos existente

Para utilizar 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 se debe configurar el conjunto de datos Profile-habilitado.

existing-dataset

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 asignación y los campos calculados, consulte la Guía de IU de preparación de datos.

Para añadir un nuevo campo de origen, seleccione Añadir nueva asignación.

add-new-mapping

Aparece un nuevo emparejamiento de campo de origen y campo de destino. Para añadir un nuevo campo de origen, seleccione el icono de flecha junto a la variable Seleccionar campo de origen barra de entrada.

select-source-field

El Seleccionar atributos Este panel 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 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

El Asignar campo de origen a campo de destino aparece una ventana que le proporciona una interfaz para explorar el esquema del conjunto de datos de destinatario. Seleccione el campo de destino que coincida con el campo de origen y, a continuación, seleccione Seleccionar para continuar.

map-to-target-field

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

data-prep-complete

Detalles de flujo de datos

El Detalles del flujo de datos aparece el paso. 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.

data-flow-detail

Consulte

El Revisar Este paso aparece, lo 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 la 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 destinatario y el esquema al que se adhiere el conjunto de datos.

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

reseña

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.

punto final

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 Data Ingestion API. Para obtener instrucciones para crear una conexión de flujo continuo en la API, lea la tutorial creación de una conexión de flujo continuo.

Para aprender a transmitir datos a Platform, lea cualquiera de los dos tutoriales sobre transmisión de datos de series temporales o el tutorial sobre streaming de datos de registro.

En esta página