# Add a Widget to the Dashboard

## Introduction

This section explains how to add a widget to a custom dashboard.

## Procedure

Perform the following steps to create widgets in the Dashboard:

Follow the procedure provided in [Create a New Custom Dashboard](https://docs.ingestlabs.com/media-data-platform/dashboard/create-a-new-custom-dashboard) to create a new dashboard.

**Step 1:** Click **Add Widgets**.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F5wB7SIwy6IRZRA8djP4k%2Fimage.png?alt=media&#x26;token=c67f0149-8c2d-4f7f-8b6c-7be2cf403230" alt=""><figcaption></figcaption></figure>

**Step 2:** The **Select a Context** window opens. Select a context to build the widget using the available dimensions, metrics, and segments.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F7dUb3eErwaOCKH75QAfb%2Fimage.png?alt=media&#x26;token=13fb4a2b-308e-4cfa-823b-7e230081d587" alt=""><figcaption></figcaption></figure>

**Step 3:** Click Use This Context.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FZ5jkpA4AHdYTGFSNWRJo%2Fimage.png?alt=media&#x26;token=d36817a4-c30f-4fc2-a215-9f828687581b" alt=""><figcaption></figcaption></figure>

**Note:** The selected context is displayed here. To change it, hover over the context and click **Change**.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FQHVRoZoWLJc00fCBZalH%2Fimage.png?alt=media&#x26;token=01cce8b4-a0a6-4811-a723-330f111baf88" alt=""><figcaption></figcaption></figure>

**Step 4:** Select Visualization Type.

Select the type of visualization to display the widget data.

* Data Tabl&#x65;**:** Displays the data in a tabular format with rows and columns.
* Counter: Displays a single metric value as a numeric count.
* Line Chart: Shows trends or changes in data over a period of time.
* Bar Chart: Compares data across different categories using bars.
* Pie Chart: Displays data as proportions of a whole in a circular chart.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F5q9bCojzViOesIPCZhey%2Fimage.png?alt=media&#x26;token=bb36d0ff-6965-42b0-bb6f-1abf7e58c038" alt=""><figcaption></figcaption></figure>

**Step 5:** Dimensions.\
Drag and drop the required dimensions to organize and analyze the widget data.

Available dimensions include:

* Conversion Dat&#x65;**:** Displays the date when the conversion occurred.
* Conversion Event Name: Displays the name of the conversion event.
* Conversion App Type: Displays the application type where the conversion occurred.
* Browser: Displays the browser used by the user.
* Operating System: Displays the operating system of the user’s device.
* Device Form Factor: Displays the type of device used (for example, mobile, tablet, or desktop).
* UTM Source: Displays the traffic source that directed users to the application.
* UTM Medium: Displays the marketing medium used (for example, email, CPC, or social).
* UTM Term: Displays the keyword or term used in the campaign.
* Campaign ID: Displays the unique identifier assigned to the campaign.
* Campaign Referrer Domain: Displays the domain from which the campaign traffic originated.
* User Visit Type: Displays the type of user visit, such as new or returning.
* Creative Name: Displays the name of the creative used in the campaign.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F5tpdV9owhrrxYevxl606%2Fimage.png?alt=media&#x26;token=5c858a9f-4388-4efd-92da-e817e6b86fbd" alt=""><figcaption></figcaption></figure>

**Step 6:** Metrics.\
Drag and drop the required metrics to measure and analyze the widget data.

Available metrics include:

* Total Conversion Value: Displays the total value generated from all conversions.
* Average Conversion Value: Displays the average value of each conversion.
* Minimum Conversion Value: Displays the lowest conversion value recorded.
* Number of Conversions: Displays the total number of conversion events.
* Number of Conversions (Last Touch): Displays the number of conversions attributed to the last interaction before the conversion.
* Total Users: Displays the total number of users who performed the tracked activity.
* Average Sales Tim&#x65;**:** Displays the average time taken for a user to complete a conversion.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FXKDL6b99HAO95gOSjgaa%2Fimage.png?alt=media&#x26;token=da57bc33-20d4-45b4-8592-07c179b79a6b" alt=""><figcaption></figcaption></figure>

**Step 7:** To add a new segment, click the plus (+) icon.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FAk65YW5b7hGg0G3XoQXj%2Fimage.png?alt=media&#x26;token=057a91b3-5775-44df-b5c1-5327dc428c33" alt=""><figcaption></figcaption></figure>

**Step 8:** To add a filter, click the plus (+) icon.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FbROkiqpm45M7fpyDflfC%2Fimage.png?alt=media&#x26;token=483497d2-c5df-46f6-ab5b-2e98bd21d059" alt=""><figcaption></figcaption></figure>

**Step 9:** Drag and drop the selected fields into the Widget Preview area.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FXXpn4gsMJEkm1BWSiGDW%2Fimage.png?alt=media&#x26;token=eeb2811c-4996-4b59-9570-aad02bfcb148" alt=""><figcaption></figcaption></figure>

The selected items are displayed here.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FUaop0EsxtNvI9RZjtkGg%2Fimage.png?alt=media&#x26;token=60fa70ba-4c18-4f18-8656-28a6b13639af" alt=""><figcaption></figcaption></figure>

**Step 10:** In the Name field, enter the widget name.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F7a42ZoLyxQ7Hn9yZTS3h%2Fimage.png?alt=media&#x26;token=53d97463-5bf6-4fdd-9143-6f2a60590ceb" alt=""><figcaption></figcaption></figure>

**Step 11:** Click Add Widget to add the widget.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FJR3Xc8dSmpnBqWmaCSto%2Fimage.png?alt=media&#x26;token=13696a14-29c5-49dd-8fd7-5db0012efb2f" alt=""><figcaption></figcaption></figure>

**Step 12**: A message appears: **Widget created successfully**.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F3eCUw9EadgQHovHx7bNq%2Fimage.png?alt=media&#x26;token=57943ae8-73df-47d4-852a-79ea8c6844b1" alt=""><figcaption></figcaption></figure>

## Date and Time Range

Use the Date and Time Range filter to select the period for which the widget data is displayed.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FFuEOQx2d20Ufkmy52wHG%2Fimage.png?alt=media&#x26;token=75d39d59-3627-4cb9-a1de-f6d4c1c101ef" alt=""><figcaption></figcaption></figure>

Note: By default, the Dashboard is set to display the data for the last 7 days.&#x20;

Displays the currently selected start and end dates. At the moment, the dashboard is set to display data for the last seven days.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F65StokfFGyiine473D9F%2Fimage.png?alt=media&#x26;token=1381623c-266a-40ea-beca-a4051c8e5839" alt=""><figcaption></figcaption></figure>

Click the drop-down to select a predefined date range, such as Today, Yesterday, Last 7 Days, This Month, or Previous Month. By default, *Last 7 Days* is selected.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FOSeLRlzzEj95OGac83Lt%2Fimage.png?alt=media&#x26;token=ebd6dd37-ff67-4239-8f24-b76330635396" alt=""><figcaption></figcaption></figure>

You can use the slider to select the time range, and the selected time is displayed next to it.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FpelXfamaJa3jAI7Tvi7i%2Fimage.png?alt=media&#x26;token=50cdfd10-2fb2-4766-8e2b-c51d15da5d7d" alt=""><figcaption></figcaption></figure>

Select the start and end dates directly from the calendar.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FbLnswhEUpZAPguM2Ssbn%2Fimage.png?alt=media&#x26;token=b7f22523-148e-44fb-90ce-07ea37980b2a" alt=""><figcaption></figcaption></figure>

Use the left and right arrows to move between months.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2F9jFGnrzvOSGcOkAdxJod%2Fimage.png?alt=media&#x26;token=d894feb6-e0d7-4128-a83d-f20b75703c05" alt=""><figcaption></figcaption></figure>

Click ***Apply*** to apply the selected date and time range.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FgHMyD4v44r4E0RvNEiMl%2Fimage.png?alt=media&#x26;token=4cd5eee6-e08c-4875-8f7a-08a06afae6c0" alt=""><figcaption></figcaption></figure>

Click ***Cancel*** to discard your changes and close the filter.

<figure><img src="https://2731380315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FfOsqTvaKLLvvdcKkjJhr%2Fimage.png?alt=media&#x26;token=55a17d7c-a181-4cb6-880d-ce3aa6c7b6a5" alt=""><figcaption></figcaption></figure>
