Passer au contenu principal
Une fois que vous avez activé Databricks pour un projet spécifique, vous pouvez l’utiliser pour créer des objectifs dans Kameleoon. Ces objectifs sont conçus pour exploiter les données de conversion directement depuis votre base de données Databricks. Pour créer un objectif à l’aide de Databricks :
  1. Cliquez sur Settings > Goals > New goal.
  2. Saisissez les informations suivantes :
    • Name : Donnez à votre objectif un nom descriptif.
    • Type : Sélectionnez Data Warehouse Tracking.
    • Data warehouse : Choisissez Databricks.
    • Project : Sélectionnez le projet souhaité. Seuls les projets pour lesquels Databricks est activé sont listés.
  3. Cliquez sur Next.
  4. Dans la fenêtre suivante, fournissez des informations complémentaires :
    • Frequency : Sélectionnez la fréquence d’exécution de la tâche.
    • Databricks catalog : Saisissez le nom du catalogue Databricks contenant les schémas que vous souhaitez que Kameleoon lise.
    • Query : Saisissez une requête SQL comportant deux colonnes — la première colonne doit contenir l’identifiant utilisateur (ou kameleoonVisitorCode), et la seconde doit contenir la valeur correspondante que vous souhaitez ajouter comme information complémentaire (enrichissement) pour cet utilisateur.
  5. Cliquez sur Validate pour enregistrer la configuration de votre objectif.
Durée de rétention de l’entrepôt de données : Pour qu’un événement soit récupéré, Kameleoon exige qu’il reste accessible via votre requête d’entrée pendant au moins 72 heures après sa survenue.

Format de la requête

La requête doit respecter un format spécifique :
SELECT visitor_id, conversion_timestamp FROM your_events_table
visitor_id est la colonne représentant l’identifiant unique de vos visiteurs, et conversion_timestamp est une colonne représentant l’heure exacte à laquelle la conversion a eu lieu. Dans Databricks, la colonne conversion_timestamp doit être de type Timestamp. Si vous souhaitez associer un revenu à chaque conversion, la requête doit respecter un format alternatif :
SELECT visitor_id, conversion_timestamp, revenue FROM your_events_table
revenue est une colonne contenant le revenu pour chaque conversion. Pour des requêtes plus complexes, vous pouvez respecter ce format en formulant une sous-requête comme suit :
SELECT visitor_id, conversion_timestamp, revenue FROM ( {your_original_query} ) AS subquery
Votre requête sera exécutée toutes les heures dans votre entrepôt Databricks, avec l’ajout d’une clause WITH qui filtre par horodatage. Notez que, bien que les conversions soient collectées toutes les heures, elles ne sont fusionnées avec les résultats de votre expérience qu’une fois par jour.

Exécutez votre requête avant l’ingestion

Avant d’enregistrer votre tâche d’ingestion, vous pouvez tester votre requête directement dans Kameleoon. Les tests vous permettent 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 immédiatement les problèmes, sans avoir à attendre le premier import de données.
  • Valider la structure et l’accessibilité de vos données.
Vous pouvez exécuter une requête simple pour vous assurer que Kameleoon peut accéder aux bonnes bases de données et tables. Vous pouvez également télécharger un petit échantillon du jeu de données pour confirmer que le schéma, les autorisations et le contenu correspondent à vos attentes.

Utiliser votre objectif Databricks

Maintenant que vous avez créé un objectif, vous pouvez l’intégrer à vos campagnes Kameleoon. Lors de la configuration d’une expérience ou d’une personnalisation, vous pouvez sélectionner l’objectif, ce qui vous permet de suivre et d’analyser des conversions spécifiques dans votre base de données Databricks. Ces conversions sont fusionnées avec les résultats de votre expérience une fois par jour, de sorte que toutes les conversions récupérées un jour donné seront disponibles le lendemain matin. Pour savoir comment configurer un objectif dans une expérience, veuillez consulter cet article.