Este destino solo está disponible para Adobe Real-time Customer Data Platform Ultimate clientes.
La variable Kinesis Data Streams servicio por Amazon Web Services permite recopilar y procesar flujos grandes de registros de datos en tiempo real.
Puede crear una conexión saliente en tiempo real con su Amazon Kinesis almacenamiento para transmitir datos desde Adobe Experience Platform.
Mediante destinos de flujo continuo como Amazon Kinesis, puede incorporar fácilmente eventos de segmentación de alto valor y atributos de perfil asociados a sus sistemas de elección.
Por ejemplo, un cliente potencial descargó un libro blanco que los califica para un segmento de "alta propensión a convertir". Asignando el segmento en el que se encuentra el cliente potencial a Amazon Kinesis destino, recibiría este evento en Amazon Kinesis. En este caso, puede utilizar un enfoque propio y describir la lógica empresarial además del evento, ya que considera que funcionará mejor con sus sistemas de TI empresariales.
Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.
Elemento | Tipo | Notas |
---|---|---|
Tipo de exportación | Basado en perfiles | Está exportando todos los miembros de un segmento, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), tal como se elige en la pantalla seleccionar atributos de perfil del flujo de trabajo de activación de destino. |
Frecuencia de exportación | Transmisión | Los destinos de flujo continuo son conexiones basadas en API "siempre activadas". Tan pronto como un perfil se actualiza en el Experience Platform en función de la evaluación de segmentos, el conector envía la actualización descendente a la plataforma de destino. Más información sobre destinos de flujo continuo. |
Para satisfacer los requisitos de seguridad y cumplimiento de los clientes, Experience Platform proporciona una lista de IP estáticas que puede lista de permitidos para Amazon Kinesis destino. Consulte LISTA DE PERMITIDOS de direcciones IP para destinos de flujo continuo para obtener la lista completa de las direcciones IP a lista de permitidos.
Para conectar y exportar datos correctamente a su Amazon Kinesis flujos, el Experience Platform necesita permisos para las siguientes acciones:
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
Estos permisos se organizan mediante la variable Kinesis y Platform los comprobará una vez que haya 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 los datos a un Kinesis destino.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kinesis:ListStreams",
"kinesis:PutRecord",
"kinesis:PutRecords"
],
"Resource": [
"arn:aws:kinesis:us-east-2:901341027596:stream/*"
]
}
]
}
Propiedad | Descripción |
---|---|
kinesis:ListStreams |
Acción que enumera las secuencias de datos de Amazon Kinesis. |
kinesis:PutRecord |
Acción que escribe un registro de datos único en un flujo de datos de Kinesis. |
kinesis:PutRecords |
Acción que escribe varios registros de datos en un flujo de datos de Kinesis en una sola llamada. |
Para obtener más información sobre cómo controlar el acceso a Kinesis flujos de datos, lea lo siguiente Kinesis documento.
Para conectarse al destino, necesita la variable Administrar destinos permiso de control de acceso. Lea el información general sobre el control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
Para conectarse a este destino, siga los pasos descritos en la sección tutorial de configuración de destino. Al conectarse a este destino, debe proporcionar la siguiente información:
Introduzca los campos siguientes y seleccione Conectarse al destino:
access key - secret access key
par para conceder acceso a Platform a su Amazon Kinesis cuenta. Obtenga más información en la Documentación de Amazon Web Service.Para configurar los detalles del destino, rellene los campos opcionales y requeridos a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
Puede activar las alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista para suscribirse y recibir notificaciones sobre el estado de su flujo de datos. Para obtener más información sobre las alertas, consulte la guía de suscripción a alertas de destinos mediante la interfaz de usuario.
Cuando haya terminado de proporcionar detalles para la conexión de destino, seleccione Siguiente.
Para activar los datos, necesita la variable Administrar destinos, Activar destinos, Ver perfiles y Ver segmentos permisos de control de acceso. Lea el información general sobre el control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
Consulte Activar datos de audiencia en destinos de exportación de perfil de flujo continuo para obtener instrucciones sobre la activación de segmentos de audiencia en este destino.
El Experience Platform optimiza el comportamiento de exportación de perfiles para su Amazon Kinesis de destino, para exportar solo los datos a su destino cuando se hayan producido actualizaciones relevantes en un perfil tras la calificación del segmento u otros eventos significativos. Los perfiles se exportan al destino en las siguientes situaciones:
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 un segmento asignado 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 estén los cambios. Por lo tanto, en el ejemplo anterior, todos los atributos asignados para esos cinco perfiles nuevos se exportan incluso si los atributos en sí no han cambiado.
En cuanto a los datos exportados para un perfil determinado, es importante comprender 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.
Qué determina una exportación de destino | Qué se incluye en la exportación de destino |
---|---|
|
|
Por ejemplo, considere este flujo de datos como un Amazon Kinesis destino donde se seleccionan tres segmentos en el flujo de datos y se asignan cuatro atributos al destino.
Una exportación de perfil al destino se puede determinar mediante un perfil que cumpla los requisitos de uno de los tres segmentos asignados. Sin embargo, en la exportación de datos, en la variable segmentMembership
(consulte Datos exportados a continuación), podrían aparecer otros segmentos sin asignar, si ese perfil en particular es miembro de ellos. Si un perfil es apto para el segmento Cliente con Autos DeLorean pero también es miembro de los segmentos de fans de películas y ciencia ficción "Volver al futuro" vistos, entonces estos otros dos segmentos también estarán presentes en segmentMembership
de la exportación de datos, aunque no estén asignados en el flujo de datos.
Desde el punto de vista de los atributos de perfil, cualquier cambio en los cuatro atributos asignados arriba 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.
Cuando agrega un segmento nuevo a un destino existente, o cuando crea un destino nuevo y le asigna segmentos, el Experience Platform exporta los datos históricos de clasificación de segmentos al destino. Perfiles que cumplen los requisitos del segmento before el segmento se agregó al destino se exporta al destino en aproximadamente una hora.
Su exportación Experience Platform los datos llegan a su Amazon Kinesis destino en formato JSON. Por ejemplo, la exportación siguiente contiene un perfil que se ha clasificado para un determinado segmento, es miembro de otros dos segmentos y salió de otro segmento. La exportación también incluye el nombre del atributo de perfil, los apellidos, la fecha de nacimiento y la 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":"existing"
},
"947c1c46-008d-40b0-92ec-3af86eaf41c1":{
"lastQualificationTime":"2021-08-25T23:37:33Z",
"status":"existing"
},
"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 Incluir nombres de segmentos y Incluir marcas de hora de segmentos opciones:
segmentMembership
sección"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
"name": "First name equals John"
}
}
}
segmentMembership
sección"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
}
}
}
En el 95 % de las veces, el Experience Platform intenta ofrecer una latencia de rendimiento inferior a 10 minutos para los mensajes enviados correctamente con una tasa inferior a 10 000 solicitudes por segundo para cada flujo de datos a un destino HTTP.
En caso de que haya solicitudes fallidas en el destino de la API HTTP, el Experience Platform almacena las solicitudes fallidas y los reintentos dos veces para enviar las solicitudes al extremo.