> ## Documentation Index
> Fetch the complete documentation index at: https://developers.nlpearl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Analytics

<div className="block dark:hidden">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/YPwGw7hP4aonkrpJ/images/dark_mode/text-pearl-analytics-cover.svg?fit=max&auto=format&n=YPwGw7hP4aonkrpJ&q=85&s=5a1b4a225e2e420aa9e06058581203ec" alt="Chat Analytics cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/text-pearl-analytics-cover.svg" />
    </div>
  </Frame>
</div>

<div className="hidden dark:block">
  <Frame>
    <div className="p-1">
      <img src="https://mintcdn.com/nlpearl/YPwGw7hP4aonkrpJ/images/dark_mode/text-pearl-analytics-cover.svg?fit=max&auto=format&n=YPwGw7hP4aonkrpJ&q=85&s=5a1b4a225e2e420aa9e06058581203ec" alt="Chat Analytics cover" className="rounded-[14px]" width="1048" height="720" data-path="images/dark_mode/text-pearl-analytics-cover.svg" />
    </div>
  </Frame>
</div>

Use this section to track, evaluate, and act on your Pearl's performance. Define what success looks like, apply custom tags to key conversation moments, and set up notifications to stay on top of important conversations.

<Note>
  Other charts in your Chat Analytics dashboard are tracked automatically and don't depend on this setup step.
</Note>

***

## Define the Success of Your Pearl

Specify what constitutes a successful conversation for your Pearl, such as booking a meeting, confirming interest, or qualifying a lead. This success definition will be reflected in your campaign analytics and lead statuses, helping you sort and follow up efficiently.

The success criteria is **free text**, up to **200 characters**.

<Frame>
  <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/pearl-analytics-1.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=34df6e299ca07ceab2b3e2a81c82c199" alt="Define the success of your Pearl" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/pearl-analytics-1.png" />
</Frame>

<Info>
  **In your Chat Analytics dashboard**, without a success definition, conversations are counted as **Completed**. Once defined, they split into **Successful** (green) and **Unsuccessful** (pink), and the **Success Rate** chart tracks the percentage of conversations that met your criteria over time (empty until success is defined).
</Info>

***

## Indicator Tags

Use **Indicator Tags** to label and categorize key moments in a conversation. They help you structure your data, identify important insights, and filter your leads with precision.

<Frame>
  <img src="https://mintcdn.com/nlpearl/5aa5Rk7qHypaYdNc/images/dark_mode/pearl-analytics-2.png?fit=max&auto=format&n=5aa5Rk7qHypaYdNc&q=85&s=8481734c0dce9aa1fd77fb569c595beb" alt="Indicator Tags" className="rounded-[14px]" width="5120" height="2880" data-path="images/dark_mode/pearl-analytics-2.png" />
</Frame>

You can create up to **10 tags**. Each tag includes:

* **Name**: A clear label, required (max **25 characters**), e.g. `"Interested"`, `"Mentioned Competitor"`.
* **Color**: Used for visual sorting. Each tag must use a **unique color**, a color already assigned to another tag can't be reused.
* **Assignment rule (When to assign)**: A short description of when the tag should be applied, required (max **300 characters**).

Tags are assigned automatically during the conversation, based on the conditions you define.

<Card>
  ### Example

  You're asking leads what they usually drink in the morning. You might define:

  * **Tag**: `Coffee`
    * **Color**: Brown
    * **When to assign**: If the lead mentions drinking coffee

  * **Tag**: `Tea`
    * **Color**: Green
    * **When to assign**: If the lead mentions drinking tea

  These tags will then appear in your lead data and conversation logs, making it easy to segment and analyze responses.
</Card>

<Info>
  Indicator Tags are not just for display. They're functional. You can filter campaigns by tag, trigger notifications, or use them to define success in analytics.  <br /><br />
  In your **Chat Analytics dashboard**, they feed the **Tags** chart, showing each tag's name, its chosen color, and how many conversations it was applied to.
</Info>
