> For the complete documentation index, see [llms.txt](https://user.netmera.com/netmera-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://user.netmera.com/netmera-user-guide/omnichannel-engagement/widgets/measure-performance/analyze-widget-performance.md).

# Analyze widget performance

Analyze widget impressions and interactions with standard mobile and web widget events in Event Insight.

Widget events measure delivery and engagement across mobile and web. Use **Analysis → Event Insight** to review standard and custom events.

{% hint style="success" %}
Events appear only after a widget triggers them and a user event occurs.
{% endhint %}

### Standard widget events

<table><thead><tr><th>Mobile</th><th width="250.70703125">Web</th><th>What it records</th></tr></thead><tbody><tr><td>Widget Shown Mobile</td><td>Widget Shown Web</td><td>The widget displays without an eligible interaction.</td></tr><tr><td>Widget Action Mobile</td><td>Widget Action Web</td><td>An eligible interaction with a configured link or deeplink.</td></tr><tr><td>Spin To Win Shown</td><td>Spin To Win Shown</td><td>The Spin to Win widget displays.</td></tr><tr><td>Spin Button Clicked</td><td>Spin Button Clicked</td><td>The user starts the spin.</td></tr><tr><td>Coupon Code Assigned</td><td>Coupon Code Assigned</td><td>The user receives a coupon code.</td></tr><tr><td>Coupon Code Assigned Failed</td><td>Coupon Code Assigned Failed</td><td>Coupon assignment fails.</td></tr><tr><td>Coupon Code Copied</td><td>Coupon Code Copied</td><td>The user copies the assigned coupon code.</td></tr></tbody></table>

### Review standard events

1. Go to **Analysis → Event Insight**.
2. Select the mobile or web event you want to analyze.
3. Choose dimensions such as time, user type, or device.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F7dsVwVrNVXVDRXxAtgYb%2FScreenshot%202025-02-18%20at%2013.41.19.png?alt=media&#x26;token=36e49603-2d50-4114-a386-c40bc9d51555" alt="Widget events in Event Insight"><figcaption><p>Select an event, then choose dimensions for the analysis.</p></figcaption></figure>

### Action tracking requirements

A standard widget action requires one tracked image or button with one link or deeplink. This supports automatic action attribution.

{% hint style="warning" %}
Use [custom widget events](/netmera-user-guide/omnichannel-engagement/widgets/measure-performance/track-custom-widget-events.md) when you need to measure multiple interactions or business-specific behavior.
{% endhint %}

Eligible actions include:

* Clicking an image that opens a product page.
* Selecting a button that opens a section in the app or website.
* Tapping a promotional button that opens an offer or coupon code.

### Mobile widget events

#### Widget Shown Mobile

This event records when a user sees the widget without clicking or navigating from it. This includes users who close the widget with the **X** button or use a dismiss button without a link.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FZoB0pfELnfYqfnDoeCLu%2FScreenshot%202025-02-18%20at%2013.42.33.png?alt=media&#x26;token=a5007cd3-59ab-4587-8921-e461f0b981c6" alt="Widget Shown Mobile event"><figcaption><p>Widget Shown Mobile measures views without an eligible action.</p></figcaption></figure>

#### Widget Action Mobile

This event records an eligible interaction with an image or button that contains a link or deeplink.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FKJBvzeRTFes1nyGFKpgp%2FScreenshot%202025-02-18%20at%2013.44.49.png?alt=media&#x26;token=7c58d7a9-c023-4f71-aaca-126f6e7e8bff" alt="Widget Action Mobile event"><figcaption><p>Widget Action Mobile measures eligible linked interactions.</p></figcaption></figure>

### Web widget events

#### Widget Shown Web

This event records when a user sees the widget without clicking or navigating from it. This includes users who close the widget with the **X** button or use a dismiss button without a link.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FqJVBNxcaamTZeIyfy8ga%2FScreenshot%202025-02-18%20at%2015.55.39.png?alt=media&#x26;token=c43ee8b6-1234-4837-8b3e-a5aa5023e30f" alt="Widget Shown Web event"><figcaption><p>Widget Shown Web measures views without an eligible action.</p></figcaption></figure>

#### Widget Action Web

This event records an eligible interaction with an image or button that contains a link or deeplink.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F04nLP8y68X3A4CcBeYvw%2FScreenshot%202025-02-18%20at%2015.53.57.png?alt=media&#x26;token=91b83c2c-5ed0-4356-bd57-466cdc9fcd8c" alt="Widget Action Web event"><figcaption><p>Widget Action Web measures eligible linked interactions.</p></figcaption></figure>

### Spin to Win events

Use **Analysis → Event Insight** to review Spin to Win activity. For the full reward event guide, see [Analyze Spin to Win performance](/netmera-user-guide/omnichannel-engagement/widgets/build-a-widget/spin-to-win-campaigns.md#measure-performance).

* **Spin To Win Shown**: the Spin to Win widget displays.
* **Spin Button Clicked**: the user starts the spin.
* **Coupon Code Assigned**: the user receives a coupon code.
* **Coupon Code Assigned Failed**: coupon assignment fails after the spin.
* **Coupon Code Copied**: the user copies the assigned coupon code.

<figure><img src="https://1642824329-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FaCvRQzn9YKPfSdJ8OucE%2FScreenshot%202024-05-13%20at%2013.23.23.png?alt=media&#x26;token=25c80cc2-605d-423b-90ee-0d17c4e75f5e" alt="Spin to Win events in Event Insight"><figcaption><p>Use the listed Spin to Win events to analyze the reward flow.</p></figcaption></figure>


---

# 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://user.netmera.com/netmera-user-guide/omnichannel-engagement/widgets/measure-performance/analyze-widget-performance.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.
