> For the complete documentation index, see [llms.txt](https://help.craftsmanplus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.craftsmanplus.com/analytics/analytics-dashboard/insights.md).

# Insights

Read the best practices and next-step ideas INTELLIGENCE draws from a creative's performance, then build them as a new variant or project.

<figure><img src="https://3403191029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYsCUHima0FilwMqIJBnV%2Fuploads%2Fs3YILqps28eUusIxbOiv%2FINSIGHTS.png?alt=media&amp;token=c40c5616-c7fe-44fd-b45c-044bbe3d7717" alt=""><figcaption></figcaption></figure>

**Insights** turns a creative's ANALYTICS into decisions. INTELLIGENCE studies how the creative performed and tells you which design choices worked, which ones it's missing, and where to take it next.

Use it to fix a creative that underperforms, to build a stronger variant of one that's working, or to start a new concept that carries over what made the original succeed.

***

### Finding Insights

Insights sits on each creative's [Analytics Dashboard](https://help.craftsmanplus.com/analytics/analytics-dashboard/overview.md), between the **Summary** and **Impressions** sections. Scroll down from the top, or click **Insights** in the sidebar.

Insights appear once a creative has **1,000** impressions and a week of data. After that, they refresh every Sunday for creatives that recorded new activity that week. Until the first insights are ready, the section reads "Insights haven't been generated for this creative yet."

Insights cover the creative as a whole. The **Export**, **Partners** and **Date Range** filters don't change them.

***

### Best Practices

The **Best Practices** card lists design decisions that affected this creative's performance, such as "Tap-to-play within the first 2 seconds". Each practice has a title naming the practice and a line describing what this creative did. Practices are split into two groups, each with a count:

* **Already Applied:** practices the creative already uses that helped it perform. They're always checked and can't be unchecked.
* **Ready to Apply:** practices the creative is missing, found where it performed poorly. They're all checked by default.

#### Applying Practices

1. Uncheck any **Ready to Apply** practice you want to skip. Its text is struck through. Check it again to include it.
2. Click **Apply Practices** to start generating.

The project opens in the PLAY editor in a new tab, with a new variant of the creative. INTELLIGENCE opens beside it and starts building only the practices you kept checked. The original creative is never changed.

{% hint style="info" %}
Your checkbox choices are saved for the creative, so everyone on your team sees the same selection. They reset when insights refresh, and every new **Ready to Apply** practice starts checked.
{% endhint %}

***

### Recommendations

The **Recommendations** card suggests where to take the creative next. Each recommendation comes from how the creative performed, and shows a type label, a short summary of the idea and a tag naming the main change, such as **Faster Pacing**.

The card shows up to five recommendations, New Variants first:

| Type                      | What it is                                                                              | Button                   | What happens                                                                |
| ------------------------- | --------------------------------------------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------- |
| **New Variant** (up to 3) | A bigger change to this creative, such as its theme, framing, structure or progression. | **Generate Variant**     | The project opens in PLAY in a new tab, with a new variant of the creative. |
| **New Concept** (up to 2) | A new concept, built from scratch.                                                      | **Generate New Project** | A new project opens in PLAY in a new tab.                                   |

INTELLIGENCE opens with the full brief and starts building right away, so you don't write a prompt. Every recommendation includes all of the creative's best practices, from both groups.

{% hint style="info" %}
Unchecking a practice only affects **Apply Practices**. **Generate Variant** and **Generate New Project** always build in every practice on the **Best Practices** card.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.craftsmanplus.com/analytics/analytics-dashboard/insights.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
