- Activer la fonctionnalité : Dans la configuration du projet sélectionné, accédez à la section intitulée Use Databricks as a source pour activer la fonctionnalité.
- Créer des Data Ingestion Tasks : Avec la fonctionnalité activée, vous pouvez désormais initier la création de Data Ingestion Tasks. Ces tâches récupèrent régulièrement des données spécifiques de Databricks, en fonction de vos requêtes SQL et de fréquences définies. Pour créer une nouvelle Data Ingestion Task, cliquez sur Add new task.
- Valider : Après avoir fourni les informations requises pour la Data Ingestion Task, cliquez sur Confirm pour créer la tâche. Vous pouvez créer des tâches supplémentaires en répétant les étapes consistant à nommer la tâche, définir la requête SQL et définir la fréquence. Une fois vos tâches configurées, cliquez sur Validate pour enregistrer et appliquer vos paramètres de configuration.
- Créer une custom data : Maintenant que vous avez créé votre Data Ingestion Task, nos serveurs commenceront à collecter les données en fonction de la fréquence que vous avez configurée en exécutant la requête sur votre instance Databricks. Pour commencer à utiliser les données collectées, vous devrez créer une custom data.
- Créer un segment : La dernière étape pour cibler les utilisateurs en fonction des données collectées consiste à créer un segment basé sur la custom data que vous avez créée.
Data Ingestion Tasks
Les Data Ingestion Tasks sont des composants essentiels de l’intégration Databricks dans Kameleoon. Ces tâches vous permettent de récupérer régulièrement des données spécifiques de Databricks, en fonction de requêtes SQL et de fréquences prédéfinies. Les données collectées via les Data Ingestion Tasks peuvent ensuite être utilisées comme conditions de ciblage dans vos campagnes Kameleoon, permettant des expériences utilisateur hautement personnalisées et basées sur les données.Créer une Data Ingestion Task
Pour créer une Data Ingestion Task :
- Cliquez sur Add new task.
- Remplissez le formulaire :
- Name (Required) : Donnez à votre tâche un nom unique et descriptif pour identifier son objectif.
- Frequency (Required) : Indiquez à quelle fréquence vous souhaitez que la tâche s’exécute et récupère les données de Databricks (par exemple, par jour).
- Databricks Catalog (Required) : Fournissez le nom du « catalog » Databricks qui contient les schémas que vous souhaitez que Kameleoon lise (le dossier de niveau supérieur).
- Schema (Required) : Fournissez le schéma contenant les tables que cette tâche d’ingestion interrogera (par exemple,
user_data). - Query (Required) : Fournissez la requête SQL qui récupère l’audience depuis votre base de données Databricks. La requête doit suivre ce format spécifique :
SELECT visitor_id, attribute_1, .. attribute_N FROM your_events_table
- Champs
attribute_: Ils sont optionnels et peuvent être utilisés pour des scénarios de ciblage avancés. En savoir plus sur ces cas d’utilisation avancés ici. visitor_id: Cette colonne représente l’identifiant unique de vos visiteurs.
Directives
Nommage des colonnes
Les noms de colonnes ne peuvent contenir que des lettres (majuscules ou minuscules), des chiffres et des underscores (_). Ils ne peuvent pas commencer par un chiffre.
Ordre des colonnes
Les colonnes doivent apparaître dans l’ordre exact spécifié (visitor_id, suivi des attributs optionnels) pour que l’intégration fonctionne correctement.
Une fois que vous avez fourni toutes les informations requises, cliquez sur Confirm pour créer la Data Ingestion Task.
Exécuter votre requête avant l’ingestion
Avant d’enregistrer votre tâche d’ingestion, vous pouvez tester votre requête directement dans Kameleoon. Le test vous permet de :- Vérifier la connexion en temps réel.
- Confirmer que vos identifiants et droits d’accès sont corrects, ce qui aide à détecter les problèmes immédiatement, sans avoir à attendre le premier import de données.
- Valider la structure et l’accessibilité de vos données.
Mettre à jour une Data Ingestion Task
Pour mettre à jour une Data Ingestion Task :
- Sélectionnez la tâche : Commencez par sélectionner la Data Ingestion Task spécifique que vous souhaitez modifier dans la liste déroulante.
- Modifier les détails de la tâche : Modifiez les champs que vous souhaitez mettre à jour, tels que le nom de la tâche, la fréquence, le Databricks Catalog, le Schema ou la requête.
- Confirmer les modifications : Après avoir effectué les mises à jour nécessaires, cliquez sur Confirm pour enregistrer les modifications apportées à la Data Ingestion Task.
Supprimer une Data Ingestion Task
Pour supprimer une Data Ingestion Task :
- Sélectionnez la tâche : Choisissez la Data Ingestion Task que vous souhaitez supprimer dans la liste déroulante.
- Lancez la suppression : Cliquez sur l’icône de suppression située en haut à droite du formulaire d’édition.
- Confirmez la suppression : Une invite de confirmation apparaîtra. Cliquez sur Confirm pour supprimer la Data Ingestion Task sélectionnée.