Skip to main content
Les intégrations data warehouse sont disponibles en tant que module complémentaire premium pour les modules Web Experimentation et Feature Experimentation de Kameleoon. Pour plus d’informations, contactez votre Customer Success Manager.
Votre data warehouse sait déjà quels visiteurs appartiennent à un groupe, par exemple tous les visiteurs nés à Londres. Pour utiliser ce groupe dans une campagne, Kameleoon doit recevoir l’appartenance au groupe de chaque visiteur. Chaque Data Ingestion Task interroge une seule audience, et une custom data contient toutes les audiences auxquelles appartient un visiteur. Une campagne peut ainsi cibler les visiteurs selon leur audience d’entrepôt. Kameleoon prend en charge les intégrations data warehouse des fournisseurs suivants :
  • BigQuery
  • Snowflake
  • Redshift
  • Databricks

Choisir votre approche de ciblage

Choisissez l’approche qui correspond à ce que vous souhaitez cibler :
  • Cibler une audience prédéfinie d’une Ingestion Task (par exemple, tous les visiteurs de « The Londoners ») : suivez Cibler vos audiences importées dans une expérience Kameleoon. Vous créez une seule custom data qui liste toutes les audiences issues des Ingestion Tasks, puis vous créez des segments à partir de celle-ci.
  • Cibler un attribut spécifique du visiteur (par exemple, place_of_birth avec de nombreuses villes différentes) : suivez Cibler les audiences importées par attributs. Vous ajoutez l’attribut à la requête SQL et créez une custom data qui contient sa valeur.
Choisissez la méthode d’acquisition de la custom data selon votre configuration Kameleoon :
  • Kameleoon SDK method : pour Feature Experimentation uniquement.
  • Custom JavaScript code : pour Web Experimentation, ou pour Web Experimentation et Feature Experimentation ensemble.
Acquisition des données personnalisées décrit les deux méthodes.

Cibler vos audiences importées dans une expérience Kameleoon

Cet exemple standard illustre la méthode de base pour cibler vos audiences importées dans une expérience Kameleoon. Supposons que votre entrepôt contienne une table user avec les colonnes id, place_of_birth et subscription_plan.
Sample user table in a data warehouse with id, place_of_birth and subscription_plan columns. Several rows have LONDON as place_of_birth.
Dans cet exemple, vous souhaitez cibler tous les utilisateurs nés à Londres. Cette audience nécessite une Data Ingestion Task, que vous créez dans la section Data Ingestion Tasks de l’article sur le ciblage des audiences source de votre entrepôt. Nommez cette tâche « The Londoners ». La requête SQL de cette tâche est : SELECT id FROM user WHERE place_of_birth="LONDON" Pour cibler les audiences que vos Ingestion Tasks interrogent, effectuez la configuration suivante.

Configurer une entrée Créer des données personnalisées

Créez une custom data qui contient les audiences d’entrepôt auxquelles appartient chaque visiteur.
  1. Dans le menu de gauche, cliquez sur Settings > Custom data.
    Kameleoon navigation menu with the Settings section expanded and the Custom data item active.
  2. Cliquez sur New custom data.
    Custom data page with the New custom data button.
  3. Saisissez un nom pour votre custom data.
  4. Sélectionnez le projet sur lequel vous avez configuré la Data Ingestion Task.
  5. Choisissez la méthode d’acquisition Kameleoon SDK method ou Custom JavaScript code.
  6. Choisissez List pour le type et String pour le format.
  7. Pour le Scope, sélectionnez Visit.
  8. Cliquez sur Next.
Options step of the custom data form, with the option to save values for the targeting condition turned on and an empty JavaScript table editor.
  1. Vous pouvez définir les différentes valeurs qui apparaîtront dans la condition de ciblage du segment que vous créez. Cochez la case Save the values for the targeting condition associated with the custom data point.
  1. Cliquez sur Create.
La custom data apparaît dans la liste Custom data, avec son index dans la colonne Index.

Acquisition des données personnalisées

La méthode d’acquisition des données personnalisées définit le code qui remplit la valeur de la custom data, ainsi que l’endroit où ce code s’exécute. Plusieurs possibilités existent selon votre configuration Kameleoon. Si vous utilisez uniquement Feature Experimentation, vous pouvez sélectionner Kameleoon SDK method. Avec cette méthode, le code d’acquisition s’exécute aux endroits où vous appelez les méthodes du SDK Kameleoon. Ces méthodes récupèrent les audiences d’entrepôt auxquelles appartient votre visiteur, puis stockent ces informations dans la custom data. L’extrait de code exact dépend du SDK que vous utilisez. Voici un exemple écrit avec le SDK JavaScript de Kameleoon :
Remplacez YOUR_WAREHOUSE_VISITOR_ID afin que la variable warehouseVisitorId contienne l’identifiant que votre organisation utilise pour ce visiteur dans son entrepôt. Cet identifiant dépend du système d’identification des visiteurs de votre organisation (voir Identification des visiteurs). Si votre organisation n’en a pas, vous pouvez utiliser le Kameleoon Visitor Code, mais vous devez alors aussi l’utiliser dans votre entrepôt. Remplacez la valeur de customDataIndex par l’index de votre custom data. Vous trouverez cet index dans la colonne Index de la liste des custom data :
Custom data list with the Index column highlighted. The Frequent buyer custom data has index 125.
Si vous utilisez Web Experimentation (ou Web Experimentation and Feature Experimentation ensemble), vous pouvez sélectionner Custom JavaScript code. Dans ce cas, le fichier de l’application Kameleoon exécute l’extrait de code. Vous pouvez ajouter l’extrait suivant au Global custom script de votre projet (cliquez sur Admin > Projects, cliquez sur Edit sur la ligne du projet, puis cliquez sur l’onglet Scripts) :
Avec cette méthode, l’extrait identifie la custom data par son nom, et non par son index. Vous pouvez aussi saisir l’extrait ci-dessous dans le champ de code qui apparaît lorsque vous choisissez Custom JavaScript code comme méthode d’acquisition :
Cette configuration ne se fait qu’une seule fois et fonctionne pour toutes vos Ingestion Tasks.

