Connexion Amazon Kinesis

Présentation

IMPORTANT

Cette destination n’est disponible que pour Real-time Customer Data Platform Ultimate clients.

Le 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 à partir de Adobe Experience Platform.

Amazon Kinesis dans l’interface utilisateur

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 à convertir". En mappant le segment auquel 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.

Type et fréquence d'export

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 de la fonction workflow d’activation de destination.
Fréquence des exports Diffusion en continu Les destinations de diffusion en continu sont "toujours sur" des connexions basées sur l’API. Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des segments, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur 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 variable Amazon Kinesis destination. Voir LISTE AUTORISÉE d’adresses IP pour les destinations de diffusion en continu pour obtenir la liste complète des adresses IP à placer sur la liste autorisée.

Obligatoire Amazon Kinesis permissions

Pour établir une connexion et exporter des données vers votre 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/*"
            ]
        }
    ]
}
Propriété Description
kinesis:ListStreams Action qui répertorie vos flux de données Kinesis Amazon.
kinesis:PutRecord Action qui écrit un enregistrement de données unique dans un flux de données Kinesis.
kinesis:PutRecords Action qui écrit plusieurs enregistrements de données dans un flux de données Kinesis au cours d’un seul appel.

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

IMPORTANT

Pour vous connecter à la destination, vous avez besoin de l’événement Gestion des destinations autorisation de contrôle d’accès. Lisez le 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

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

Image de l’écran de l’interface utilisateur présentant les champs renseignés pour les détails de l’authentification Kinesis Amazon

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

Renseignement des détails de 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 d’Amazon Kinesis

  • Nom: Attribuez un nom à votre connexion pour Amazon Kinesis
  • Description: Fournissez une description de votre connexion à Amazon Kinesis.
  • stream: 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 segments que vous exportez. Pour un exemple d'export de données avec cette option sélectionnée, reportez-vous à la section Données exportées voir la section ci-dessous.
  • 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 segments, ainsi que l’horodatage UNIX lorsque les segments ont été mappés à la destination pour activation. Pour un exemple d'export de données avec cette option sélectionnée, reportez-vous à la section Données exportées voir la section ci-dessous.

Activer les alertes

Vous pouvez activer les alertes pour recevoir des notifications sur l’état du 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 les abonnement aux alertes de destinations à l’aide de l’interface utilisateur.

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

Activer des segments vers cette destination

IMPORTANT

Pour activer les données, vous avez besoin de l’événement Gestion des destinations, Activation des destinations, Afficher les profils, et Affichage de segments autorisations de contrôle d’accès. Lisez le présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

Voir Activation des données d’audience vers des destinations d’exportation de profils en continu pour obtenir des instructions sur l’activation des segments d’audience 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 du segment 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’adhésion au segment pour au moins un des segments mappés à la destination. Par exemple, le profil s’est qualifié pour l’un des segments mappés à la destination ou a quitté l’un des segments mappés à la destination.
  • La mise à jour du profil a été déterminée par une modification de la variable identity map. Par exemple, un profil qui s’était déjà qualifié pour l’un des segments mappés à la destination a été ajouté une nouvelle identité dans l’attribut identity map .
  • 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 où des mises à jour pertinentes se sont produites sont exportés vers votre destination. Par exemple, si un segment mappé au flux de destination comporte cent membres et que cinq nouveaux profils sont qualifiés pour le segment, l’exportation vers votre destination est incrémentielle et inclut uniquement les cinq nouveaux profils.

Notez que 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 n’ont pas changé.

Ce qui détermine un export de données et ce qui est inclus dans l’export

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 ;.

Ce qui détermine une exportation de destination Éléments inclus dans l’exportation de destination
  • Les attributs et segments mappés servent de repère pour une exportation de destination. Cela signifie que si un segment mappé change d’état (de null à Reçue ou de get/existing à Extioning) ou que tout attribut mappé est mis à jour, une exportation de destination est déclenchée.
  • Puisque les identités ne peuvent actuellement pas être mappées à Amazon Kinesis les destinations, les modifications de toute identité sur un profil donné déterminent également les exportations de destination.
  • Une modification pour un attribut est définie comme toute mise à jour de l’attribut, qu’il s’agisse ou non de la même valeur. Cela signifie qu’un remplacement sur un attribut est considéré comme une modification, même si la valeur elle-même n’a pas changé.
  • Tous les segments (avec le dernier état d’adhésion), qu’ils soient mappés ou non dans le flux de données, sont inclus dans la variable segmentMembership .
  • Toutes les identités dans la variable identityMap sont également inclus (l’Experience Platform ne prend actuellement pas en charge le mappage d’identité dans la variable Amazon Kinesis destination).
  • Seuls les attributs mappés sont inclus dans l’exportation de destination.

Par exemple, considérez ce flux de données comme un Amazon Kinesis destination où trois segments sont sélectionnés dans le flux de données et quatre attributs sont mappés à la destination.

Flux de données de destination Amazon Kinesis

Un export de profil vers la destination peut être déterminé 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 segments non mappés peuvent apparaître si ce profil particulier en fait partie. Si un profil est admissible pour le segment Client avec des voitures de Lorée, mais qu’il est également membre des segments de fans de films et de science-fiction "Retour vers le futur" de la visionneuse, ces deux autres segments seront également présents 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.

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 l’un des quatre attributs mappés présents sur le profil sera présent dans l’exportation des données.

Renvoi de données historiques

Lorsque vous ajoutez un nouveau segment à une destination existante, ou lorsque vous créez une destination et lui mappez des segments, Experience Platform exporte les données historiques de qualification de segment vers la destination. Profils qualifiés pour le segment before le segment ajouté à la destination est exporté vers la destination dans environ une heure.

Données exportées

Votre exportation Experience Platform Les données arrivent dans votre Amazon Kinesis destination au format JSON. Par exemple, l’exportation ci-dessous contient un profil qui s’est 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 email personnelle de l’attribut de profil. Les identités de ce profil sont ECID et email.

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

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 le Inclure les noms de segment et Inclure les horodatages de segment options :

 L’exemple d’exportation de données ci-dessous inclut les noms de segment dans la variable segmentMembership section
"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"
          }
        }
      }
 L’exemple d’exportation de données ci-dessous inclut des horodatages de segment dans la variable segmentMembership section
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Limites et stratégie de reprise

Dans 95 % des cas, l’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 requêtes par seconde pour chaque flux de données vers une destination HTTP.

En cas d’échec des requêtes vers votre destination d’API HTTP, Experience Platform stocke les requêtes en échec et tente à deux reprises d’envoyer les requêtes à votre point de terminaison .

Sur cette page