Información general sobre la extensión AWS

NOTE
Adobe Experience Platform Launch se ha convertido en un conjunto de tecnologías de recopilación de datos en Adobe Experience Platform. Como resultado, se han implementado varios cambios terminológicos en la documentación del producto. Consulte el siguiente documento para obtener una referencia consolidada de los cambios terminológicos.

Amazon Web Services (AWS) es una plataforma de computación en la nube que ofrece una amplia variedad de servicios, como computación distribuida, almacenamiento de bases de datos, entrega de contenido y servicios de integración de software como servicio (SaaS) para la administración de la relación con los clientes (CRM) y la planificación de recursos empresariales (ERP).

La extensión AWS reenvío de eventos aprovecha Amazon Kinesis Data Streams para enviar eventos del Edge Network de Adobe Experience Platform a AWS para un procesamiento posterior. Esta guía explica cómo instalar la extensión y utilizar sus funcionalidades en una regla de reenvío de eventos.

Requisitos previos

Debe tener una cuenta de AWS con un flujo de datos de Kinesis existente para poder usar esta extensión. Si no tiene un flujo de datos preexistente, consulte la documentación de AWS sobre creación de un nuevo flujo de datos con la AWS consola de administración.

Instalación de la extensión install

Para instalar la extensión AWS, vaya a la IU de recopilación de datos o a la IU del Experience Platform y seleccione Reenvío de eventos en el panel de navegación izquierdo. Aquí, seleccione una propiedad a la que añadir la extensión o cree una nueva propiedad.

Una vez que haya seleccionado o creado la propiedad deseada, seleccione Extensiones en el panel de navegación izquierdo y, a continuación, seleccione la pestaña Catálogo. Busque la tarjeta AWS y, a continuación, seleccione Instalar.

Se está seleccionando el botón Instalar para la extensión AWS en la IU de recopilación de datos.

En la pantalla siguiente, debe proporcionar las credenciales de conexión de la cuenta de AWS. Específicamente, debe proporcionar su clave de acceso AWS y su clave de acceso secreta. Si no conoce estos valores, consulte la documentación de AWS sobre cómo obtener el identificador de clave de acceso y la clave de acceso secreta.

El identificador de clave de acceso y la clave de acceso secreta se agregaron en la vista de configuración de la extensión.

IMPORTANT
Se debe adjuntar una directiva de acceso a la cuenta de AWS utilizada para generar las credenciales de acceso. Esta directiva debe configurarse para conceder derechos de acceso para enviar datos al flujo de datos de Kinesis. Consulte Ejemplo 2 en el documento AWS sobre directivas de ejemplo para Kinesis Data Streams para ver cómo se debe definir la directiva.

Cuando termine, seleccione Guardar y la extensión estará instalada.

Configuración de una regla de reenvío de eventos rule

Después de instalar la extensión, cree una nueva regla de reenvío de eventos rule y configure sus condiciones como desee. Al configurar las acciones de la regla, seleccione la extensión AWS y, a continuación, seleccione Enviar datos al flujo de datos de Kinesis para el tipo de acción.

Se está seleccionando el tipo de acción Enviar datos a la secuencia de datos de Kinesis para una regla en la IU de recopilación de datos.

El panel derecho se actualiza para mostrar las opciones de configuración de cómo se deben enviar los datos. En concreto, debe asignar elementos de datos a las distintas propiedades que representan su configuración de Event Hub.

Las opciones de configuración para el tipo de acción Enviar datos a la secuencia de datos de Kinesis que se muestra en la interfaz de usuario.

Detalles del flujo de datos de Kinesis

Entrada
Descripción
Nombre de secuencia
Nombre del flujo al que esta regla de reenvío de eventos enviará registros de datos.
AWS Region
Región AWS donde se crea el flujo de datos Kinesis.
Clave de partición
La clave de partición que la extensión usará al enviar datos al flujo de datos.

Kinesis Data Streams separa los registros de datos que pertenecen a una secuencia en varios fragmentos. Utiliza la clave de partición que se envía con cada registro de datos para determinar a qué recurso compartido pertenece un registro de datos determinado.

Una buena clave de partición para distribuir clientes puede ser el número de cliente, ya que es diferente para cada cliente. Una clave de partición deficiente puede afectar a su código postal porque todos pueden vivir en la misma zona cercana. En general, debe elegir una clave de partición que tenga el rango más alto de diferentes valores potenciales. Consulte el artículo de AWS sobre escalar los flujos de datos Kinesis 3} para conocer las prácticas recomendadas sobre la administración de claves de partición.

Datos

Entrada
Descripción
Carga
Este campo contiene los datos que se reenviarán al flujo de datos Kinesis, en formato JSON.

En la opción Sin procesar, puede pegar el objeto JSON directamente en el campo de texto proporcionado o puede seleccionar el icono del elemento de datos ( Icono del conjunto de datos ) para seleccionarlo de una lista de elementos de datos existentes para representar la carga útil.

También puede usar la opción Editor de pares clave-valor de JSON para agregar manualmente cada par clave-valor a través de un editor de interfaz de usuario. Cada valor se puede representar mediante una entrada sin procesar o se puede seleccionar un elemento de datos en su lugar.

Cuando termine, seleccione Conservar cambios para agregar la acción a la configuración de regla. Cuando esté satisfecho con la regla, seleccione Guardar en biblioteca.

Por último, publique un nuevo reenvío de eventos build para habilitar los cambios en la biblioteca.

Pasos siguientes

Esta guía explica cómo enviar datos a Kinesis Data Streams mediante la extensión de reenvío de eventos AWS. Para obtener más información sobre las funcionalidades de reenvío de eventos en Experience Platform, consulte la descripción general del reenvío de eventos.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743