Documentation Experience Platform Guide des destinations

Ultimate

Connexion Azure Event Hubs

Dernière mise à jour : 16 juillet 2024

Rubriques :
Destinations

Créé pour :

Administration
Utilisateur ou utilisatrice

Présentation

IMPORTANT

Cette destination est disponible uniquement pour les clients d’Adobe Real-Time Customer Data Platform Ultimate.

Azure Event Hubs est une plateforme de diffusion en continu de données volumineuses 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 hub d’événements peuvent être transformées et stockées à l’aide de n’importe quel fournisseur d’analyses en temps réel ou d’adaptateurs de traitement par lot/stockage.

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

Pour plus d’informations sur Azure Event Hubs, consultez la documentation Microsoft.
Pour vous connecter à Azure Event Hubs par programmation, consultez le tutoriel sur l’API des destinations de diffusion en continu.
Pour vous connecter à Azure Event Hubs à l’aide de l’interface utilisateur de Platform, reportez-vous aux sections ci-dessous.

Kinesis AWS dans l’interface utilisateur

Cas d’utilisation

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

Par exemple, un prospect a téléchargé un livre blanc qui les qualifie en segment "forte propension à la conversion". En mappant l’audience que le prospect appartient à la destination Azure Event Hubs, vous recevrez cet événement dans Azure Event Hubs. Vous pouvez y utiliser une approche par vous-même et décrire la logique commerciale en plus de l’événement, comme vous le pensez, qui fonctionne le mieux avec vos systèmes informatiques d’entreprise.

Audiences prises en charge

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

Origine de l’audience	Pris en charge	Description
Segmentation Service	✓	Audiences générées par l’Experience Platform Segmentation Service.
Chargements personnalisés	✓	Audiences importées dans Experience Platform à partir de fichiers CSV.

Type et fréquence d’exportation

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

Élément	Type	Notes
Type d’exportation	Basé sur les profils	Vous exportez tous les membres d’un segment, ainsi que les champs de schéma de votre choix (par exemple : adresse électronique, numéro de téléphone, nom), tel que sélectionné dans l’écran de sélection des attributs de profil du workflow d’activation de destination.
Fréquence des exportations	Diffusion en continu	Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des audiences, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.

Liste autorisée d’adresses IP

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

IMPORTANT

Pour vous connecter à la destination, vous avez besoin des et des 🔗 autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

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

Authentification standard

Image de l’écran de l’interface utilisateur affichant les champs remplis pour les détails d’authentification standard Azure Event Hubs

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

Nom de clé SAS : nom de la règle d’autorisation, également appelé nom de clé SAS.
Clé SAS : clé primaire de l’espace de noms Event Hubs. Les droits sasPolicy auxquels correspond sasKey doivent être manage pour que la liste des centres d’événements soit renseignée. Découvrez comment vous authentifier à Azure Event Hubs avec des clés SAS dans la documentation Microsoft.
Espace de noms : renseignez votre espace de noms Azure Event Hubs. Découvrez les espaces de noms Azure Event Hubs dans la documentation Microsoft.

Authentification SAS (Shared Access Signature)

Image de l’écran de l’interface utilisateur affichant les champs remplis pour les détails d’authentification standard Azure Event Hubs

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

Nom de clé SAS : nom de la règle d’autorisation, également appelé nom de clé SAS.
Clé SAS : clé primaire de l’espace de noms Event Hubs. Les droits sasPolicy auxquels correspond sasKey doivent être manage pour que la liste des centres d’événements soit renseignée. Découvrez comment vous authentifier à Azure Event Hubs avec des clés SAS dans la documentation Microsoft.
Espace de noms : renseignez votre espace de noms Azure Event Hubs. Découvrez les espaces de noms Azure Event Hubs dans la documentation Microsoft.
Nom du hub d’événements : renseignez votre nom Azure Event Hub . Découvrez les Azure Event Hubs noms dans la documentation Microsoft.

Renseigner les détails de la destination

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.

Image de l’écran de l’interface utilisateur affichant les champs remplis pour les détails de destination Azure Event Hubs

Nom : renseignez un nom pour la connexion à Azure Event Hubs.
Description : fournissez une description de la connexion. Exemples : "Clients Premium", "Clients intéressés par le kitesurfing".
eventHubName : donnez un nom au flux vers votre destination Azure Event Hubs.
Inclure les noms de segment : basculez si vous souhaitez que l’exportation des données inclut les noms des audiences que vous exportez. Pour un exemple d’exportation de données avec cette option sélectionnée, reportez-vous à la section Données exportées plus bas.
Inclure les horodatages de segment : basculez si vous souhaitez que l’exportation des données inclue l’horodatage UNIX lors de la création et de la mise à jour des audiences, ainsi que l’horodatage UNIX lorsque les audiences ont été mappées à la destination pour l’activation. Pour un exemple d’exportation de données avec cette option sélectionnée, reportez-vous à la section Données exportées plus bas.

Activer les alertes

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

IMPORTANT

