> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

> Überwachen Sie die Agentenleistung mit Nutzungsmetriken, Konversationstrends und geografischen Einblicken

## Überblick

Das Analytics-Dashboard bietet Ihnen umfassende Einblicke in die Leistung Ihres Agenten. Verfolgen Sie Konversationsvolumen, messen Sie die Benutzerzufriedenheit durch Feedback-Metriken und verstehen Sie, woher Ihre Besucher geografisch kommen.

<Tip>
  Nutzen Sie Analytics-Daten, um fundierte Entscheidungen zur Verbesserung der Wissensbasis und des Systemprompts Ihres Agenten zu treffen.
</Tip>

***

## Zugriff auf Analytics

Navigieren Sie zu Analytics, indem Sie Ihren Agenten in der Seitenleiste auswählen und auf **Analytics** im Agentenmenü klicken. Sie sehen ein interaktives Dashboard mit verschiedenen Metriken und Visualisierungen.

***

## Wichtige Metriken

Das Dashboard zeigt vier primäre Metriken oben an:

| Metrik                     | Beschreibung                                                                               |
| -------------------------- | ------------------------------------------------------------------------------------------ |
| **Gesamte Konversationen** | Die Gesamtzahl der Chat-Sitzungen mit Ihrem Agenten im ausgewählten Zeitraum               |
| **Gesamte Nachrichten**    | Die kombinierte Anzahl aller ausgetauschten Nachrichten (Besucher- und Agentennachrichten) |
| **Daumen hoch**            | Anzahl positiver Feedback-Reaktionen von Besuchern                                         |
| **Daumen runter**          | Anzahl negativer Feedback-Reaktionen von Besuchern                                         |

<Note>
  Feedback-Metriken (Daumen hoch/runter) helfen Ihnen, die allgemeine Zufriedenheit einzuschätzen. Ein hohes Verhältnis von positivem zu negativem Feedback zeigt an, dass Ihr Agent hilfreiche Antworten liefert.
</Note>

### Die Metriken verstehen

<AccordionGroup>
  <Accordion icon="comments" title="Gesamte Konversationen">
    Jede Konversation repräsentiert eine einzigartige Chat-Sitzung. Ein Besucher, der das Widget öffnet und Nachrichten sendet, zählt als eine Konversation, unabhängig davon, wie oft er innerhalb der Sitzung zurückkehrt.
  </Accordion>

  <Accordion icon="message" title="Gesamte Nachrichten">
    Dies zählt jede Nachricht in beide Richtungen. Es umfasst Besucherfragen und Agentenantworten. Höhere Nachrichtenanzahlen pro Konversation können auf engagierte Benutzer oder komplexe Anfragen hinweisen, die mehrere Austausche erfordern.
  </Accordion>

  <Accordion icon="thumbs-up" title="Feedback-Metriken">
    Besucher können Agentenantworten mit Daumen hoch oder Daumen runter bewerten. Diese Bewertungen helfen Ihnen zu erkennen, welche Antworten hilfreich sind und welche verbessert werden müssen.
  </Accordion>
</AccordionGroup>

***

## Datumsbereichsauswahl

Verwenden Sie die Datumsbereichsauswahl in der oberen rechten Ecke, um bestimmte Zeiträume zu analysieren:

* **Letzte 7 Tage** - Standardansicht für aktuelle Trends
* **Letzte 30 Tage** - Monatliche Leistungsübersicht
* **Benutzerdefinierter Bereich** - Wählen Sie bestimmte Start- und Enddaten

<Tip>
  Vergleichen Sie verschiedene Zeiträume, um Trends zu erkennen. Vergleichen Sie zum Beispiel diese Woche mit der letzten Woche, um zu sehen, ob Ihre kürzlichen Aktualisierungen der Wissensbasis das Engagement verbessert haben.
</Tip>

***

## Chats im Zeitverlauf

Das interaktive Liniendiagramm zeigt die Konversationsvolumen-Trends über Ihren ausgewählten Datumsbereich:

### Worauf Sie achten sollten

