Ingesta de datos de Algolia User Profiles en Experience Platform mediante la IU

Este tutorial lo guiará a través de la ingesta de datos de su cuenta de Algolia User Profiles en Adobe Experience Platform mediante la interfaz de usuario.

Introducción

IMPORTANT
Antes de comenzar, asegúrese de completar los requisitos previos descritos en la Algolia User Profiles descripción general.

Este tutorial supone que está familiarizado con los siguientes componentes de Experience Platform:

Recopilar credenciales necesarias

Para conectar Algolia a Adobe Experience Platform, proporcione las siguientes credenciales:

Credencial
Descripción
ID de aplicación
El identificador único asignado a su cuenta de Algolia.
Clave de API
La credencial para autenticar y autorizar solicitudes de API a los servicios de Algolia.

Para obtener más información, consulte la Algolia documentación de autenticación.

Conectar su cuenta de Algolia

En la interfaz de usuario de Experience Platform, seleccione Fuentes en el panel de navegación izquierdo para abrir el área de trabajo Fuentes. Use el panel Categorías o la barra de búsqueda para encontrar el origen deseado.

Para conectar a Algolia, elige la tarjeta de origen de Algolia en Socios de datos e identidad y selecciona Configurar.

TIP
Si un origen aún no tiene una cuenta autenticada, muestra la opción Configurar. Una vez autenticado, esto cambia a Agregar datos.

El catálogo de orígenes con el origen de Perfiles de usuario de Algolia seleccionado.

Autenticación

Usar una cuenta existente

Para usar una cuenta existente, elija Cuenta existente y seleccione la cuenta Algolia User Profiles que desee usar. Luego selecciona Siguiente.

Interfaz de cuenta existente.

Crear una nueva cuenta

Para crear una cuenta nueva, selecciona Cuenta nueva y luego escribe un nombre, una descripción opcional y tus credenciales de Algolia. Seleccione Conectarse al origen y esperar a que se establezca la conexión.

Interfaz de la nueva cuenta.

Adición de datos

Una vez creada la cuenta de Algolia User Profiles, aparecerá el paso Agregar datos. Utilícelo para seleccionar y previsualizar datos de perfil de usuario para su ingesta.

  • A la izquierda, introduzca Índices y Afinidad(es) opcionales.
  • A la derecha, previsualice hasta 100 filas de perfiles de usuario.

Una vez finalizado, seleccione Siguiente.

Paso para seleccionar datos del flujo de trabajo.

Proporcionar detalles del flujo de datos

Si utiliza un conjunto de datos existente, elija uno asociado a un esquema que incluya el grupo de campos Algolia Profile. Asegúrese de que el campo Algolia User Token esté usando el área de nombres de identidad Algolia User Token. Si Algolia User Token no se ha creado ni asignado actualmente, se proporcionan las instrucciones a continuación.

Paso del conjunto de datos existente.

Si crea un nuevo conjunto de datos, seleccione un esquema con el grupo de campos Algolia Profile.

El nuevo paso del conjunto de datos.

Crear área de nombres de identidad Algolia User Token

Deberá crear el área de nombres de identidad Algolia User Token si aún no existe en su organización.

Use el panel de navegación izquierdo y seleccione Identidades para acceder al área de trabajo de la interfaz de usuario del servicio de identidad y, a continuación, seleccione Crear área de nombres de identidad.

A continuación, proporcione un Nombre para mostrar y un Símbolo de identidad para su área de nombres personalizada. Durante este paso, también debe configurar el tipo del área de nombres. Cuando termine, seleccione Crear.

Crear pantalla del área de nombres de identidad.

Configuración de área de nombres personalizada
Valor
Nombre para mostrar
Algolia User Token
Símbolo de identidad
AlgoliaUserToken
Seleccionar un tipo
Cookie ID

Una vez agregado, el área de nombres aparece en la lista. Ahora puede aplicarlo en el esquema.

Creación correcta del área de nombres de identidad de Algolia.

Aplicar el área de nombres al esquema

