> For the complete documentation index, see [llms.txt](https://docs.ingestlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ingestlabs.com/media-data-platform/dashboard/analytics-dashboard/facebook-ad-insights.md).

# Facebook Ad - Insights

## Introduction

**Facebook Ad – Insights** is a dashboard that helps you track and understand the performance of your ad campaigns on **Facebook**.

## Dashboard – Overview Widget

<figure><img src="/files/fEGQux7aMBMpCwbMp41V" alt=""><figcaption></figcaption></figure>

All widgets display data for the selected time period.

| Dashboard Screen | Description                                                                   |
| ---------------- | ----------------------------------------------------------------------------- |
| CPM              | Shows how much money you spent to display your ad 1,000 times.                |
| CPC              | Shows how much you paid for **one click** on your ad.                         |
| CTR              | Shows the **percentage of people who clicked** your ad after seeing it.       |
| ROAS             | Shows how much **revenue you earned for every 1 unit of money spent** on ads. |
| Clicks           | Shows the **total number of times users clicked** on your ad.                 |
| Spend            | Shows the **total amount of money spent** on ads.                             |
| Impressions      | Shows the **total number of times your ad was shown** to users.               |
| Revenue          | Shows the **total money earned from the ad campaigns**.                       |

Click the **Refresh** button to refresh all the widgets on the dashboard.

<figure><img src="/files/UuD4DgPVk5Ijpktb5ZFA" alt=""><figcaption></figcaption></figure>

When you hover over a widget, the following options are displayed.

**As of \<date and time>** – Shows the date and time when the widget data was last updated.

**Refresh icon** – Refreshes only the selected widget and loads the latest data.

<figure><img src="/files/cm6inMpXza2kEdsKXMhh" alt=""><figcaption></figcaption></figure>

## Trend indicator

This indicator shows the percentage change in the widget value compared to the previous period.

A **red downward arrow with a percentage** indicates that the value has **decreased** compared to the previous date range.

<figure><img src="/files/e684XQ18sd0gVU9jZeIs" alt=""><figcaption></figcaption></figure>

A **green upward arrow** indicates that the value has **increased** compared to the previous date range.

<figure><img src="/files/2wlKsGLrNZNS6cSk8QZp" 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="/files/QneWpLdNcL0n9XDZv19f" 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="/files/tgtXbeirmxXE2VbzK3zh" 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="/files/nLWrcFMpb74uf3DSD0Ok" 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="/files/mb1bjFVX4H8gQCCkZSIg" alt=""><figcaption></figcaption></figure>

Select the start and end dates directly from the calendar.

<figure><img src="/files/EEPWL1O5sUxZd4ggWccG" alt=""><figcaption></figcaption></figure>

Use the left and right arrows to move between months.

<figure><img src="/files/pSphRCxNCQXuodpwny6Z" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/qyr1sXBRhd2l7Xps1z5z" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/p7GtMVQYFuKCEos2HuQ0" alt=""><figcaption></figcaption></figure>

## Insights

<figure><img src="/files/9SZAVw34unRiXDsZ6gjm" alt=""><figcaption></figcaption></figure>

The following details are available:

|                           |                                                                                       |
| ------------------------- | ------------------------------------------------------------------------------------- |
| Account Name              | Shows the name of the ad account where the campaign is created.                       |
| Campaign Name             | Shows the name of the campaign used to promote your ads.                              |
| Adset Name                | Shows the ad set name, which defines the targeting, budget, and schedule for the ads. |
| Ad Name                   | Shows the individual ad name created under the ad set.                                |
| CPM                       | Shows how much you paid to display your ad 1,000 times.                               |
| CTR                       | Shows the percentage of users who clicked the ad after seeing it.                     |
| Ad Spend                  | Shows the total amount of money spent on the ads.                                     |
| Clicks                    | Shows the total number of times users clicked the ad.                                 |
| Impressions               | Shows the total number of times the ad was shown to users.                            |
| ROAS (Return on Ad Spend) | Shows how much revenue you earned for every unit of money spent on ads.               |
| Revenue                   | Shows the total revenue generated from the ads.                                       |

When you hover over, the following options are available:

**As of** – Displays the date and time when the widget data was last updated.

**Export to CSV** – Downloads the widget data in CSV format.

**Refresh widget** – Refreshes the widget to load the latest data.

<figure><img src="/files/RqBqC8bOoIRoZ5eA9EDA" alt=""><figcaption></figcaption></figure>

The text Showing **1 to 10 of 113** indicates the range of records currently displayed and the total number of available records.

Click this drop-down to choose the number of records displayed in the widget.

The Previous and Next icons allow users to move to the previous or next page.

The First and Last icons allow users to jump to the first or last page of the results.

<figure><img src="/files/A3mzLu3uuos2aKg4eksk" alt=""><figcaption></figcaption></figure>

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaDMDmegqZUJFhJhF4JQG%2Fuploads%2FBmcSMPqRTy9q8i5m2T8d%2FFacebook%20Ad%20-%20Insights.mp4?alt=media&token=d6c08fee-9373-4ffa-8f12-6447504eda6d>" %}


---

# 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://docs.ingestlabs.com/media-data-platform/dashboard/analytics-dashboard/facebook-ad-insights.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.