| Muster                 | Bedeutung                                                                               |
| ---------------------- | --------------------------------------------------------------------------------------- |
| **Aufwärtstrend**      | Wachsendes Engagement mit Ihrem Agenten                                                 |
| **Spitzen**            | Erhöhter Datenverkehr, möglicherweise durch Marketingkampagnen oder Produkteinführungen |
| **Einbrüche**          | Perioden mit geringerem Engagement (Wochenenden, Feiertage)                             |
| **Konstantes Volumen** | Stabile, vorhersehbare Nutzung                                                          |

### Das Diagramm verwenden

* **Fahren Sie mit der Maus** über Datenpunkte, um die genaue Konversationsanzahl für jeden Tag zu sehen
* **Erkennen Sie Muster** wie wöchentliche Zyklen oder saisonale Trends
* **Verfolgen Sie das Wachstum** im Zeitverlauf, um die Auswirkungen von Verbesserungen zu messen

***

## Geografische Verteilung

Der Abschnitt Chats nach Land zeigt, woher Ihre Besucher kommen:

### Weltkarten-Ansicht

Eine interaktive Karte zeigt die Chat-Verteilung weltweit:

* **Fahren Sie mit der Maus** über Länder, um Chat-Zahlen zu sehen
* **Identifizieren** Sie Ihre primären Märkte
* **Entdecken** Sie unerwartetes geografisches Interesse

### Länderdaten-Tabelle

Unter der Karte zeigt eine detaillierte Tabelle:

| Spalte     | Beschreibung                              |
| ---------- | ----------------------------------------- |
| **Land**   | Geografischer Standort des Besuchers      |
| **Chats**  | Anzahl der Konversationen aus diesem Land |
| **Flagge** | Visuelles Ländererkennungszeichen         |

<Note>
  Geografische Daten helfen Ihnen, Ihr Publikum zu verstehen. Wenn Sie erheblichen Datenverkehr aus nicht-deutschsprachigen Ländern bemerken, erwägen Sie, lokalisierte Inhalte hinzuzufügen oder mehrere Sprachen zu aktivieren.
</Note>

***

## Kanal-Verteilung

Sehen Sie, woher Konversationen stammen:

| Kanal                  | Beschreibung                                                        |
| ---------------------- | ------------------------------------------------------------------- |
| **Widget oder Iframe** | Besucher, die das eingebettete Chat-Widget auf Ihrer Website nutzen |
| **Playground**         | Testkonversationen aus dem Playground Ihres Agenten                 |
| **API**                | Konversationen, die über direkte API-Integration initiiert wurden   |

### Kanal-Einblicke

<AccordionGroup>
  <Accordion icon="desktop" title="Widget/Iframe-Dominanz">
    Die meisten Konversationen sollten von Ihrem Website-Widget stammen - dies zeigt eine ordnungsgemäße Bereitstellung und gute Sichtbarkeit an.
  </Accordion>

  <Accordion icon="flask" title="Hohe Playground-Nutzung">
    Erheblicher Playground-Datenverkehr könnte darauf hinweisen, dass Teammitglieder den Agenten aktiv testen und verbessern.
  </Accordion>

  <Accordion icon="code" title="API-Datenverkehr">
    API-Konversationen zeigen programmatische Integration, nützlich für benutzerdefinierte Anwendungen oder Drittanbieter-Integrationen.
  </Accordion>
</AccordionGroup>

***

## Top-Seiten

Verfolgen Sie, welche Seiten auf Ihrer Website die meisten Chat-Konversationen generieren:

| Spalte              | Beschreibung                                                  |
| ------------------- | ------------------------------------------------------------- |
| **Seite**           | Der URL-Pfad, auf dem Besucher Konversationen gestartet haben |
| **Aufrufe**         | Gesamtzahl der Seitenaufrufe                                  |
| **Chats**           | Anzahl der auf dieser Seite gestarteten Konversationen        |
| **Konversionsrate** | Prozentsatz der Seitenaufrufe, die zu einem Chat führten      |

