[Ultimate]{class="badge positive"}

Connexion Azure Event Hubs

Présentation overview

Azure Event Hubs est une plateforme de streaming big data et un service d'ingestion d'événements. Il peut recevoir et traiter des millions d’événements par seconde. Les données envoyées à un centre d’événements peuvent être transformées et stockées à l’aide de n’importe quel fournisseur d’analyses en temps réel ou de cartes de traitement par lots/stockage.

Vous pouvez créer une connexion sortante en temps réel vers votre stockage Azure Event Hubs pour diffuser des données à partir de Adobe Experience Platform.

Cas d’utilisation use-cases

En utilisant des destinations de diffusion en continu telles que Azure Event Hubs, vous pouvez facilement alimenter vos systèmes de votre choix en événements de segmentation à forte valeur et en attributs de profil associés.

Par exemple, un prospect a téléchargé un article technique qui le qualifie en segment « à forte propension à convertir ». En mappant l’audience dans laquelle le prospect se trouve à la destination Azure Event Hubs, vous recevrez cet événement en Azure Event Hubs. Vous pouvez y adopter une approche autonome et décrire la logique commerciale en amont de l’événement, comme vous pensez qu’il conviendrait le mieux à vos systèmes informatiques d’entreprise.

Audiences prises en charge supported-audiences

Cette section décrit les types d’audiences que vous pouvez exporter vers cette destination.

Type et fréquence d’exportation export-type-frequency

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Liste autorisée d’adresses IP ip-address-allowlist

Pour répondre aux exigences de sécurité et de conformité des clients, Experience Platform fournit une liste d’adresses IP statiques que vous pouvez placer sur la liste autorisée pour la destination Azure Event Hubs. Reportez-vous à la liste autorisée d’adresses IP pour les destinations en flux continu pour la liste complète des adresses IP à autoriser.

Se connecter à la destination connect

Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Lors de la connexion à cette destination, vous devez fournir les informations suivantes :

Informations d’authentification authentication-information

Authentification standard standard-authentication

Si vous sélectionnez le type Authentification standard pour vous connecter à votre point d’entrée HTTP, saisissez les champs ci-dessous et sélectionnez Se connecter à la destination :

Authentification SAS (Shared Access Signature) sas-authentication

Si vous sélectionnez le type Authentification standard pour vous connecter à votre point d’entrée HTTP, saisissez les champs ci-dessous et sélectionnez Se connecter à la destination :

Renseigner les détails de la destination destination-details

Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.

Activer les alertes enable-alerts

Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.

Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.

Activer des audiences vers cette destination activate

Consultez Activer les données d’audience vers des destinations d’exportation de profil de diffusion en continupour obtenir des instructions sur l’activation des audiences vers cette destination.

Comportement d’exportation de profils profile-export-behavior

Experience Platform optimise le comportement d’exportation de profils vers votre destination Azure Event Hubs afin de n’exporter des données vers votre destination que lorsque des mises à jour pertinentes d’un profil se sont produites à la suite de la qualification d’une audience ou d’autres événements significatifs. Les profils sont exportés vers votre destination dans les situations suivantes :

Dans tous les cas décrits ci-dessus, seuls les profils pour lesquels des mises à jour pertinentes se sont produites sont exportés vers votre destination. Par exemple, si une audience mappée au flux de destination comporte cent membres et que cinq nouveaux profils sont éligibles à ce segment, l’exportation vers votre destination est incrémentielle et inclut uniquement les cinq nouveaux profils.

Remarque : tous les attributs mappés sont exportés pour un profil, quel que soit l’emplacement des modifications. Ainsi, dans l’exemple ci-dessus, tous les attributs mappés pour ces cinq nouveaux profils seront exportés même si les attributs eux-mêmes restent inchangés.

Ce qui détermine une exportation de données et ce qui est inclus dans l’exportation. what-determines-export-what-is-included

Concernant les données exportées pour un profil donné, il est important de comprendre les deux concepts différents entre ce qui détermine l’exportation de données vers votre destination Azure Event Hubs et quelles données sont incluses dans l’exportation.

Prenons l’exemple d’un flux de données vers une destination Azure Event Hubs dans lequel trois audiences sont sélectionnées et quatre attributs sont mappés à la destination.

Une exportation de profil vers la destination peut être déterminée par un profil éligible ou sortant de l’un des trois segments mappés. Cependant, lors de l’exportation des données, dans l’objet segmentMembership (voir la section Données exportées ci-dessous), d’autres audiences non mappées peuvent apparaître si ce profil particulier en est membre et s’il partage la même politique de fusion que l’audience qui a déclenché l’exportation. Si un profil est qualifié pour l’audience Client avec des voitures DeLorean, mais qu’il est également membre des segments Film « Retour vers le futur » visionné et Fans de science-fiction, alors ces deux autres audiences seront également présentes dans l’objet segmentMembership de l’exportation des données, même si elles ne sont pas mappées dans le flux de données, si elles partagent la même politique de fusion que le segment Client avec des voitures DeLorean.

Du point de vue des attributs de profil, toute modification apportée aux quatre attributs mappés ci-dessus déterminera une exportation de destination et chacun de ces quatre attributs mappés et présents sur le profil sera présent dans l’exportation des données.

Renvoyer des données historiques historical-data-backfill

Lorsque vous ajoutez une nouvelle audience à une destination existante, ou lorsque vous créez une nouvelle destination et que vous y mappez des audiences, Experience Platform exporte les données historiques de qualification d’audience vers la destination. Les profils qualifiés pour l’audience auparavant celle-ci a été ajoutée à la destination sont exportés vers la destination sous une heure environ.

Données exportées exported-data

Les données Experience Platform exportées arrivent dans votre destination Azure Event Hubs au format JSON. Par exemple, l’exportation ci-dessous contient un profil qualifié pour un certain segment, qui est membre de deux autres segments et qui a quitté un autre segment. L’exportation inclut également le prénom, le nom, la date de naissance et l’adresse e-mail personnelle de l’attribut de profil. Les identités de ce profil sont ECID et e-mail.

{
  "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"
      }
    ]
  }
}

Vous trouverez ci-dessous d’autres exemples de données exportées, en fonction des paramètres de l’interface utilisateur que vous sélectionnez dans le flux de connexion à la destination pour les options Inclure les noms de segment et Inclure la date et l’heure de segment  :

"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"
          }
        }
      }

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Politique de limitation et de reprise limits-retry-policy

Dans 95 % des cas, Experience Platform tente d’offrir une latence de débit inférieure à 10 minutes pour les messages envoyés avec succès, avec un taux de moins de 10 000 demandes par seconde pour chaque flux de données vers une destination HTTP.

En cas d’échec des requêtes vers la destination API HTTP, Experience Platform stocke les requêtes ayant échoué et tente à deux reprises d’envoyer les requêtes à votre point d’entrée.