Azure Event Hubs connection

Información general

Azure Event Hubs es una plataforma de transmisión de grandes datos 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 utilizando cualquier proveedor de análisis en tiempo real o adaptadores de almacenamiento/lotes.

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

• Para obtener más información, consulte Azure Event Hubs, consulte la Documentación de Microsoft.
• Para conectarse a Azure Event Hubs mediante programación, consulte la Tutorial de la API de destinos de flujo continuo.
• Para conectarse a Azure Event Hubs con la interfaz de usuario de Platform, consulte las secciones siguientes.

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 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 Azure Event Hubs destino, recibiría este evento en Azure Event Hubs. 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.

Tipo de exportación y frecuencia

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

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 Azure Event Hubs 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.

Conectarse al destino

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

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

• Nombre de clave SAS: El nombre de la regla de autorización, que también se conoce como nombre de clave SAS.
• Clave de SAS: La clave principal del espacio de nombres de los centros de eventos. La variable sasPolicy que sasKey corresponde a debe tener administrar derechos configurados para que se rellene la lista de centros de eventos. Obtenga información sobre cómo autenticarse en Azure Event Hubs con claves SAS en la variable Documentación de Microsoft.
• Área de nombres: Rellene su Azure Event Hubs espacio de nombres. Obtenga información sobre Azure Event Hubs áreas de nombres en la variable Documentación de Microsoft.

Autenticación de firmas de acceso compartido (SAS)

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

• Nombre de clave SAS: El nombre de la regla de autorización, que también se conoce como nombre de clave SAS.
• Clave de SAS: La clave principal del espacio de nombres de los centros de eventos. La variable sasPolicy que sasKey corresponde a debe tener administrar derechos configurados para que se rellene la lista de centros de eventos. Obtenga información sobre cómo autenticarse en Azure Event Hubs con claves SAS en la variable Documentación de Microsoft.
• Área de nombres: Rellene su Azure Event Hubs espacio de nombres. Obtenga información sobre Azure Event Hubs áreas de nombres en la variable Documentación de Microsoft.
• Área de nombres: Rellene su Azure Event Hubs espacio de nombres. Obtenga información sobre Azure Event Hubs áreas de nombres en la variable Documentación de Microsoft.

Detalles de destino

Después de establecer la conexión de autenticación con el destino de los centros de eventos de Azure, proporcione la siguiente información para el destino:

• Nombre: Rellene un nombre para la conexión con 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 emisión a su Azure Event Hubs destino.
• Incluir nombres de segmentos: Alterne 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 hora de segmentos: Alterne 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.

Activar segmentos en este destino

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.

Comportamiento de exportación del perfil

El Experience Platform optimiza el comportamiento de exportación de perfiles para su Azure Event Hubs 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:

• La actualización de perfil se determinó mediante un cambio en la pertenencia a 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, un perfil que ya se había clasificado para uno de los segmentos asignados al destino se ha añadido una nueva identidad en el atributo de mapa de identidad.
• La actualización de perfil se determinó mediante 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 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.

Qué determina una exportación de datos y qué se incluye en la exportación

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 Azure Event Hubs destino y qué datos se incluyen en la exportación.

Por ejemplo, considere este flujo de datos como un Azure Event Hubs 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.

Relleno de datos históricos

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.

Datos exportados

Su exportación Experience Platform los datos llegan a su Azure Event Hubs 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": {
        "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": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Límites y política de reintentos

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.