Skip to main content
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, suivez le flux Data warehouse tracking décrit dans Create a goal, et choisissez Databricks dans le menu déroulant Datawarehouse integration. L’étape 1 vous demande alors de fournir ces champs spécifiques à Databricks :
  • Frequency : Sélectionnez la fréquence d’exécution de la tâche.
  • Catalog : Saisissez le nom du catalogue Databricks contenant les schémas que vous souhaitez que Kameleoon lise.
  • Schema : Saisissez le schéma qui contient vos données de conversion.
  • 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.
Une fois l’étape 1 complétée, configurez l’étape 2, Advanced settings, si nécessaire, puis enregistrez 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 :
Où 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 :
Où 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 :

​
Comment Kameleoon interroge les données de conversion

Kameleoon interroge les données de conversion Databricks de votre objectif toutes les heures, en ajoutant à votre requête une clause WITH qui filtre par horodatage. Plutôt que de recharger tout l’historique des événements à chaque exécution, Kameleoon interroge les données de manière incrémentale : chaque tâche d’interrogation conserve le dernier point d’interrogation réussi et, lors de l’exécution suivante, ne requête que la fenêtre temporelle des nouveaux enregistrements depuis ce point. Ne requêter que cette fenêtre garde chaque interrogation rapide, puisque Kameleoon ne réanalyse jamais les données qu’il a déjà importées. 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. Comme l’interrogation avance toujours vers l’avant, Kameleoon peut manquer un enregistrement qui arrive dans Databricks avec un horodatage antérieur à la dernière fenêtre d’interrogation réussie. Les enregistrements tardifs arrivent généralement parce que votre pipeline de données met du temps à écrire l’événement de conversion, si bien que l’enregistrement n’atteint Databricks qu’après que Kameleoon a déjà dépassé la fenêtre temporelle à laquelle il appartient. Pour éviter les enregistrements manqués, définissez le délai d’ingestion ci-dessous pour qu’il corresponde au délai d’arrivée habituel de votre pipeline.

​
Délai d’ingestion

Par défaut, Kameleoon autorise jusqu’à 1 heure entre le moment où un événement de conversion de votre objectif se produit et le moment où il devient disponible dans votre entrepôt Databricks, et sa fenêtre d’interrogation tient compte automatiquement de ce délai. Si votre pipeline met plus d’1 heure à écrire les événements dans Databricks, par exemple en raison de traitements ETL par lots ou nocturnes, ces enregistrements tardifs tombent en dehors de la fenêtre d’interrogation et sont manqués. Contactez votre Customer Success Manager pour prolonger le délai afin qu’il corresponde au délai d’arrivée réel de votre pipeline.

​
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, consultez Set up a goal in a campaign.