# Sigma Impressions Data

Euno can observe impression data for Sigma workbooks and elements based on CSV exports that Sigma writes to cloud storage.

{% hint style="info" %}
To observe Sigma impressions, you must set up both the [Sigma integration](/sources/business-intelligence/sigma-integration.md) and the [Sigma Impressions integration](/sources/business-intelligence/sigma-impressions-integration.md). The Sigma integration discovers workbooks and elements in Euno; the Sigma Impressions integration then attaches impression events to those discovered resources.
{% endhint %}

## Impression Records

An impression record is generated whenever a row in your exported Sigma CSV represents a successful view or access event for a Sigma workbook or workbook element.

Euno reads these rows from the cloud storage prefix configured on the [Sigma Impressions integration](/sources/business-intelligence/sigma-impressions-integration.md), converts them into event records, and aggregates them onto Sigma resources in Euno.

## Properties

| Property                                                                                                                                                  | Value                                                                                                                                                          | Applicable to                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| <p><code>total\_impressions\_14d</code><br><code>total\_impressions\_30d</code><br><code>total\_impressions\_60d</code></p>                               | The total number of impressions the resource had in the last 14 / 30 / 60 days.                                                                                | `sigma_workbook`, `sigma_workbook_element` |
| <p><code>distinct\_impressions\_users\_14d</code><br><code>distinct\_impressions\_users\_30d</code><br><code>distinct\_impressions\_users\_60d</code></p> | The number of distinct users who viewed the resource in the last 14 / 30 / 60 days.                                                                            | `sigma_workbook`, `sigma_workbook_element` |
| <p><code>queries\_breakdown\_by\_user\_14d</code><br><code>queries\_breakdown\_by\_user\_30d</code><br><code>queries\_breakdown\_by\_user\_60d</code></p> | Per-user impression breakdown for the last 14 / 30 / 60 days. Useful for drilling into who is using a workbook or element.                                     | `sigma_workbook`, `sigma_workbook_element` |
| `used`                                                                                                                                                    | A list of user-usage entries with timestamps and rolling 14 / 30 / 60 day counts. Supports user-level analysis in the resource side panel and chat experience. | `sigma_workbook`, `sigma_workbook_element` |

## Workbook vs. Element Impressions

Sigma Impressions supports two levels of attribution:

* **Workbook impressions** attach directly to a `sigma_workbook`
* **Element impressions** attach to an element within a workbook

If a CSV row includes an `element_id`, Euno attributes the record to the corresponding Sigma element. Otherwise, Euno attributes the record to the Sigma workbook identified by `workbook_url_id`.

## Recommended CSV Columns

For the most predictable setup, export a workbook page element that includes these columns:

* `request_time`
* `user_email`
* `workbook_url_id`
* `element_id` (optional)
* `count` (optional; defaults to `1` when omitted)

Column matching in Euno is case-insensitive, and common aliases are accepted, but using the canonical names above makes setup and troubleshooting simpler.

## Related

* [Sigma Impressions integration](/sources/business-intelligence/sigma-impressions-integration.md) – Configure the crawler that reads impression CSVs from S3 or GCS.
* [Sigma integration](/sources/business-intelligence/sigma-integration.md) – Discover Sigma workbooks, folders, data models, and elements in Euno.
* [Sigma Usage Data](/using-euno/usage-optimization/sigma-usage-data.md) – Warehouse-query usage metrics for Sigma resources.


---

# Agent Instructions: 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:

```
GET https://docs.euno.ai/using-euno/usage-optimization/sigma-impressions-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.