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

# Tools für Ziele

> MCP-Tools zum Erstellen von Zielen und zum Auswerten ihrer Performance.

Die Tools für Ziele verwalten die Conversion-Ziele, die Experimente und Feature Flags messen. Ihr KI-Assistent kann Ziele erstellen und bearbeiten, prüfen, wie ein Ziel über einen Zeitraum abschneidet, und die Experimente finden, die es beeinflusst haben.

## Zielperformance prüfen

Zwei reine Lese-Tools beantworten diese Fragen zu einem Ziel:

* **Wie entwickelt sich ein Ziel?** `goal_performance_get` liefert die KPIs des Ziels für einen Zeitraum, die Veränderung gegenüber dem vorherigen Zeitraum und die täglichen Events, wobei ungewöhnliche Tage markiert sind.
* **Welche Tests haben ein Ziel bewegt?** `goal_experiment_impacts_list` listet die Variationen auf, deren Effekt die Zuverlässigkeitsschwelle der Site erreicht hat, beginnend mit dem stärksten Effekt.

## Tools

| Tool | Beschreibung | Beispielprompt |
| - | - | - |
| `goal_list` | Ziele einer Site durchsuchen, mit Nutzungszahlen für Experimente, Feature Flags und Personalisierungen. | "List goals for site `d1alzzxd7k`." |
| `goal_get` | Die Typkonfiguration, Tags und Nutzungszahlen eines Ziels prüfen. | "Show goal `271552`." |
| `goal_search` | Ein Ziel anhand eines Teils seines Namens finden. | "Search goals for `checkout`." |
| `goal_create` | Ein Ziel eines beliebigen Typs erstellen (URL, CLICK, SCROLL, PAGE\_VIEWS, TIME\_SPENT, CUSTOM und weitere). | "Create a URL goal that matches `/thank-you`." |
| `goal_update` | Name, Beschreibung, Tags, Tracking-Tools oder die Einstellung für mehrfache Conversions eines Ziels bearbeiten. | "Rename goal `271552` to `Signup complete`." |
| `goal_update_type` | Den Typ eines Ziels wechseln und seine typspezifische Konfiguration ersetzen. Bestehende Tags bleiben erhalten. | "Change goal `271552` to a CLICK goal." |
| `goal_delete` | Ein Ziel dauerhaft löschen. | "Delete goal `271552`." |
| `goal_performance_get` | Events, Conversion-Rate und Umsatz eines Ziels für einen Zeitraum abrufen, dazu die Veränderung gegenüber dem vorherigen Zeitraum sowie die täglichen Events mit erwartetem Bereich und markierten Auffälligkeiten. | "Did the Purchase goal drop last week? Which days were unusual?" |
| `goal_experiment_impacts_list` | Die Experimentvariationen auflisten, deren Effekt auf ein Ziel die Zuverlässigkeitsschwelle der Site erreicht hat, positiv wie negativ, beginnend mit dem stärksten Effekt. | "Which experiments moved the Purchase goal the most, good and bad?" |

Der MCP-Server kann den JavaScript-Code eines benutzerdefinierten Ziels weder setzen noch lesen, weil die Automation API ihn nicht bereitstellt. Wenn Sie mit `goal_create` ein benutzerdefiniertes Ziel mit Code erstellen, fügt der Assistent den Code stattdessen dem globalen Skript des Experiments hinzu.

## Parameter

Verwenden Sie die exakten Parameternamen, die `tools/list` zurückgibt.

| Tool | Pflichtparameter | Optionale Parameter |
| - | - | - |
| `goal_list` | Keine | `siteCode`, `page`, `perPage` |
| `goal_get` | `goalId` | Keine |
| `goal_search` | `query` | `siteCode`, `page`, `perPage` |
| `goal_create` | `payload` (`name`, `siteCode`, `type`, `hasMultipleConversions`) | `payload`: typspezifische Parameter (`matchString`, `matchType`, `scrollType`, `scrollValue`, `timeSeconds`, `pageViews`, `url`), `tags`, `description`, `status`, `trackingTools` |
| `goal_update` | `goalId` | `name`, `description`, `tags`, `trackingTools`, `hasMultipleConversions` |
| `goal_update_type` | `goalId`, `type` | typspezifische Parameter |
| `goal_delete` | `goalId` | Keine |
| `goal_performance_get` | `siteCode`, `goalId` | `period` (`7D`, `14D`, `30D`, `3M` oder `6M`; standardmäßig `30D`), `dateFrom` und `dateTo` (`YYYY-MM-DD`, höchstens 366 Tage) |
| `goal_experiment_impacts_list` | `siteCode`, `goalId` | `impact` (`POSITIVE`, `NEGATIVE` oder `BOTH`), `limit` (1 bis 50, standardmäßig 10), `cursor` |

**Zulässige Enum-Werte:** Der `type` eines Ziels ist `CLICK`, `CUSTOM`, `SCROLL`, `PAGE_VIEWS`, `URL`, `TIME_SPENT`, `RETENTION_RATE`, `WAREHOUSE` oder `RATIO_METRICS`.