Pour activer les données, vous avez besoin des , Activer les destinations, et autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
L’évaluation de la stratégie de consentement n’est actuellement pas prise en charge dans les exportations vers la destination Azure Event Hubs. En savoir plus.

Pour obtenir des instructions sur l’activation des audiences vers cette destination, reportez-vous à la section Activation des données d’audience vers des destinations d’exportation de profils en continu .

Comportement d’exportation de profils

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

La mise à jour du profil a été déterminée par un changement de l’appartenance à l’audience pour au moins une des audiences mappées à la destination. Par exemple, le profil est éligible à l’une des audiences mappées à la destination ou a quitté l’une de ces audiences.
La mise à jour du profil a été déterminée par une modification dans le mappage d’identités. Par exemple, une nouvelle identité a été ajoutée dans l’attribut de mappage d’identités à un profil qui était déjà éligible à l’une des audiences mappées à la destination.
La mise à jour du profil a été déterminée par une modification des attributs pour au moins un des attributs mappés à la destination. Par exemple, l’un des attributs mappés à la destination dans l’étape de mappage est ajouté à un profil.

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.

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

Ce qui détermine une exportation de destination Éléments inclus dans l’exportation de destination

Ce qui détermine une exportation de destination	Éléments inclus dans l’exportation de destination
Les attributs et audiences mappés servent de repère pour un export de destination. Cela signifie que si une audience mappée change d’état (de `null` à `realized` ou de `realized` à `exiting`) ou qu’un attribut mappé est mis à jour, une destination est exportée. Comme les identités ne peuvent actuellement pas être mappées aux destinations Azure Event Hubs, les modifications d’identité sur un profil donné déterminent également les exportations de destination. Toute modification pour un attribut est considérée comme une mise à jour, qu’il s’agisse ou non de la même valeur. Cela signifie qu’une réécriture sur un attribut est considérée comme une modification, même si la valeur elle-même n’a pas changé.	L’objet `segmentMembership` inclut l’audience mappée dans le flux de données d’activation, pour lequel le statut du profil a changé suite à un événement d’éligibilité ou de sortie d’audience. Notez que d’autres audiences non mappées pour lesquelles le profil est éligible peuvent faire partie de l’export de destination, si ces audiences appartiennent à la même politique de fusion que l’audience mappée dans le flux de données d’activation. Toutes les identités de l’objet `identityMap` sont également incluses (l’Experience Platform ne prend actuellement pas en charge le mappage d’identité dans la destination Azure Event Hubs). Seuls les attributs mappés sont inclus dans l’exportation de destination.

Les attributs et audiences mappés servent de repère pour un export de destination. Cela signifie que si une audience mappée change d’état (de null à realized ou de realized à exiting) ou qu’un attribut mappé est mis à jour, une destination est exportée.
Comme les identités ne peuvent actuellement pas être mappées aux destinations Azure Event Hubs, les modifications d’identité sur un profil donné déterminent également les exportations de destination.
Toute modification pour un attribut est considérée comme une mise à jour, qu’il s’agisse ou non de la même valeur. Cela signifie qu’une réécriture sur un attribut est considérée comme une modification, même si la valeur elle-même n’a pas changé.

L’objet segmentMembership inclut l’audience mappée dans le flux de données d’activation, pour lequel le statut du profil a changé suite à un événement d’éligibilité ou de sortie d’audience. Notez que d’autres audiences non mappées pour lesquelles le profil est éligible peuvent faire partie de l’export de destination, si ces audiences appartiennent à la même politique de fusion que l’audience mappée dans le flux de données d’activation.
Toutes les identités de l’objet identityMap sont également incluses (l’Experience Platform ne prend actuellement pas en charge le mappage d’identité dans la destination Azure Event Hubs).
Seuls les attributs mappés sont inclus dans l’exportation de destination.

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

Flux de données de destination Amazon Kinesis

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, dans 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 si elles partagent la même stratégie de fusion que l’audience qui a déclenché l’exportation. Si un profil est admissible pour l’audience Client avec des DeLorean Cars, mais qu’il est également membre du film Watched "Back to the Future" et des segments fans de science fiction, ces deux autres audiences seront également présentes dans l’objet segmentMembership de l’exportation de données, même si elles ne sont pas mappées dans le flux de données, si elles partagent la même stratégie de fusion avec la même Client avec des DeLorean Cars.

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

Lorsque vous ajoutez une nouvelle audience à une destination existante, ou lorsque vous créez une destination et que vous mappez des audiences avec celle-ci, l’Experience Platform exporte les données historiques de qualification des audiences vers la destination. Les profils qui remplissent les critères de l’audience avant l’audience a été ajoutée à la destination sont exportés vers la destination dans un délai d’environ une heure.

Données exportées

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 :

L’exemple d’exportation de données ci-dessous inclut les noms d’audience dans la section segmentMembership .

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

L’exemple d’exportation de données ci-dessous inclut les horodatages d’audience dans la section segmentMembership .

"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

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.

recommendation-more-help