Azure Event Hubs conexión

Información general

IMPORTANTE

Este destino solo está disponible para Adobe Real-time Customer Data Platform Ultimate clientes.

Azure Event Hubs es una plataforma de streaming de big data y un servicio de ingesta de eventos. Puede recibir y procesar millones de eventos por segundo. Los datos enviados a un centro de eventos se pueden transformar y almacenar mediante cualquier proveedor de análisis en tiempo real o adaptador de almacenamiento/agrupamiento.

Puede crear una conexión saliente en tiempo real con su Azure Event Hubs almacenamiento para transmitir datos desde Adobe Experience Platform.

AWS Kinesis en la IU

Casos de uso

Mediante destinos de flujo continuo como Azure Event Hubs, 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 documento técnico que le clasifica en un segmento de "alta tendencia a la conversión". Asignando el segmento en el que se encuentra el cliente potencial al Azure Event Hubs destino, recibiría este evento en Azure Event Hubs. 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.

Tipo y frecuencia de exportación

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 Va a exportar 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 streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según la evaluación de segmentos, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.

LISTA DE PERMITIDOS de direcciones IP

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 Azure Event Hubs destino. Consulte LISTA DE PERMITIDOS de direcciones IP para destinos de flujo continuo para obtener la lista completa de direcciones IP que se van a lista de permitidos.

Conectar con el destino

IMPORTANTE

Para conectarse al destino, necesita el Administrar destinos permiso de control de acceso. Lea el información general de 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:

Información de autenticación

Autenticación estándar

Imagen de la pantalla de la IU que muestra los campos completados para los detalles de autenticación estándar de Azure Event Hubs

Si selecciona la opción Autenticación estándar escriba para conectarse al extremo HTTP, introduzca los campos siguientes y seleccione Conectar con destino:

  • Nombre de clave SAS: Nombre de la regla de autorización, que también se conoce como nombre de clave SAS.
  • Clave SAS: la clave principal del área de nombres de Event Hubs. El sasPolicy que el sasKey corresponde a debe tener administrar derechos configurados para que se rellene la lista Event Hubs. Obtenga información sobre la autenticación en Azure Event Hubs con claves SAS en el Documentación de Microsoft.
  • Área de nombres: Rellene el Azure Event Hubs namespace. Más información Azure Event Hubs áreas de nombres en Documentación de Microsoft.

Autenticación de firma de acceso compartido (SAS)

Imagen de la pantalla de la IU que muestra los campos completados para los detalles de autenticación estándar de Azure Event Hubs

Si selecciona la opción Autenticación estándar escriba para conectarse al extremo HTTP, introduzca los campos siguientes y seleccione Conectar con destino:

  • Nombre de clave SAS: Nombre de la regla de autorización, que también se conoce como nombre de clave SAS.
  • Clave SAS: la clave principal del área de nombres de Event Hubs. El sasPolicy que el sasKey corresponde a debe tener administrar derechos configurados para que se rellene la lista Event Hubs. Obtenga información sobre la autenticación en Azure Event Hubs con claves SAS en el Documentación de Microsoft.
  • Área de nombres: Rellene el Azure Event Hubs namespace. Más información Azure Event Hubs áreas de nombres en Documentación de Microsoft.
  • Nombre del hub de eventos: Rellene el Azure Event Hub nombre . Más información Azure Event Hubs nombres en la Documentación de Microsoft.

Rellenar detalles de destino

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.

Imagen de la pantalla de la IU que muestra los campos completados para los detalles de destino de Azure Event Hubs

  • Nombre: Rellene un nombre para la conexión a Azure Event Hubs.
  • Descripción: Proporcione una descripción de la conexión. Ejemplos: "Clientes de nivel Premium", "Clientes interesados en el kitesurf".
  • eventHubName: Proporcione un nombre para la secuencia a su Azure Event Hubs destino.
  • Incluir nombres de segmentos: cambie si desea que la exportación de datos incluya los nombres de los segmentos que está exportando. Para ver un ejemplo de exportación de datos con esta opción seleccionada, consulte la Datos exportados más abajo.
  • Incluir marcas de tiempo de segmentos: Marque esta opción si desea que la exportación de datos incluya la marca de tiempo UNIX cuando se crearon y actualizaron los segmentos, así como la marca de tiempo UNIX cuando los segmentos se asignaron al destino para la activación. Para ver un ejemplo de exportación de datos con esta opción seleccionada, consulte la Datos exportados más abajo.

