> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/manage-improve-product-data/insights/insights-for-ads/insights-for-bol-ads.md).

# Insights for bol Ads

Set up bol Ads Insights to track product-level campaign performance and use performance segmentation data in rules.

> #### **Who can use this feature**
>
> You need the **Core Pro** plan in your [Channable subscription](/account-billing/manage-your-subscription/channables-pricing-plans.md) to use this feature.

With [Channable Insights](/manage-improve-product-data/insights/channable-insights.md), you can view your bol Ads performance data directly in Channable with key metrics on clicks, impressions, and ad spend to help you optimize your strategy.

In this article, we'll explain how to set up Insights for bol Ads and go over the metrics you can use in segmentation and rules in Channable.

***

### <i class="fa-memo-circle-check">:memo-circle-check:</i> **Before you start**

**You'll need**

* A bol Ads account
* A field containing your product EANs

## **Set up Insights for bol Ads**

1. In your Channable project, go to **Insights > Create Insights**.
2. At **Connect with**, select **\[your bol Ads** **connection]** or create a new one.
3. Fill in the following information:
   1. For **Name**, give your dashboard a distinct name (e.g. 'bol Ads NL - 90 days')
   2. For **Date range setting**, choose between a [Rolling date range](#user-content-fn-1)[^1] or [Fixed date range](#user-content-fn-2)[^2].
   3. For **Date range**, choose the date range you want to pull data from (if fixed range) or the maximum number of days to pull data from (if rolling date range).
   4. For **Channel Unique ID**, select the field containing your item EANs.
   5. For **Group on fields** <mark style="color:$primary;">(optional)</mark>, you can combine your results by shared details like **Brand** or **Category**. Instead of showing every product on its own, your dashboard will add up totals for each group.

{% hint style="info" %}

#### Example

If you sell sports shoes, grouping by `Brand` will group all your items together for the dashboard, so you see total sales by brand (e.g., Nike, Adidas) rather than a huge list showing all 1,000 items line by line.<br>
{% endhint %}

4. Click **New Insights dashboard**.

Within a few minutes, your dashboard will appear with an overview of your products.

### **Available metrics for bol Ads dashboards**

<table><thead><tr><th>Term</th><th width="186">Description</th><th>Available as a segmentation metric?</th><th>Available in Rules?</th></tr></thead><tbody><tr><td>Clicks</td><td>Number of times customers clicked on your ad</td><td>Yes</td><td>Yes</td></tr><tr><td>Conversions</td><td>The number of times users purchased your product. Includes organic and sponsored conversions.</td><td>Yes</td><td>Yes</td></tr><tr><td>Impressions</td><td>Number of times customers saw your ad</td><td>Yes</td><td>Yes</td></tr><tr><td>Cost</td><td>The total commission and shipping cost spent. In case of bol orders it is equal to commission spent</td><td>Yes</td><td>Yes</td></tr><tr><td>Ad sales</td><td>The cumulative sum of both your sponsored and organic sales.</td><td>Yes</td><td>Yes</td></tr><tr><td>ROAS (Return on Ad Spend)</td><td>The ratio of your advertising revenue to your advertising costs</td><td>No</td><td>Yes</td></tr><tr><td>Items sold</td><td>Total number of items sold</td><td>No</td><td>Yes</td></tr><tr><td>CPS (cost per sale)<br>Calculation: Cost / Units sold</td><td>How much you spent on a sale</td><td>No</td><td>Yes</td></tr><tr><td>CPC (Cost per click)</td><td>The amount of money you pay each time someone clicks on your ad</td><td>No</td><td>Yes</td></tr><tr><td>average_cpc</td><td>Average cost per click</td><td>No</td><td>Yes</td></tr><tr><td>ACOS (Advertising Cost of Sales)</td><td>The percentage of the advertising cost compared to the revenue you earned from sponsored products.</td><td>No</td><td>Yes</td></tr><tr><td>CTR (Click-through-rate)</td><td>The percentage of customers who clicked on your ad after viewing it</td><td>No</td><td>Yes</td></tr><tr><td>Direct conversions</td><td>The number of times users purchased your product within 14 days of clicking on it</td><td>No</td><td>Yes</td></tr><tr><td>Indirect conversions</td><td>The number of times users purchased a product from the same category and brand within 14 days of clicking on an ad</td><td>No</td><td>Yes</td></tr></tbody></table>

[^1]: A rolling date range is a dynamic period that's relative to the current day (e.g. 'Last 30 days')

[^2]: A fixed date range has a defining start and end point (e.g. 'January 1 - July 31)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.channable.com/manage-improve-product-data/insights/insights-for-ads/insights-for-bol-ads.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.