Utilice la barra de navegación izquierda y seleccione Esquemas para acceder al área de trabajo de la interfaz de usuario de Esquemas. Utilice el espacio de trabajo de esquemas para crear o actualizar un esquema con el grupo de campos Algolia Profile Details. A continuación, vaya al campo Token de usuario y utilice el carril derecho para seleccionar el cuadro Identidad. Además, utilice el cuadro de entrada para definir el área de nombres de identidad Algolia User Token. Cuando termine, seleccione Guardar.

Establecer identidad en el campo.

Una vez que el campo Token de usuario se asigna al área de nombres de identidad Algolia User Token, la identidad aparece en el perfil de usuario de cualquier perfil.

Interfaz de perfil de usuario.

Asignación de campos de datos a un esquema XDM

Utilice la interfaz de asignación para asignar los datos de origen a los campos de esquema. Para obtener más información, consulte la guía de asignación.

Paso de asignación.

Programar ejecuciones de ingesta

A continuación, utilice la interfaz de programación para definir la programación de ingesta del flujo de datos.

Paso de programación del flujo de trabajo de orígenes.

Configuración de programación
Descripción
Frecuencia

Configure la frecuencia para indicar con qué frecuencia debe ejecutarse el flujo de datos. Puede establecer su frecuencia en:

  • Una vez: establezca su frecuencia en once para crear una ingesta única. Las configuraciones para intervalo y relleno no están disponibles al crear un flujo de datos de ingesta único. De forma predeterminada, la frecuencia de programación se establece en una vez.
  • Minuto: establezca su frecuencia en minute para programar el flujo de datos e ingerir datos por minuto.
  • Hora: establezca su frecuencia en hour para programar el flujo de datos e ingerir datos por hora.
  • Día: Establezca su frecuencia en day para programar su flujo de datos e ingerir datos por día.
  • Semana: establezca su frecuencia en week para programar el flujo de datos e ingerir datos por semana.
Intervalo

Una vez seleccionada una frecuencia, puede configurar la configuración del intervalo para establecer el lapso de tiempo entre cada ingesta. Por ejemplo, si establece la frecuencia en día y configura el intervalo en 15, el flujo de datos se ejecutará cada 15 días. No puede establecer el intervalo en cero. El valor mínimo del intervalo aceptado para cada frecuencia es el siguiente:

  • Una vez: n/a
  • Minuto: 15
  • Hora: 1
  • Día: 1
  • Semana: 1
Hora de inicio
La marca de tiempo de la ejecución proyectada, presentada en la zona horaria UTC.
Relleno
El relleno determina qué datos se incorporan inicialmente. Si el relleno está habilitado, todos los archivos actuales de la ruta especificada se introducirán durante la primera ingesta programada. Si se desactiva el relleno, solo se incorporarán los archivos que se carguen entre la primera ejecución de la ingesta y la hora de inicio. Los archivos cargados antes de la hora de inicio no se incorporarán.

Revisión del flujo de datos

Utilice la página Revisar para obtener un resumen del flujo de datos antes de la ingesta. Los detalles se agrupan en las siguientes categorías:

  • Conexión: muestra el tipo de origen, la ruta de acceso relevante del archivo de origen elegido y el número de columnas dentro de ese archivo 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.
  • Programación: muestra ese período, frecuencia e intervalo activos de la programación de ingesta.

Una vez que haya revisado el flujo de datos, seleccione Finalizar y espere un poco para que se cree el flujo de datos.

Paso de revisión del flujo de trabajo de orígenes.

Pasos siguientes

Al seguir este tutorial, ha creado correctamente un flujo de datos para llevar los datos de intención de su origen de Algolia a Experience Platform. Para obtener recursos adicionales, visite la documentación descrita a continuación.

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 el flujo de datos, visite el tutorial sobre supervisar cuentas y flujos de datos en la interfaz de usuario.

Actualizar el flujo de datos

Para actualizar configuraciones para la programación, asignación e información general de los flujos de datos, visite el tutorial sobre actualización de flujos de datos de origen en la interfaz de usuario.

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, visite el tutorial sobre eliminar flujos de datos en la interfaz de usuario.

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