> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Heap Cohorts
> Importez les segments Heap dans Kameleoon pour cibler les visiteurs en fonction de cohortes comportementales et realiser des A/B tests personnalises.
Cette fonctionnalite est en beta ouverte et en developpement actif. Contactez l'[equipe d'assistance Kameleoon](https://www.kameleoon.com/support) pour obtenir de l'aide concernant cette integration.
[Heap](https://www.heap.io/) est un outil d'analyse produit qui aide les entreprises a suivre le comportement des utilisateurs, analyser les donnees et ameliorer leurs produits numeriques pour stimuler l'engagement et la croissance.
Vous pouvez utiliser l'integration Kameleoon Heap Cohorts pour synchroniser les segments de Heap avec Kameleoon.
## Principaux avantages
* **Synchronisation transparente des cohortes :** Importez sans effort les segments d'utilisateurs de Heap dans Kameleoon.
* **Ciblage personnalise :** Offrez des experiences sur mesure basees sur le comportement des utilisateurs.
* **Experimentation amelioree :** Realisez des A/B tests precis sur des groupes d'audience specifiques.
* **Mises a jour en temps reel :** Maintenez les segments d'utilisateurs a jour automatiquement.
## Cas d'usage
### Optimiser les experiences avec le ciblage comportemental
Vous pouvez synchroniser les segments Heap avec Kameleoon pour tester des variations sur les utilisateurs en fonction de leur comportement en temps reel.
Par exemple, vous pourriez executer un A/B test sur les utilisateurs qui ont consulte une page produit plusieurs fois mais n'ont rien ajoute a leur panier. Vous pourriez alors tester differentes incitations (telles qu'une offre a duree limitee versus un message de social proof) pour determiner quelle strategie genere le plus de conversions.
### Analyser les resultats avec une segmentation comportementale
Vous pouvez decomposer les campagnes Kameleoon a l'aide des cohortes Heap pour obtenir des informations plus approfondies.
Par exemple, si une campagne de test ou de personnalisation montre une baisse des conversions, vous pouvez analyser les principaux segments Heap (tels que les clients a forte valeur ou les utilisateurs sujets au churn) pour identifier des tendances. Les segments Heap vous aident a comprendre quelles experiences resonnent le mieux avec differents groupes d'utilisateurs, afin que vous puissiez affiner votre strategie.
### Personnaliser les experiences en utilisant les riches insights utilisateurs de Heap
Vous pouvez tirer parti des donnees utilisateur approfondies de Heap, telles que le comportement, l'etape du cycle de vie ou l'historique d'achat, pour creer des experiences hautement pertinentes dans Kameleoon.
Par exemple, vous pourriez identifier les acheteurs frequents, les utilisateurs ayant recemment retrograde leur abonnement, ou ceux qui interagissent avec un contenu specifique. Vous pouvez ensuite adapter les messages, les promotions ou les recommandations de fonctionnalites dans Kameleoon pour maximiser l'engagement et les conversions.
## Demarrage
### Stocker le Kameleoon Visitor Code comme un Heap Identifier
Ajoutez ce code a votre SDK Heap immediatement apres la fonction `heap.load()` :
```js theme={null}
// Ensure Heap and Kameleoon are loaded before identifying the user
const visitorCode = Kameleoon.API.Visitor.code;
heap.identify(visitorCode);
```
### Prerequis
Pour configurer cette integration, vous avez besoin des informations suivantes :
* **Compte Heap :** Un compte actif auquel vous etes connecte.
### Activer l'integration dans Kameleoon
Activez l'integration Heap Cohorts pour autoriser le partage de donnees.
1. Dans Kameleoon, accedez a **Admin** > **Integrations**.
2. Cliquez sur **Heap Cohorts** et selectionnez **Install**.
3. Selectionnez votre/vos projet(s) et cliquez sur **Validate**. Kameleoon vous redirige vers Heap.
4. Accordez a Heap l'autorisation de partager des donnees avec Kameleoon.
### Synchroniser les segments Heap avec Kameleoon
1. Dans Heap, accedez a **Data** > **Segments**.
2. Selectionnez le segment que vous souhaitez synchroniser.
3. Au bas de la page, activez **Kameleoon Cohorts Sync** pour ce segment.
## Tirer parti des Heap Cohorts dans vos campagnes Kameleoon
Vous pouvez creer une custom data pour cibler les segments Heap dans vos experiences.
### Recuperer les segments Heap pour les experiences cote client
1. Dans Kameleoon, accedez a **Configure** > **Custom data**.
2. Cliquez sur **New custom data**.
3. Definissez le **Name** sur `Heap Cohorts`.
4. Selectionnez votre projet.
5. Definissez la **Retrieval method** sur **Custom JavaScript code**.
6. Inserez le snippet suivant dans le champ de code :
```javascript theme={null}
Kameleoon.API.Data.retrieveDataFromRemoteSource("HEAP_COHORTS_" + Kameleoon.API.Visitor.code, function(data) {
if (data?.cohorts) {
data.cohorts.map(function(segment) {
Kameleoon.API.Data.setCustomData("Heap Cohorts", segment);
});
}
});
return { "value": null };
```
7. Definissez **Type** sur **List**.
8. Definissez **Format** sur **String**.
9. Definissez **Scope** sur **Page**. Ce scope garantit que les donnees sont reevaluees a chaque chargement de page pour verifier si l'utilisateur appartient a une cohorte Heap specifique.
### Recuperer les segments Heap pour les experiences cote serveur
1. Cliquez sur **New custom data**.
2. Saisissez un **Name** pour la custom data (par exemple, `Heap cohorts`).
3. Selectionnez votre projet.
4. Definissez la **Retrieval method** sur **Kameleoon SDK**.
5. Definissez **Type** sur **List**.
6. Definissez **Format** sur **String**.
7. Definissez **Scope** sur **Page**.
Pour utiliser les segments Heap dans des experiences cote serveur ou des feature flags, referez-vous a la documentation specifique de votre SDK. Par exemple, la [documentation du Go SDK](../../../../developer-docs/sdks/web-sdks/go-sdk) detaille comment utiliser la methode `getRemoteData()` pour recuperer les donnees stockees par Heap sur les serveurs de Kameleoon.
### Recuperer les noms de segments Heap dans Kameleoon
Pour afficher des noms de segments lisibles plutot que des IDs :
1. Dans l'etape de creation de la custom data, selectionnez l'option **Save the values for the targeting condition associated with the custom data point**.
2. Inserez le snippet suivant dans le champ et remplacez `ADD_YOUR_SITECODE` par votre sitecode de projet actuel :
```javascript theme={null}
var xhr = new XMLHttpRequest();
var siteCode = 'ADD_YOUR_SITECODE';
xhr.open("GET", '[https://data.kameleoon.io/map/map?siteCode=](https://data.kameleoon.io/map/map?siteCode=)' + siteCode + '&key=HEAP_COMMON', false);
xhr.send(null);
if (xhr.status === 200) {
const data = JSON.parse(xhr.responseText);
var heapSegments = [];
if (
data &&
Object.prototype.hasOwnProperty.call(data, "cohorts") &&
data.cohorts &&
typeof data.cohorts === "object"
) {
Object.entries(data.cohorts).forEach(function ([id, name]) {
heapSegments.push({
value: id,
label: name
});
});
return heapSegments;
}
return [];
} else {
console.error("Error calling for existing custom data values");
return [];
}
```
### Utiliser les IDs de segments Heap dans un segment Kameleoon
Une fois la custom data pour les noms de segments Heap configuree :
1. Ouvrez le **Segment Builder** Kameleoon.
2. Selectionnez votre custom data.
3. Selectionnez la condition **is among the values**. Kameleoon affiche une liste de tous les IDs de cohortes de Heap.
4. Selectionnez un ou plusieurs segments Heap pour activer le ciblage pour vos personnalisations et experiences.
