Ultimate

Connexion Amazon Kinesis

Présentation

La variable Kinesis Data Streams service by Amazon Web Services vous permet de collecter et de traiter de grands flux d’enregistrements de données en temps réel.

Vous pouvez créer une connexion sortante en temps réel vers votre Amazon Kinesis stockage pour diffuser des données depuis Adobe Experience Platform.

• Pour plus d’informations sur Amazon Kinesis, voir Documentation Amazon.
• Pour vous connecter à Amazon Kinesis par programmation, voir la section Tutoriel sur l’API des destinations de diffusion en continu.
• Pour vous connecter à Amazon Kinesis à l’aide de l’interface utilisateur de Platform, consultez les sections ci-dessous.

Cas d’utilisation

En utilisant des destinations de diffusion en continu, telles que Amazon Kinesis, vous pouvez facilement alimenter les événements de segmentation à valeur élevée et les attributs de profil associés dans vos systèmes de 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 variable Amazon Kinesis destination, vous recevriez cet événement dans Amazon Kinesis. 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 le type d’audiences que vous pouvez exporter vers cette destination.

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.

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 variable Amazon Kinesis destination. Reportez-vous à la liste autorisée d’adresses IP pour les destinations en flux continu pour la liste complète des adresses IP à autoriser.

Autorisations Amazon Kinesis nécessaires

Pour établir une connexion et exporter des données vers Amazon Kinesis flux, l’Experience Platform a besoin d’autorisations pour les actions suivantes :

• kinesis:ListStreams
• kinesis:PutRecord
• kinesis:PutRecords

Ces autorisations sont organisées à l’aide de la fonction Kinesis et sont vérifiées par Platform une fois que vous avez configuré votre destination Kinesis dans l’interface utilisateur de Platform.

L’exemple ci-dessous présente les droits d’accès minimaux requis pour exporter les données vers un Kinesis destination.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:ListStreams",
                "kinesis:PutRecord",
                "kinesis:PutRecords"
            ],
            "Resource": [
                "arn:aws:kinesis:us-east-2:901341027596:stream/*"
            ]
        }
    ]
}

Pour plus d’informations sur le contrôle de l’accès à Kinesis flux de données, lisez ce qui suit Kinesis document.

Se connecter à la destination

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

Saisissez les champs ci-dessous et sélectionnez Se connecter à la destination:

• Amazon Web ServicesClé d’accès et clé secrète : dans Amazon Web Services, générez une paire access key - secret access key pour accorder à Platform l’accès à votre compte Amazon Kinesis. En savoir plus dans la Documentation Amazon Web Services.
• Région: indique laquelle Amazon Web Services région vers laquelle diffuser des données.

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.

• Nom: attribuez un nom à votre connexion pour Amazon Kinesis
• Description: fournissez une description de votre connexion à Amazon Kinesis.
• Diffusion: indiquez le nom d’un flux de données existant dans votre Amazon Kinesis compte . Platform exportera les données vers ce flux.
• Inclure les noms de segment: basculez si vous souhaitez que l’exportation des données contienne 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

Voir Activation des données d’audience vers des destinations d’exportation de profils en continu pour obtenir des instructions sur l’activation des audiences vers cette destination.

Comportement d’exportation de profils

Experience Platform optimise le comportement d’exportation de profils dans votre Amazon Kinesis destination : pour exporter uniquement les données vers votre destination lorsque des mises à jour pertinentes 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 une modification de l’appartenance à une 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 ce qui détermine l’exportation des données vers votre Amazon Kinesis destination et les données incluses dans l’exportation ;.

Par exemple, considérez ce flux de données comme un Amazon Kinesis destination où trois audiences sont sélectionnées dans le flux de donné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. Toutefois, dans l’exportation des données, dans la variable segmentMembership (voir 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 la variable Client avec des voitures DeLorean mais est également membre de la fonction "Retour vers l'avenir" film et Fans de science-fiction audiences, ces deux autres audiences seront également présentes dans la variable 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 stratégie de fusion avec l’objet Client avec des voitures DeLorean segment.

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. Profils qualifiés pour l'audience before l’audience a été ajoutée à la destination et est exportée 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 Amazon Kinesis 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

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.