### Seitendaten nutzen

* **Seiten mit hoher Konversion** - Diese Seiten fördern Engagement; stellen Sie sicher, dass der Agent ausgezeichnetes Wissen über die Themen dieser Seiten hat
* **Seiten mit niedriger Konversion** - Erwägen Sie, die Widget-Sichtbarkeit oder den Seiteninhalt zu verbessern
* **Seiten mit hohem Traffic und wenigen Chats** - Können darauf hindeuten, dass Besucher die benötigten Informationen ohne Unterstützung finden

<Tip>
  Konzentrieren Sie sich darauf, das Agentenwissen für Ihre Seiten mit der höchsten Konversion zu verbessern. Wenn Besucher häufig auf Ihrer Preisseite chatten, stellen Sie sicher, dass Preisinformationen gründlich in Ihrer Wissensbasis abgedeckt sind.
</Tip>

***

## Workspace-weite Nutzung

Über die individuellen Agentenanalysen hinaus können Sie die gesamte Workspace-Nutzung einsehen:

1. Navigieren Sie zu **Nutzung** in der Hauptseitenleiste
2. Sehen Sie aggregierte Metriken über alle Agenten in Ihrem Workspace
3. Vergleichen Sie die Leistung zwischen verschiedenen Agenten

<Note>
  Workspace-Nutzungsanalysen zeigen die kombinierte Aktivität aller Agenten. Dies ist nützlich, um die gesamte Plattformadoption zu verfolgen und Ihre aktivsten Agenten zu identifizieren.
</Note>

***

## Leistung analysieren

Nutzen Sie Analytics-Daten, um Ihren Agenten kontinuierlich zu verbessern:

### Wöchentlicher Überprüfungsprozess

<Steps>
  <Step title="Wichtige Metriken prüfen">
    Überprüfen Sie Gesamtkonversationen und Feedback-Verhältnisse. Steigen die Konversationen? Ist das Feedback überwiegend positiv?
  </Step>

  <Step title="Trends untersuchen">
    Schauen Sie sich das Chats-im-Zeitverlauf-Diagramm auf Muster an. Gibt es unerwartete Spitzen oder Einbrüche?
  </Step>

  <Step title="Geografische Daten überprüfen">
    Prüfen Sie, ob der Datenverkehr aus erwarteten Regionen kommt. Erwägen Sie Lokalisierung, wenn Sie erheblichen internationalen Datenverkehr sehen.
  </Step>

  <Step title="Top-Seiten analysieren">
    Identifizieren Sie Seiten mit hoher Konversion und stellen Sie sicher, dass Ihr Agent eine starke Wissensabdeckung für diese Themen hat.
  </Step>

  <Step title="Maßnahmen ergreifen">
    Aktualisieren Sie basierend auf Ihren Erkenntnissen Ihre Wissensbasis, verfeinern Sie Ihren Systemprompt oder passen Sie die Widget-Platzierung an.
  </Step>
</Steps>

### Verbesserungsstrategien

Basierend auf Ihren Analysen sollten Sie diese Maßnahmen in Betracht ziehen:

| Ergebnis                          | Empfohlene Maßnahme                                                                                                                          |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Niedriges Daumen-hoch-Verhältnis  | Überprüfen Sie [Konversationen](/de/agents/conversations), um problematische Antworten zu identifizieren; aktualisieren Sie die Wissensbasis |
| Hoher Datenverkehr aus neuem Land | Fügen Sie lokalisierte Inhalte hinzu; erwägen Sie, diese Sprache zu aktivieren                                                               |
| Spitze auf bestimmter Seite       | Stellen Sie eine umfassende Abdeckung des Seitenthemas in Ihren Quellen sicher                                                               |
| Rückläufige Konversationen        | Überprüfen Sie die Widget-Sichtbarkeit; prüfen Sie kürzliche Änderungen, die das Engagement beeinflusst haben könnten                        |

***

## Best Practices

