Ingestion de données Algolia User Profiles dans Experience Platform à l’aide de l’interface utilisateur
Ce tutoriel vous guide tout au long de l’ingestion de données à partir de votre compte Algolia User Profiles dans Adobe Experience Platform à l’aide de l’interface utilisateur.
Commencer
Ce tutoriel suppose que vous connaissez les composants Experience Platform suivants :
-
Experience Data Model (XDM) Système : cadre normalisé utilisé par Experience Platform pour organiser les données d’expérience client.
- Principes de base de la composition des schémas : découvrez la composition des schémas, y compris les principes clés et les bonnes pratiques.
- Tutoriel sur l’éditeur de schémas : découvrez comment créer des schémas personnalisés à l’aide de l’interface utilisateur de l’éditeur de schémas.
-
Real-Time Customer Profile : profil client en temps réel unifié basé sur des données agrégées issues de plusieurs sources.
-
Sources : ingérez des données provenant de diverses sources et utilisez les services Experience Platform pour structurer, étiqueter et améliorer les données.
Collecter les informations d’identification requises
Pour connecter Algolia à Adobe Experience Platform, fournissez les informations d’identification suivantes :
Pour plus d’informations, consultez la Algolia documentation sur l’authentification.
Connecter votre compte Algolia
Dans l’interface utilisateur d’Experience Platform, sélectionnez Sources dans le volet de navigation de gauche pour ouvrir l’espace de travail Sources. Utilisez le panneau Catégories ou la barre de recherche pour trouver la source de votre choix.
Pour vous connecter Algolia, sélectionnez la carte source Algolia sous Partenaires de données et d’identité et sélectionnez Configurer.
Authentification
Utiliser un compte existant
Pour utiliser un compte existant, choisissez Compte existant et sélectionnez le compte Algolia User Profiles à utiliser. Sélectionnez ensuite Suivant.
Créer un nouveau compte
Pour créer un compte, sélectionnez Nouveau compte, puis entrez un nom, une description facultative et vos informations d’identification Algolia. Sélectionnez Se connecter à la source et attendez que la connexion soit établie.
Ajouter des données
Une fois votre compte Algolia User Profiles créé, l’étape Ajouter des données s’affiche. Utilisez-le pour sélectionner et prévisualiser les données de profil utilisateur pour l’ingestion.
- Sur la gauche, saisissez les Indices et Affinité(s) facultatifs.
- Sur la droite, prévisualisez jusqu’à 100 lignes de profils utilisateur.
Une fois que vous avez terminé, sélectionnez Suivant.
Fournir des détails sur le flux de données
Si vous utilisez un jeu de données existant, choisissez-en un associé à un schéma qui inclut le groupe de champs Algolia Profile. Assurez-vous que le champ Algolia User Token utilise l’espace de noms d’identité Algolia User Token. Si le Algolia User Token n’est pas créé ou affecté actuellement, suivez les instructions ci-dessous.
Si vous créez un jeu de données, sélectionnez un schéma à l’aide du groupe de champs Algolia Profile .
Créer Algolia User Token espace de noms d’identité
Vous devrez créer l’espace de noms d’identité Algolia User Token s’il n’existe pas déjà dans votre organisation.
Utilisez le volet de navigation de gauche et sélectionnez Identités pour accéder à l’espace de travail de l’interface utilisateur du Service d’identités, puis sélectionnez Créer un espace de noms d’identité.
Ensuite, fournissez un Nom d’affichage et un Symbole d’identité pour votre espace de noms personnalisé. Au cours de cette étape, vous devez également configurer le type de votre espace de noms. Lorsque vous avez terminé, cliquez sur Créer.
Une fois ajouté, l’espace de noms apparaît dans la liste. Vous pouvez maintenant l’appliquer dans votre schéma.
Application de votre espace de noms à votre schéma
Utilisez le volet de navigation de gauche et sélectionnez Schémas pour accéder à l’espace de travail de l’interface utilisateur Schémas. Utilisez l’espace de travail des schémas pour créer ou mettre à jour un schéma avec le groupe de champs Algolia Profile Details. Ensuite, accédez au champ Jeton utilisateur et utilisez le rail de droite pour sélectionner la zone Identité. En outre, utilisez la zone de saisie pour définir l’espace de noms d’identité Algolia User Token. Lorsque vous avez terminé, sélectionnez Enregistrer.
Une fois que l’espace de noms d’identité Algolia User Token est attribué au champ Jeton utilisateur, l’identité apparaît dans le profil utilisateur pour n’importe quel profil.
Mappage des champs de données à un schéma XDM
Utilisez l’interface de mappage pour mapper vos données source aux champs de schéma. Pour plus d’informations, consultez le guide de mappage.
Planifier des exécutions d’ingestion
Ensuite, utilisez l’interface de planification pour définir le planning de l’ingestion de votre flux de données.
Configurez la fréquence pour indiquer la fréquence d’exécution du flux de données. Vous pouvez définir la fréquence sur :
- Une fois : définissez votre fréquence sur
oncepour créer une ingestion unique. Les configurations d’intervalle et de renvoi ne sont pas disponibles lors de la création d’un flux de données d’ingestion unique. Par défaut, la fréquence de planification est définie sur une seule fois. - Minute : définissez la fréquence sur
minutepour planifier le flux de données afin d’ingérer les données par minute. - Heure : définissez la fréquence sur
hourpour planifier l’ingestion des données par flux et par heure. - Jour : définissez la fréquence sur
daypour planifier l’ingestion de données par jour dans le flux de données. - Semaine : définissez la fréquence sur
weekpour planifier l’ingestion de données par semaine dans le flux de données.
Une fois que vous avez sélectionné une fréquence, vous pouvez configurer le paramètre d’intervalle afin d’établir la période entre chaque ingestion. Par exemple, si vous définissez la fréquence sur jour et configurez l’intervalle sur 15, votre flux de données s’exécutera tous les 15 jours. Vous ne pouvez pas définir l’intervalle sur zéro. La valeur d’intervalle minimale acceptée pour chaque fréquence est la suivante :
- Une fois : s.o.
- Minute : 15
- Heure : 1
- Jour : 1
- Semaine : 1
Vérifier le flux de données
Utilisez la page de révision pour obtenir un résumé de votre flux de données avant l’ingestion. Les détails sont regroupés dans les catégories suivantes :
- Connexion - Affiche le type de source, le chemin d’accès correspondant au fichier source choisi et le nombre de colonnes au sein de ce fichier source.
- Attribuer des champs de jeu de données et de mappage - Affiche le jeu de données dans lequel les données sources sont ingérées, y compris le schéma auquel le jeu de données se conforme.
- Planification - Affiche la période active, la fréquence et l’intervalle du planning d’ingestion.
Une fois que vous avez vérifié votre flux de données, sélectionnez Terminer et patientez quelques instants le temps que le flux de données soit créé.
Étapes suivantes
Ce tutoriel vous a permis de créer un flux de données pour importer les données d’intention de votre source de Algolia vers Experience Platform. Pour obtenir des ressources supplémentaires, consultez la documentation décrite ci-dessous.
Surveiller votre flux de données
Une fois votre flux de données créé, vous pouvez surveiller les données ingérées et afficher les informations relatives au taux d’ingestion, aux succès et aux erreurs. Pour plus d’informations sur la surveillance des flux de données, consultez le tutoriel sur la surveillance des comptes et des flux de données dans l’interface utilisateur.
Mettre à jour votre flux de données
Pour mettre à jour les configurations pour la planification, le mappage et les informations générales de vos flux de données, consultez le tutoriel sur la mise à jour des flux de données sources dans l’interface utilisateur.
Supprimer le flux de données
Vous pouvez supprimer les flux de données qui ne sont plus nécessaires ou qui ont été créés de manière incorrecte à l’aide de la fonction Supprimer, disponible dans l’espace de travail Flux de données. Pour plus d’informations sur la suppression des flux de données, consultez le tutoriel sur la suppression de flux de données dans l’interface utilisateur.