[Ultimate]{class="badge positive"}
Amazon Kinesis conexión
Información general overview
El servicio Kinesis Data Streams de Amazon Web Services le permite recopilar y procesar grandes flujos de registros de datos en tiempo real.
Puede crear una conexión saliente en tiempo real a su almacenamiento de Amazon Kinesis para transmitir datos desde Adobe Experience Platform.
- Para obtener más información acerca de Amazon Kinesis, consulte la documentación de Amazon.
- Para conectarse a Amazon Kinesis mediante programación, consulte el tutorial de la API de destinos de transmisión.
- Para conectarse a Amazon Kinesis mediante la interfaz de usuario de Platform, consulte las secciones siguientes.
Casos de uso use-cases
Al usar destinos de streaming como Amazon Kinesis, puede incorporar fácilmente eventos de segmentación de alto valor y atributos de perfil asociados a los sistemas que elija.
Por ejemplo, un cliente potencial descargó un documento técnico que le clasifica en un segmento de "alta tendencia a la conversión". Al asignar la audiencia a la que pertenece el posible cliente en el destino Amazon Kinesis, recibirá este evento en Amazon Kinesis. Allí, puede emplear un enfoque de "hágalo usted mismo" y describir la lógica empresarial además del evento, tal como cree que funcionaría mejor con sus sistemas de TI empresariales.
Audiencias compatibles supported-audiences
Esta sección describe qué tipos de audiencias puede exportar a este destino.
Tipo y frecuencia de exportación export-type-frequency
Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.
LISTA DE PERMITIDOS de direcciones IP ip-address-allowlist
Para cumplir los requisitos de seguridad y conformidad de los clientes, Experience Platform proporciona una lista de direcciones IP estáticas que puede lista de permitidos para el destino Amazon Kinesis. Consulte la lista de permitidos de direcciones IP para destinos de streaming para obtener la lista completa de direcciones IP para lista de permitidos.
Permisos necesarios de Amazon Kinesis required-kinesis-permission
Para conectar y exportar correctamente los datos a las secuencias de Amazon Kinesis, el Experience Platform necesita permisos para las siguientes acciones:
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
Estos permisos se organizan a través de la consola Kinesis y Platform los comprueba una vez que ha configurado el destino de Kinesis en la interfaz de usuario de Platform.
El ejemplo siguiente muestra los derechos de acceso mínimos necesarios para exportar correctamente datos a un destino Kinesis.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kinesis:ListStreams",
"kinesis:PutRecord",
"kinesis:PutRecords"
],
"Resource": [
"arn:aws:kinesis:us-east-2:901341027596:stream/*"
]
}
]
}
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
Para obtener más información sobre cómo controlar el acceso a las secuencias de datos de Kinesis, lea el siguiente Kinesis documento.
Conexión al destino connect
Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. Al conectarse a este destino, debe proporcionar la siguiente información:
Información de autenticación authentication-information
Escriba los campos siguientes y seleccione Conectar con destino:
- Amazon Web Servicesclave de acceso y clave secreta: en Amazon Web Services, genere un par de
access key - secret access key
para conceder acceso de plataforma a su cuenta de Amazon Kinesis. Obtenga más información en la documentación de Amazon Web Service. - Región: Indique a qué región Amazon Web Services se transmitirán los datos.
Rellenar detalles de destino destination-details
Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
- Nombre: proporcione un nombre para la conexión con Amazon Kinesis
- Descripción: proporcione una descripción para la conexión con Amazon Kinesis.
- Stream: proporciona el nombre de un flujo de datos existente en tu cuenta de Amazon Kinesis. Platform exportará datos a este flujo.
- Incluir nombres de segmentos: Cambie la opción si desea que la exportación de datos incluya los nombres de las audiencias que está exportando. Para ver un ejemplo de exportación de datos con esta opción seleccionada, consulte la sección Datos exportados más abajo.
- Incluir marcas de tiempo de segmentos: actívela si desea que la exportación de datos incluya la marca de tiempo UNIX cuando se crearon y actualizaron las audiencias, así como la marca de tiempo UNIX cuando las audiencias se asignaron al destino para la activación. Para ver un ejemplo de exportación de datos con esta opción seleccionada, consulte la sección Datos exportados más abajo.
Habilitar alertas enable-alerts
Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.
Cuando termine de proporcionar detalles para la conexión de destino, seleccione Siguiente.
Activar públicos en este destino activate
- Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentos para. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
- La evaluación de directivas de consentimiento no se admite actualmente en las exportaciones al destino de Amazon Kinesis. Más información.
Consulte Activar datos de audiencia en destinos de exportación de perfiles de flujo continuo para obtener instrucciones sobre cómo activar audiencias en este destino.
Comportamiento de exportación de perfil profile-export-behavior
El Experience Platform optimiza el comportamiento de exportación de perfiles a su destino Amazon Kinesis para exportar solo datos a su destino cuando se han producido actualizaciones relevantes en un perfil tras la calificación de la audiencia u otros eventos significativos. Los perfiles se exportan al destino en las siguientes situaciones:
- La actualización de perfil se determinó mediante un cambio en el abono a audiencia de al menos una de las audiencias asignadas al destino. Por ejemplo, el perfil cumple los requisitos de una de las audiencias asignadas al destino o ha salido de una de las audiencias asignadas al destino.
- La actualización de perfil se determinó mediante un cambio en el mapa de identidad. Por ejemplo, a un perfil que ya estaba cualificado para una de las audiencias asignadas al destino se le ha añadido una nueva identidad en el atributo del mapa de identidad.
- La actualización de perfil estaba determinada por un cambio en los atributos de al menos uno de los atributos asignados al destino. Por ejemplo, uno de los atributos asignados al destino en el paso de asignación se agrega a un perfil.
En todos los casos descritos anteriormente, solo los perfiles en los que se han producido actualizaciones relevantes se exportan a su destino. Por ejemplo, si una audiencia asignada al flujo de destino tiene cien miembros y cinco perfiles nuevos cumplen los requisitos para el segmento, la exportación a su destino es incremental y solo incluye los cinco perfiles nuevos.
Tenga en cuenta que todos los atributos asignados se exportan para un perfil, independientemente de dónde se encuentren los cambios. Por lo tanto, en el ejemplo anterior, todos los atributos asignados para esos cinco nuevos perfiles se exportarán incluso si los atributos en sí no han cambiado.
Qué determina una exportación de datos y qué se incluye en la exportación what-determines-export-what-is-included
Con respecto a los datos que se exportan para un perfil determinado, es importante entender los dos conceptos diferentes de qué determina una exportación de datos a su Amazon Kinesis destino y qué datos se incluyen en la exportación.
- Los atributos y audiencias asignados sirven de referencia para una exportación de destino. Esto significa que si alguna audiencia asignada cambia de estado (de
null
arealized
o derealized
aexiting
) o si se actualiza algún atributo asignado, se iniciará una exportación de destino. - Dado que las identidades no se pueden asignar actualmente a Amazon Kinesis destinos, los cambios en cualquier identidad de un perfil determinado también determinan las exportaciones de destino.
- Un cambio para un atributo se define como cualquier actualización del atributo, independientemente de si es el mismo valor o no. Esto significa que la sobrescritura de un atributo se considera un cambio aunque el valor en sí no haya cambiado.
- El objeto
segmentMembership
incluye la audiencia asignada en el flujo de datos de activación, para la cual el estado del perfil ha cambiado después de un evento de calificación o salida de audiencia. Tenga en cuenta que otras audiencias sin asignar para las que el perfil cumple los requisitos pueden formar parte de la exportación de destino, si estas audiencias pertenecen a la misma política de combinación que la audiencia asignada en el flujo de datos de activación. - También se incluyen todas las identidades del objeto
identityMap
(actualmente, el Experience Platform no admite la asignación de identidades en el destino Amazon Kinesis). - En la exportación de destino solo se incluyen los atributos asignados.
Por ejemplo, considere este flujo de datos a un destino Amazon Kinesis donde se seleccionan tres audiencias en el flujo de datos y se asignan cuatro atributos al destino.
Una exportación de perfil al destino puede determinarse mediante un perfil que califique para uno de los tres segmentos asignados o que salga de él. Sin embargo, en la exportación de datos, en el objeto segmentMembership
(consulte la sección Datos exportados más abajo), podrían aparecer otras audiencias no asignadas, si ese perfil en particular es miembro de ellas y si comparten la misma política de combinación que la audiencia que activó la exportación. Si un perfil cumple los requisitos para la audiencia de Customer with DeLorean Cars, pero también es miembro de las audiencias de Ver la película "Volver al futuro" y Aficionados a la ciencia ficción, estas otras dos audiencias también estarán presentes en el objeto segmentMembership
de la exportación de datos, aunque no estén asignadas en el flujo de datos, si comparten la misma política de combinación con el segmento Customer with DeLorean Cars.
Desde el punto de vista de los atributos de perfil, cualquier cambio en los cuatro atributos asignados anteriormente determinará una exportación de destino y cualquiera de los cuatro atributos asignados presentes en el perfil estará presente en la exportación de datos.
Relleno de datos históricos historical-data-backfill
Cuando se añade una audiencia nueva a un destino existente o se crea un destino nuevo y se le asignan audiencias, Experience Platform exporta al destino los datos históricos de cualificación de audiencias. Los perfiles que cumplen los requisitos para la audiencia antes de que la audiencia se agregó al destino se exportan al destino en un plazo aproximado de una hora.
Datos exportados exported-data
Los datos de Experience Platform exportados llegan a su destino Amazon Kinesis en formato JSON. Por ejemplo, la exportación siguiente contiene un perfil que se ha clasificado para un segmento determinado, es miembro de otros dos segmentos y ha salido de otro segmento. La exportación también incluye el atributo de perfil nombre, apellidos, fecha de nacimiento y dirección de correo electrónico personal. Las identidades de este perfil son ECID y correo electrónico.
{
"person": {
"birthDate": "YYYY-MM-DD",
"name": {
"firstName": "John",
"lastName": "Doe"
}
},
"personalEmail": {
"address": "john.doe@acme.com"
},
"segmentMembership": {
"ups":{
"7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
"lastQualificationTime":"2022-01-11T21:24:39Z",
"status":"exited"
},
"59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
"lastQualificationTime":"2022-01-02T23:37:33Z",
"status":"realized"
},
"947c1c46-008d-40b0-92ec-3af86eaf41c1":{
"lastQualificationTime":"2021-08-25T23:37:33Z",
"status":"realized"
},
"5114d758-ce71-43ba-b53e-e2a91d67b67f":{
"lastQualificationTime":"2022-01-11T23:37:33Z",
"status":"realized"
}
}
},
"identityMap": {
"ecid": [
{
"id": "14575006536349286404619648085736425115"
},
{
"id": "66478888669296734530114754794777368480"
}
],
"email_lc_sha256": [
{
"id": "655332b5fa2aea4498bf7a290cff017cb4"
},
{
"id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
}
]
}
}
A continuación se muestran más ejemplos de datos exportados, según la configuración de la interfaz de usuario que seleccione en el flujo de destino de conexión para las opciones Incluir nombres de segmentos e Incluir marcas de tiempo de segmentos:
segmentMembership
code language-json |
---|
|
segmentMembership
code language-json |
---|
|
Límites y directiva de reintentos limits-retry-policy
En el 95 por ciento de los casos, Experience Platform intenta ofrecer una latencia de rendimiento de menos de 10 minutos para los mensajes enviados correctamente con una tasa de menos de 10 000 solicitudes por segundo para cada flujo de datos a un destino HTTP.
En caso de solicitudes fallidas al destino de la API HTTP, el Experience Platform almacena las solicitudes fallidas y las reintenta dos veces para enviar las solicitudes al extremo.