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

# Vérifier l'exposition aux expériences, les custom data et les événements de conversion

> Interrogez la Data API pour vérifier que l'exposition à une expérience, les custom data et les événements de conversion ont bien été ingérés pour un visiteur donné.

La Data API de Kameleoon est une API REST qui offre plusieurs fonctionnalités, notamment le [stockage et la récupération de données spécifiques aux utilisateurs externes](./storing-and-retrieving-external-data-to-target-users) et la [gestion des conversions d'objectifs hors ligne](./processing-offline-goal-conversions-in-experiments). Utilisez la Data API pour déterminer si Kameleoon a reçu les événements de visite envoyés automatiquement par Kameleoon ou via les méthodes de l'Activation API ou du SDK. Cet article explique comment utiliser l'[endpoint GET visit/visitor de la Data API](/api-reference/visit/get-visitor-data) pour vérifier si des types d'événements spécifiques ont été ingérés par Kameleoon. Cette vérification est particulièrement utile lors du test du code de tracking. Les sections suivantes expliquent comment vérifier ces événements de manière programmatique :

* **[Événements d'exposition aux expériences](#exposition-à-une-expérience)**
* **[Événements de custom data](#custom-data)**
* **[Événements de conversion](#conversion)**

## Paramètres d'événement

Comme mentionné ci-dessus, toutes les requêtes doivent être adressées à l'[endpoint GET visit/visitor de la Data API](/api-reference/visit/get-visitor-data).

Les paramètres standards pour les requêtes d'**exposition à une expérience**, de **custom data** et d'événement de **conversion** incluent :

Soit :

* **visitorCode (string)** : ID unique de Kameleoon pour un visiteur. ***Requis si `mappingValue` n'est pas fourni.***

OU

* **mappingValue (string)** : valeur du custom data configuré comme identifiant de mapping (servant d'ID visiteur cross-device) le cas échéant. ***Requis si `visitorCode` n'est pas fourni.***

* **siteCode (string)** : chaîne unique de lettres et de chiffres qui identifie un projet Kameleoon. Récupérez ce code via [ce lien](/user-manual/faq#how-do-i-find-my-sitecode).

* **currentVisit (string | optionnel)** : définissez sur `true` pour recevoir des données relatives aux visites en cours. **Seuls les utilisateurs de Feature Experimentation peuvent demander des données pour les visites actives.**

* En fonction de l'événement spécifique demandé, chaque requête doit inclure un paramètre booléen supplémentaire défini sur `true` : `experiment`, `customdata` ou `conversion`, comme illustré dans les exemples ci-dessous.

## Requêtes d'événement

Voici des exemples du format utilisé pour les requêtes et les réponses, spécifiques à chaque événement :

<Important>
  Le domaine utilisé dans la requête dépend de la localisation géographique : utilisez `eu-data.kameleoon.(eu|io)` pour l'Europe et `na-data.kameleoon.(eu|io)` pour l'Amérique du Nord.
</Important>

<Note>
  Pour une sortie plus lisible, incluez le paramètre `prettyPrint=true` dans l'en-tête de la requête.
</Note>

### Exposition à une expérience

***Requête***

```shell theme={null}
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&experiment=true'
```

***Réponse***

```shell theme={null}
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"experimentEvents": [
                {
                    "itp": false,
                    "tabId": -218793282,
                    "time": 1748977476606,
                    "data": {
                       "id": 250830,
                       "variationId": 978588
                    }
                }
            ]
    	}
	]
}

```

<Note>
  Dans l'exemple de réponse, `id` représente l'ID de l'expérience, tandis que `variationId` est la variation spécifique de l'expérience à laquelle le visiteur est exposé.
</Note>

### Custom data

***Requête***

```shell theme={null}
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&customdata=true'
```

***Réponse***

```shell theme={null}
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"customDataEvents": [
                "itp": false,
                "tabId": 51426880,
                "time": 1748978024982,
                "data": {
                   "index": 1,
                   "valuesCountMap": {
                      "true":1
                      },
                    "overwrite": true,
                    "mappingIdentifier": false
                },
                "itp": false,
                "tabId": 51426880,
                "time": 1748978024982,
                "data": {
                   "index": 3,
                   "valuesCountMap": {
                      "1": 1},

                },
                "overwrite": false,
                "mappingIdentifier": false
            ]
    	}
	]
}

```

<Note>
  Dans l'exemple de réponse, `index` est l'ID unique du custom data.
</Note>

### Conversion

***Requête***

```shell theme={null}
curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&currentVisit=true&maxNumberPreviousVisits=20&conversion=true'
```

***Réponse***

```shell theme={null}
{
	"previousVisits": [
    	{
        	"siteCode": "f17c21u1ag",
        	"visitorCode": "245fc",
        	"timeStarted": 1748912914969,
        	"timeLastEvent": 1748912914969,
        	"conversionEvents": [
            	{
                	"itp": false,
                	"time": 1748912914969,
                	"data": {
                    	"goalId": 361517,
                    	"revenue": 23.5,
                    	"negative": false,
                    	"metadata": {}
                	}
            	}
        	]
    	}
	]
}

```
