Présentation de l’extension AWS

NOTE
Adobe Experience Platform Launch est désormais une suite de technologies destinées à la collecte de données dans Adobe Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

Amazon Web Services (AWS) est une plateforme de cloud computing qui offre un large éventail de services tels que l’informatique distribuée, le stockage de base de données, la diffusion de contenu et les services d’intégration de logiciels en tant que service (SaaS) pour la gestion de la relation client (CRM) et la planification des ressources de l’entreprise (ERP).

L’extension AWS de transfert d’événement exploite Amazon Kinesis Data Streams pour envoyer des événements de l’Edge Network Adobe Experience Platform vers AWS en vue d’un traitement ultérieur. Ce guide explique comment installer l’extension et utiliser ses fonctionnalités dans une règle de transfert d’événement.

Conditions préalables

Pour utiliser cette extension, vous devez disposer d’un compte AWS avec un flux de données Kinesis existant. Si vous ne disposez pas d’un flux de données préexistant, reportez-vous à la documentation AWS sur la création d’un nouveau flux de données à l’aide de la AWS console de gestion.

Installation l’extension install

Pour installer l’extension AWS, accédez à l’interface utilisateur de collecte de données ou à l’interface utilisateur Experience Platform et sélectionnez Transfert d’événement dans le volet de navigation de gauche. À partir de là, sélectionnez une propriété à laquelle ajouter l’extension ou créez une propriété à la place.

Une fois que vous avez sélectionné ou créé la propriété souhaitée, sélectionnez Extensions dans le volet de navigation de gauche, puis sélectionnez l’onglet Catalogue . Recherchez la carte AWS, puis sélectionnez Installer.

Bouton Installer sélectionné pour l’extension AWS dans l’interface utilisateur de la collecte de données.

Sur l’écran suivant, vous devez fournir les informations d’identification de connexion pour votre compte AWS. Plus précisément, vous devez fournir votre ID de clé d’accès AWS et votre clé d’accès secrète. Si vous ne connaissez pas ces valeurs, consultez la documentation AWS sur comment obtenir votre ID de clé d'accès et votre clé d'accès secrète.

Lidentifiant de la clé daccès et la clé daccès secrète ajoutés dans la vue de configuration de lextension.

IMPORTANT
Une stratégie d’accès doit être jointe au compte AWS utilisé pour générer les informations d’identification d’accès. Cette stratégie doit être configurée pour accorder des droits d’accès pour envoyer des données au flux de données Kinesis. Reportez-vous à Exemple 2 dans le document AWS sur exemples de stratégies pour Kinesis Data Streams pour voir comment la stratégie doit être définie.

Lorsque vous avez terminé, sélectionnez Save et l’extension est installée.

Configurer une règle de transfert d’événement rule

Après avoir installé l’extension, créez un transfert d’événement rule et configurez ses conditions selon vos besoins. Lors de la configuration des actions pour la règle, sélectionnez l’extension AWS, puis sélectionnez Envoyer les données au flux de données Kinesis pour le type d’action.

Le type d’action Envoyer des données au flux de données Kinesis est sélectionné pour une règle dans l’interface utilisateur de collecte de données.

Le panneau de droite se met à jour afin d’afficher les options de configuration permettant d’envoyer les données. Plus précisément, vous devez affecter des éléments de données aux différentes propriétés qui représentent votre configuration Event Hub.

Les options de configuration pour le type d’action Envoyer des données au flux de données Kinesis affiché dans l’interface utilisateur.

Détails du flux de données Kinesis

Entrée
Description
Nom du flux
Le nom du flux vers lequel cette règle de transfert d’événement enverra des enregistrements de données.
Région AWS
Région AWS où le flux de données Kinesis est créé.
Clé de partition
clé de partition que l’extension utilisera lors de l’envoi de données au flux de données.

Kinesis Data Streams divise les enregistrements de données appartenant à un flux en plusieurs partages. Elle utilise la clé de partition envoyée avec chaque enregistrement de données pour déterminer à quel partage appartient un enregistrement de données donné.

Une bonne clé de partition pour distribuer les clients peut être le numéro de client, car il est différent pour chaque client. Une mauvaise clé de partition peut leur code postal car ils peuvent tous se trouver dans la même zone à proximité. En règle générale, vous devez choisir une clé de partition ayant la plus grande plage de valeurs potentielles différentes. Consultez l’article AWS sur la mise à l’échelle de vos Kinesis flux de données pour connaître les bonnes pratiques en matière de gestion des clés de partition.

Data (Données)

Entrée
Description
Charge utile
Ce champ contient les données qui seront transférées vers le flux de données Kinesis, au format JSON.

Sous l’option Brut, vous pouvez coller l’objet JSON directement dans le champ de texte fourni, ou vous pouvez sélectionner l’icône d’élément de données ( Icône Jeu de données ) pour effectuer une sélection dans une liste d’éléments de données existants pour représenter la charge utile.

Vous pouvez également utiliser l’option Éditeur de paires clé-valeur JSON pour ajouter manuellement chaque paire clé-valeur via un éditeur d’interface utilisateur. Chaque valeur peut être représentée par une entrée brute ou un élément de données peut être sélectionné à la place.

Lorsque vous avez terminé, sélectionnez Conserver les modifications pour ajouter l’action à la configuration de la règle. Lorsque la règle vous satisfait, sélectionnez Enregistrer dans la bibliothèque.

Enfin, publiez un nouveau transfert d’événement build pour activer les modifications apportées à la bibliothèque.

Étapes suivantes

Ce guide explique comment envoyer des données à Kinesis Data Streams à l’aide de l’extension de transfert d’événement AWS. Pour plus d’informations sur les fonctionnalités de transfert d’événement en Experience Platform, consultez la présentation du transfert d’événement.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743