> ## 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.

# Amplitude Event Streaming comme source

> Envoyez des événements depuis Amplitude vers Kameleoon pour que Kameleoon crée des objectifs et enregistre les conversions des visiteurs de vos expériences.

Votre équipe suit peut-être déjà les actions des utilisateurs dans Amplitude, et recréer ce plan de suivi dans Kameleoon demande du temps de développement. Cette intégration envoie vos événements Amplitude à Kameleoon, qui crée un objectif personnalisé nommé d'après chaque événement et enregistre une conversion pour le visiteur correspondant. Vous n'avez pas besoin d'écrire de code pour déclencher ces objectifs, mais vous devez transmettre le code visiteur Kameleoon à Amplitude pour que chaque événement corresponde à un visiteur.

## Place de l'intégration dans votre flux de travail

* **Relier Amplitude à Kameleoon :** Générez une clé API REST, trouvez votre sitecode et [créez une synchronisation dans Amplitude](https://amplitude.com/docs/data/destination-catalog/kameleoon) qui envoie vos événements à Kameleoon.
* **Faire correspondre les utilisateurs Amplitude aux visiteurs Kameleoon :** Transmettez le code visiteur Kameleoon à Amplitude avec chaque événement.
* **Gérer les objectifs créés à partir des événements Amplitude :** Recherchez et renommez les objectifs que Kameleoon crée à partir des événements Amplitude.

## Avant de commencer

* **Forfait payant :** un forfait Kameleoon payant, requis pour l'intégration.
* **Clé API REST :** la clé qui permet à Amplitude d'envoyer des événements à votre projet. Vous la générez à partir de votre client ID et de votre client secret.
* **Sitecode :** l'identifiant du projet Kameleoon qui reçoit les événements. Vous pouvez le [trouver sur le tableau de bord de votre projet](https://docs.kameleoon.com/fr/user-manual/project-management/manage-your-projects.md#how-do-i-find-my-sitecode).
* **Projets Amplitude :** chaque projet Amplitude qui envoie des événements a besoin de sa propre destination activée.

## Connecter Amplitude à Kameleoon

Amplitude envoie les événements à Kameleoon par l'intermédiaire d'une destination que vous créez dans Amplitude. La destination nécessite votre clé API REST et votre sitecode, qui identifient votre projet Kameleoon. Amplitude envoie toutes les propriétés utilisateur, d'événement et de groupe avec chaque événement. Kameleoon accepte des données d'événement allant jusqu'à 1 Mo par événement.

### Générer une clé API REST

Générez une clé API REST à partir de votre client ID et de votre client secret.

1. Copiez votre `client_id` et votre `client_secret` depuis la page [Identifiants API](https://docs.kameleoon.com/fr/user-manual/account-and-team-management/users-and-teams/api-credentials.md). Si vous n'avez pas de client secret, cliquez sur **Generate a new Client-Secret key** sur cette page.
2. Ouvrez l'URL suivante dans un navigateur, puis remplacez `CLIENT_ID` et `CLIENT_SECRET` par vos valeurs.

   ```
   https://customers.kameleoon.com/kameleoon/amplitude/getapikey?id=CLIENT_ID&secret=CLIENT_SECRET
   ```

Gardez la clé à portée de main pour la configuration de la destination Amplitude.

### Obtenir votre sitecode

Repérez le sitecode du projet Kameleoon qui reçoit les événements. Vous le trouverez sur le tableau de bord du projet. Consultez [Comment trouver mon sitecode](https://docs.kameleoon.com/fr/user-manual/project-management/manage-your-projects.md#how-do-i-find-my-sitecode) pour savoir où il se trouve.

### Configurer la destination Amplitude

Vous configurez la destination dans Amplitude, et non dans l'application Kameleoon. Suivez le [guide de destination Kameleoon d'Amplitude](https://amplitude.com/docs/data/destination-catalog/kameleoon) pour créer la synchronisation. Lorsqu'Amplitude vous demande la clé API REST et le sitecode Kameleoon, utilisez les valeurs obtenues dans les étapes précédentes.

La carte **Amplitude** sous **Admin** > **Integrations** est une intégration distincte, marquée Destination. Cette carte envoie les résultats de tests Kameleoon vers Amplitude, et vous n'y configurez pas l'envoi d'événements.

## Faire correspondre les utilisateurs Amplitude aux visiteurs Kameleoon

Kameleoon ne peut attribuer un événement Amplitude à un visiteur que si les deux outils identifient ce visiteur avec la même valeur. Si votre projet utilise des expériences ou des personnalisations Kameleoon, Kameleoon place pour chaque visiteur un cookie qui stocke un identifiant unique anonyme, le code visiteur Kameleoon. Choisissez l'une des options suivantes pour transmettre ce code à Amplitude :

* **Option 1 :** transmettez le code visiteur comme `userId` de l'événement Amplitude. Kameleoon attribue alors toutes les données d'événement d'Amplitude au bon visiteur.
* **Option 2 :** définissez la user property `kameleoon_visitorcode` sur les événements Amplitude. Sa valeur est le code visiteur.

Si votre projet utilise Feature Experimentation, définissez votre propre identifiant dans le SDK Kameleoon à la place du code visiteur généré. Consultez la [vue d'ensemble de Feature Experimentation](https://docs.kameleoon.com/fr/developer-docs/feature-experimentation/get-started/overview.md) pour savoir comment définir votre propre identifiant dans le SDK.

### Utiliser le code visiteur comme ID utilisateur Amplitude

Définissez l'ID utilisateur Amplitude sur le code visiteur Kameleoon avec le SDK Browser d'Amplitude.

```javascript theme={null}
amplitude.setUserId(Kameleoon.API.Visitor.code);
```

### Stocker le code visiteur dans une user property

Définissez la user property `kameleoon_visitorcode` sur le code visiteur dans chaque appel Amplitude suivant.

```javascript theme={null}
const visitorcode = Kameleoon.API.Visitor.code;

const identifyEvent = new amplitude.Identify();
identifyEvent.set('kameleoon_visitorcode', visitorcode);

amplitude.identify(identifyEvent);
```

## Gérer les objectifs créés à partir des événements Amplitude

Lorsque Kameleoon reçoit un événement Amplitude qui n'a pas d'objectif correspondant, il crée un [objectif personnalisé](https://docs.kameleoon.com/fr/user-manual/assets/goals/create-a-goal.md#objectif-personnalisé) nommé `Amplitude - <nom de l'événement>`. Kameleoon ajoute à chaque objectif créé le tag `amplitude`. Kameleoon crée au maximum 50 objectifs sur une période de 10 secondes, et au maximum 1 000 objectifs sur une période de 60 minutes.

### Trouver les objectifs créés à partir des événements Amplitude

Filtrez les objectifs par le tag `amplitude` pour afficher la liste des objectifs créés par les événements Amplitude.

1. Ouvrez le tableau de bord **Goals**.
2. Filtrez les objectifs par le tag `amplitude` dans le panneau latéral.

### Renommer les objectifs créés automatiquement

Kameleoon retrouve l'objectif d'un événement Amplitude grâce à son nom. Si vous renommez un objectif, Kameleoon ne peut plus le retrouver, et l'événement suivant crée alors un nouvel objectif nommé d'après l'événement Amplitude. Les conversions enregistrées avant le renommage restent sur l'objectif précédent.

Pour regrouper les conversions sur un seul objectif, renommez l'événement Amplitude afin qu'il corresponde au nouveau nom de l'objectif. Si vous renommez un événement Amplitude, renommez aussi son objectif pour qu'il corresponde au nouveau nom de l'événement.

### Convertir automatiquement les objectifs

Kameleoon convertit un objectif lorsque Amplitude envoie l'événement associé. Si le nom d'un événement Amplitude correspond exactement au nom d'un objectif existant dans votre compte Kameleoon, Kameleoon associe chaque conversion à cet objectif, que Kameleoon l'ait créé ou non. Vous n'avez pas besoin d'appeler l'API d'activation ou un SDK pour convertir ces objectifs, ni d'ajouter de code frontend ou backend pour les déclencher.
