# Omni Usage Setup

Euno can observe usage data for Omni workbooks and dashboards—how often they are viewed and by whom. This information helps you identify popular resources, find unused dashboards to archive, and understand adoption patterns.

{% hint style="info" %}
**Prerequisite**: Omni Usage requires the [Omni integration](https://docs.euno.ai/sources/business-intelligence/omni-integration) to also be set up. The Omni integration discovers workbooks and dashboards in Euno; the Omni Usage integration then associates usage data with those resources. Without the Omni integration, there are no resources to attach usage to.
{% endhint %}

For details on the usage properties observed (e.g. `total_impressions_14d`, `used`), see [Omni Usage Data](https://docs.euno.ai/using-euno/usage-optimization/omni-usage-data).

## Overview

Omni Usage is a **push integration**: your Omni instance (or an external system) sends usage data to Euno via a webhook. Euno stores the events and a global processor aggregates them into usage observations on workbooks and dashboards.

## Step 1: Add Omni Usage Integration in Euno

1. Go to the **Sources** page in Euno.
2. Click **Add New Source** and select **Omni Usage**.
3. Configure:

   | Configuration | Description                                                                                                                                                                                               |
   | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Name**      | A name for this integration (e.g. "Omni Usage - Analytics").                                                                                                                                              |
   | **Instance**  | Your Omni instance subdomain. Must match the instance used in your [Omni integration](https://docs.euno.ai/sources/business-intelligence/omni-integration) (e.g. `mycompany` for `mycompany.omniapp.co`). |
4. Click **Save**. Euno will create the integration and generate a **trigger URL** which contains a **trigger secret**.
5. Note the trigger URL from the integration details. You will need these to configure Omni to push data.

## Step 2: Configure Omni to Push Usage Data

Configure your Omni instance or an external export process to send usage data to the Euno trigger URL. Only an Omni Account Admin can complete these steps.

{% stepper %}
{% step %}

#### Open Omni Analytics embedded interface

Login to your Omni instance and locate the Analytics interface.\
![](https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2FudxiJeZ48uvIP5DHM9u2%2Fimage.png?alt=media\&token=bf1672a8-f437-470e-81e4-77ac950d40ec)
{% endstep %}

{% step %}

#### Create a new workbook in Omni Analytics embedded interface

Navigate to the Omni Analytics embedded interface side menu

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fg4nfwqLkGh3bT0t4Tr04%2Fimage.png?alt=media&#x26;token=16ab6145-7ee4-492b-80a0-66d88def1580" alt=""><figcaption></figcaption></figure>

Pick "Hub". This is the Hub of the Omni Analytics embedded interface. It's distinct from the "Hub" of your Omni instance.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2FkCZDOH5Bgk8MrjANX50m%2Fimage.png?alt=media&#x26;token=684ad141-e6fa-4148-8052-ceebc7ec0ba9" alt=""><figcaption></figcaption></figure>

Click "New" to create a new Omni workbook.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2F4SNUS8CQDLD4KjCV7sN0%2Fimage.png?alt=media&#x26;token=1ed00a36-fa31-4071-800f-9339ee2458ee" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Create the Usage query to be pushed to Euno

Pick the `Content Curated` Omni Topic. This will be the topic used by the Query.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-9e446580f8d9aeb19a346f53bf20b50754c2143c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Pick the following fields to be included in the Query, the order of the fields doesn't matter:

| Omni View         | Field                   |
| ----------------- | ----------------------- |
| Document Views    | Timestamp -> Date       |
| Document Views    | Dashboard or Workbook?  |
| Document Views    | Document View Count     |
| Document Consumer | Display Name (Consumer) |
| Workbooks         | Identifier              |

If you picked the right fields, your table should look like:

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-2f72040d0f68960c408b96c7026504cab56d0690%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Sort the table by Timestamp Date, in descending order:

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-eb1946b298ea22e82d5b75967c4bd3c5baa6309d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Save the workbook

Click File -> Save...

Pick any folder and name to save the wookbook in. Remember that the folder structure is not your organization standard folder structure. This is the Omni Analytics embedded interface. To keep things organized, we recommend selecting your organization under the "Hub", and naming the workbook "Omni usage data for Euno integration"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2FrihgUYaDhcl4pQ4o42hz%2Fimage.png?alt=media&#x26;token=c31d67e9-fac6-4efb-a84b-3f77f2565d28" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Create a Dashboard for this workbook

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2F2LMYNDRKRAZJLI7NVPCz%2Fimage.png?alt=media&#x26;token=6aee5232-da38-4d11-8200-6da26b5658c0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Publish the workbook

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-f8a986c6540eff5a4922b4fc7d6c3650df6439f9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Configure Omni Analytics to send usage information to Euno on a schedule

Click File -> "Deliveries & Alerts"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fgit-blob-6a70cce75b39d630bf39d736519f3775799dcac8%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

This will open a side menu to configure a scheduled delivery of the query we configured to Euno.

Pick, from top to bottom:

Delivery: Schedule

Send: Query

Destination: Webhook

Delivery name: query

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2FUB8osktLrYsU3adatWzw%2Fimage.png?alt=media&#x26;token=8976725d-84a5-4908-a559-b477e95bd08c" alt=""><figcaption></figcaption></figure>

Configure The Schedule of delivery. We recommend keeping the defaults.

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2FYNB28LFP7Vz3oKpK2TsT%2Fimage.png?alt=media&#x26;token=1a913193-d9cc-4320-ad97-3de8c909734e" alt=""><figcaption></figcaption></figure>

Under "Chart", pick Format: JSON

Make sure to mark "Send all possible results"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2F4UAOuMDj5qIxSsKWrLvF%2Fimage.png?alt=media&#x26;token=c251ece0-9f48-4bcb-9b28-c1791f35b914" alt=""><figcaption></figcaption></figure>

Under "Webhook", set:

URL: the url you copied from Step 1

File Name: "query"

<figure><img src="https://3442486607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjd87LSzdZm6uu6WlpVMg%2Fuploads%2Fu1cl2WqbqrzFE3HM2lFt%2Fimage.png?alt=media&#x26;token=84a6d299-b162-4ece-859d-95cc792a163e" alt=""><figcaption></figcaption></figure>

To test, click "Test now". To save, click "Save"
{% endstep %}
{% endstepper %}

## Related

* [Omni integration](https://docs.euno.ai/sources/business-intelligence/omni-integration) – Set up the Omni integration to discover workbooks and dashboards.
* [Omni Usage Data](https://docs.euno.ai/using-euno/usage-optimization/omni-usage-data) – Properties and metrics observed for Omni resources.