Créer un segment pour les audiences d’entrepôt

Créez un segment qui cible les audiences d’entrepôt grâce à la custom data que vous avez configurée. Par exemple, si vous avez une deuxième Ingestion Task qui interroge les visiteurs nés en mars, que vous nommez « Born in March », la valeur de la custom data d’un visiteur né en mars et à Londres contient les deux audiences (« The Londoners », « Born in March »). Vous pouvez donc utiliser cette seule custom data pour tous vos segments Kameleoon qui ciblent des audiences d’entrepôt. Vous pouvez ensuite utiliser cette custom data dans vos campagnes Kameleoon (expériences, expériences de fonctionnalité ou personnalisations) pour cibler les utilisateurs selon leur appartenance à une audience spécifique de votre entrepôt. Pour créer un tel segment, suivez ces étapes :
  1. Créer un segment.
  2. Dans votre segment, utilisez une condition sur custom data.
  3. Lorsque vous choisissez l’opérateur is among the values, la liste affiche les audiences des Data Ingestion Tasks que vous avez créées, par exemple « The Londoners » et « Born in March ».

Cibler les audiences importées par attributs

Cette section présente une méthode alternative pour cibler les audiences que vous avez importées depuis votre entrepôt. Elle est particulièrement utile si vous souhaitez lancer des expériences distinctes qui ciblent différentes valeurs d’un même attribut de visiteur, comme de nombreuses villes d’origine. Il est possible de créer une Ingestion Task pour chaque lieu de naissance, mais cela devient fastidieux si vous souhaitez cibler 50 villes différentes. Kameleoon vous permet d’importer les attributs des visiteurs de vos audiences d’entrepôt. Pour les importer, ajoutez des champs supplémentaires à la requête SQL après le champ de l’identifiant visiteur, comme ceci : SELECT id, place_of_birth FROM user Vous pouvez ensuite créer une custom data qui contient la valeur de l’attribut place_of_birth. Pour le SDK JavaScript, le code se présente ainsi :
Vous pouvez aussi utiliser l’extrait suivant lorsque vous configurez la custom data avec la méthode d’acquisition Custom JavaScript code :
Vous pouvez ensuite créer un segment Kameleoon qui cible le nom de la ville dans la valeur de la custom data. Si vous souhaitez cibler plusieurs villes dans un même segment, vous pouvez ajouter plusieurs conditions Or à la même custom data. L’extrait stocke son résultat dans une propriété window dont le nom est construit à partir de attributeName et de taskId. Gardez ce nom unique pour chaque custom data que vous créez, car deux scripts de custom data qui partagent une propriété window s’écrasent mutuellement leur valeur. taskId est l’ID de l’Ingestion Task : le numéro unique que Kameleoon attribue à la tâche. La liste des Data Ingestion Tasks affiche chaque tâche sous la forme de son ID suivi de son nom, par exemple 543 Attributes. L’ID correspond uniquement au numéro (543), pas au nom. Définissez taskId avec ce numéro. Vous pouvez ajouter autant d’attributs de visiteur que vous le souhaitez dans la requête SQL, et les utiliser de nombreuses manières avec les SDK de Kameleoon.

Types de données des valeurs importées

Kameleoon convertit chaque valeur importée en texte (chaîne de caractères) de son côté, quels que soient le Type ou le Format choisis dans le formulaire de custom data. La liste déroulante Type propose Single, List et Count List. La liste déroulante Format propose Boolean, Number et String. Kameleoon recommande String.

Utiliser des valeurs booléennes depuis Databricks

Pour cibler une colonne booléenne de Databricks, convertissez sa valeur en 1 ou 0 dans votre code personnalisé. La colonne arrive dans Kameleoon sous forme de texte, par exemple {"is_premium": "true"}. Analysez ce texte et stockez 1 ou 0 comme valeur de la custom data. Les segments testent ensuite cette valeur par rapport à 1 ou 0, et non par rapport à TRUE ou FALSE.

Identification des visiteurs

Les applications et sites web modernes utilisent de nombreux outils externes et souvent plusieurs identifiants de visiteur. Pour que cette fonctionnalité fonctionne, l’identifiant de visiteur que vous utilisez dans votre code pour récupérer l’objet JSON doit être le même que l’identifiant extrait de votre entrepôt. La manière dont vous générez cet identifiant vous appartient, et les possibilités sont nombreuses. Vous pouvez utiliser des identifiants obtenus seulement après la connexion de l’utilisateur à votre solution, comme une adresse e-mail. Vous pouvez utiliser des identifiants anonymes si votre activité ne nécessite pas de connexion ou ne la prend pas en charge. Vous pouvez même combiner les deux si vous souhaitez cibler des utilisateurs, connectés ou non. Vous êtes responsable de votre entrepôt de données et de la table que Kameleoon interroge. Il n’existe donc aucune limitation, sauf que l’identifiant doit être disponible pour le suivi à un moment donné. L’équipe Customer Success de Kameleoon peut vous conseiller dans le choix d’un identifiant, en fonction de votre configuration, de vos outils externes et de vos besoins métier.