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

# Outils pour les objectifs

> Outils MCP pour créer des objectifs et lire leurs performances.

Les outils d'objectif gèrent les objectifs de conversion que mesurent les expériences et les feature flags. Votre assistant peut créer et modifier des objectifs, vérifier leur performance sur une période, et trouver les expériences qui les ont fait évoluer.

## Vérifier la performance d'un objectif

Deux outils en lecture seule répondent à ces questions sur un objectif :

* **Comment se porte un objectif ?** `goal_performance_get` renvoie les KPI de l'objectif pour une période, l'évolution par rapport à la période précédente et les événements quotidiens, avec les jours inhabituels signalés.
* **Quels tests ont fait évoluer un objectif ?** `goal_experiment_impacts_list` liste les variations dont l'effet a atteint le seuil de fiabilité du site, les plus forts en premier.

## Outils

| Outil | Description | Exemple de prompt |
| - | - | - |
| `goal_list` | Parcourt les objectifs d'un site, avec le nombre d'utilisations dans les expériences, les feature flags et les personnalisations. | "List goals for site `d1alzzxd7k`." |
| `goal_get` | Inspecte la configuration de type d'un objectif, ses tags et ses compteurs d'utilisation. | "Show goal `271552`." |
| `goal_search` | Trouve un objectif par une partie de son nom. | "Search goals for `checkout`." |
| `goal_create` | Crée un objectif de n'importe quel type (URL, CLICK, SCROLL, PAGE\_VIEWS, TIME\_SPENT, CUSTOM, et d'autres). | "Create a URL goal that matches `/thank-you`." |
| `goal_update` | Modifie le nom, la description, les tags, les outils de suivi ou le paramètre de conversions multiples d'un objectif. | "Rename goal `271552` to `Signup complete`." |
| `goal_update_type` | Change le type d'un objectif et remplace sa configuration propre à ce type, en conservant les tags existants. | "Change goal `271552` to a CLICK goal." |
| `goal_delete` | Supprime définitivement un objectif. | "Delete goal `271552`." |
| `goal_performance_get` | Récupère les événements, le taux de conversion et le revenu d'un objectif sur une période, l'évolution par rapport à la période précédente, et les événements quotidiens avec la plage attendue et les anomalies signalées. | "Did the Purchase goal drop last week? Which days were unusual?" |
| `goal_experiment_impacts_list` | Liste les variations d'expériences dont l'effet sur un objectif a atteint le seuil de fiabilité du site, positif et négatif, les plus forts en premier. | "Which experiments moved the Purchase goal the most, good and bad?" |

Le serveur MCP ne peut ni définir ni lire le code JavaScript d'un objectif personnalisé, car l'Automation API ne l'expose pas. Lorsque vous créez un objectif personnalisé avec `goal_create` en y incluant du code, l'assistant ajoute ce code au script global de l'expérience à la place.

## Paramètres

Utilisez les noms exacts des paramètres renvoyés par `tools/list`.

| Outil | Paramètres obligatoires | Paramètres facultatifs |
| - | - | - |
| `goal_list` | Aucun | `siteCode`, `page`, `perPage` |
| `goal_get` | `goalId` | Aucun |
| `goal_search` | `query` | `siteCode`, `page`, `perPage` |
| `goal_create` | `payload` (`name`, `siteCode`, `type`, `hasMultipleConversions`) | `payload` : paramètres propres au type (`matchString`, `matchType`, `scrollType`, `scrollValue`, `timeSeconds`, `pageViews`, `url`), `tags`, `description`, `status`, `trackingTools` |
| `goal_update` | `goalId` | `name`, `description`, `tags`, `trackingTools`, `hasMultipleConversions` |
| `goal_update_type` | `goalId`, `type` | Paramètres propres au type |
| `goal_delete` | `goalId` | Aucun |
| `goal_performance_get` | `siteCode`, `goalId` | `period` (`7D`, `14D`, `30D`, `3M` ou `6M` ; `30D` par défaut), `dateFrom` et `dateTo` (`YYYY-MM-DD`, 366 jours au maximum) |
| `goal_experiment_impacts_list` | `siteCode`, `goalId` | `impact` (`POSITIVE`, `NEGATIVE` ou `BOTH`), `limit` (de 1 à 50, 10 par défaut), `cursor` |

**Valeurs acceptées :** Le `type` d'un objectif vaut `CLICK`, `CUSTOM`, `SCROLL`, `PAGE_VIEWS`, `URL`, `TIME_SPENT`, `RETENTION_RATE`, `WAREHOUSE` ou `RATIO_METRICS`.