<AccordionGroup>
  <Accordion icon="calendar" title="Regelmäßig überwachen">
    Überprüfen Sie Analytics wöchentlich, um Probleme frühzeitig zu erkennen und Verbesserungstrends zu verfolgen.
  </Accordion>

  <Accordion icon="chart-mixed" title="Zeiträume vergleichen">
    Verwenden Sie die Datumsbereichsauswahl, um die aktuelle Leistung mit früheren Zeiträumen zu vergleichen.
  </Accordion>

  <Accordion icon="bullseye" title="Benchmarks festlegen">
    Legen Sie Basis-Metriken für Ihren Agenten fest und verfolgen Sie den Fortschritt im Zeitverlauf.
  </Accordion>

  <Accordion icon="lightbulb" title="Auf Erkenntnisse reagieren">
    Analytics sind nur wertvoll, wenn Sie sie nutzen. Nehmen Sie regelmäßige Verbesserungen basierend auf Ihren Erkenntnissen vor.
  </Accordion>

  <Accordion icon="users" title="Mit Ihrem Team teilen">
    Teilen Sie Analytics-Erkenntnisse mit Stakeholdern, um den ROI zu demonstrieren und Input für Verbesserungen zu sammeln.
  </Accordion>
</AccordionGroup>

***

## Fehlerbehebung

<AccordionGroup>
  <Accordion icon="circle-exclamation" title="Keine Analytics-Daten angezeigt">
    **Mögliche Ursachen:**

    * Agent noch nicht bereitgestellt
    * Es haben noch keine Konversationen stattgefunden
    * Der Datumsbereich enthält keine Aktivität

    **Lösungen:**

    * Überprüfen Sie die Bereitstellung in den [Bereitstellungs](/de/agents/deployment)-Einstellungen
    * Erweitern Sie den Datumsbereich, um mehr Verlauf einzuschließen
    * Testen Sie den Agenten über das Widget, um Daten zu generieren
  </Accordion>

  <Accordion icon="clock" title="Daten scheinen verzögert">
    **Mögliche Ursachen:**

    * Analytics-Verarbeitungszeit
    * Browser-Caching

    **Lösungen:**

    * Warten Sie einige Minuten, bis neue Konversationen erscheinen
    * Aktualisieren Sie die Seite, um die neuesten Daten zu sehen
  </Accordion>

  <Accordion icon="map" title="Geografische Daten fehlen für einige Länder">
    **Mögliche Ursachen:**

    * Besucher verwenden VPN
    * Datenschutzeinstellungen blockieren den Standort

    **Hinweis:** Einige Besucher können aufgrund von Datenschutzeinstellungen ohne Standortdaten erscheinen, was normal ist.
  </Accordion>

  <Accordion icon="filter" title="Metriken entsprechen nicht den Erwartungen">
    **Mögliche Ursachen:**

    * Der Datumsbereich stimmt nicht mit dem erwarteten Zeitraum überein
    * Mehrere Agenten im Workspace

    **Lösungen:**

    * Überprüfen Sie den ausgewählten Datumsbereich
    * Stellen Sie sicher, dass Sie die Analytics des richtigen Agenten anzeigen
  </Accordion>
</AccordionGroup>

***

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Konversationen anzeigen" icon="messages" href="/de/agents/conversations">
    Tauchen Sie in einzelne Chat-Sitzungen ein, um detaillierte Einblicke zu erhalten.
  </Card>

  <Card title="Wissensbasis verbessern" icon="database" href="/de/sources/overview">
    Fügen Sie Inhalte hinzu, um in den Analytics identifizierte Lücken zu schließen.
  </Card>

  <Card title="Systemprompt verfeinern" icon="flask" href="/de/agents/playground">
    Passen Sie das Verhalten Ihres Agenten basierend auf Leistungsdaten an.
  </Card>

  <Card title="Bereitstellung prüfen" icon="rocket" href="/de/agents/deployment">
    Stellen Sie sicher, dass Ihr Agent ordnungsgemäß bereitgestellt ist, um das Engagement zu maximieren.
  </Card>
</CardGroup>