Habilitar alertas

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 de suscripción a alertas de destinos mediante la IU.

Cuando haya terminado de proporcionar detalles para la conexión de destino, seleccione Siguiente.

Activar segmentos en este destino

IMPORTANTE

Para activar los datos, necesita el Administrar destinos, Activar destinos, Ver perfiles, y Ver segmentos permisos de control de acceso. Lea el información general de control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Consulte Activación de datos de audiencia en destinos de exportación de perfil de flujo continuo para obtener instrucciones sobre cómo activar segmentos de audiencia en este destino.

Comportamiento de exportación de perfil

El Experience Platform optimiza el comportamiento de exportación de perfiles a Azure Event Hubs destino, para exportar solo datos a su destino cuando se hayan producido actualizaciones relevantes en un perfil tras la calificación de segmentos 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 de segmentos para al menos uno de los segmentos asignados al destino. Por ejemplo, el perfil se ha clasificado para uno de los segmentos asignados al destino o ha salido de uno de los segmentos asignados al destino.
  • La actualización de perfil se determinó mediante un cambio en la variable mapa de identidad. Por ejemplo, a un perfil que ya se había clasificado para uno de los segmentos asignados 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 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 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

Con respecto a los datos que se exportan para un perfil determinado, es importante comprender los dos conceptos diferentes de qué determina una exportación de datos a su Azure Event Hubs 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
  • Los atributos y segmentos asignados sirven de referencia para una exportación de destino. Esto significa que si algún segmento asignado cambia de estado (de null hasta realized o de realized hasta exiting) o se actualiza cualquier atributo asignado, se inicia una exportación de destino.
  • Dado que las identidades no se pueden asignar actualmente a Azure Event Hubs 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 segmentMembership El objeto incluye el segmento asignado en el flujo de datos de activación, para el cual el estado del perfil ha cambiado después de un evento de calificación o salida de segmento. Tenga en cuenta que otros segmentos no asignados para los que el perfil cumple los requisitos pueden formar parte de la exportación de destino, si estos segmentos pertenecen al mismo política de combinación como el segmento asignado en el flujo de datos de activación.
  • Todas las identidades en identityMap también se incluyen los objetos de (actualmente, el Experience Platform no admite la asignación de identidades en Azure Event Hubs destino).
  • En la exportación de destino solo se incluyen los atributos asignados.

Por ejemplo, considere este flujo de datos como una Azure Event Hubs destino en el que se seleccionan tres segmentos en el flujo de datos y se asignan cuatro atributos al destino.

Flujo de datos de destino de Amazon Kinesis

Una exportación de perfil al destino puede determinarse mediante un perfil que cumpla los requisitos de uno de los siguientes criterios o que salga de él tres segmentos asignados. Sin embargo, en la exportación de datos, en la variable segmentMembership objeto (consulte Datos exportados , podrían aparecer otros segmentos no asignados, si ese perfil en particular es miembro de ellos y si comparten la misma política de combinación que el segmento que activó la exportación. Si un perfil cumple los requisitos para la Cliente con coches DeLorean segmento, pero también es miembro del Visto "Volver al futuro" película y Aficionados a la ciencia ficción segmentos, estos otros dos segmentos también estarán presentes en el segmentMembership objeto de la exportación de datos, aunque no estén asignados en el flujo de datos, si comparten la misma política de combinación con el Cliente con coches DeLorean segmento.

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

Al agregar un segmento nuevo a un destino existente o al crear un destino nuevo y asignar segmentos a él, Experience Platform exporta datos históricos de calificación de segmentos al destino. Perfiles aptos para el segmento antes el segmento se añadió al destino y se exportó al destino en un plazo aproximado de una hora.

Datos exportados

Su exportado Experience Platform Los datos de aterrizan en su Azure Event Hubs destino 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 seleccionada en el flujo de destino de conexión para Incluir nombres de segmentos y Incluir marcas de tiempo de segmentos opciones:

 El ejemplo de exportación de datos siguiente incluye nombres de segmento en la variable segmentMembership sección
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }
 El ejemplo de exportación de datos siguiente incluye marcas de tiempo de segmentos en la variable segmentMembership sección
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Límites y directiva de reintentos

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.

En esta página