> For the complete documentation index, see [llms.txt](https://docs.gearplug.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gearplug.io/english/set-up-your-integrations/facebook-ads/facebook-ads-insights-source.md).

# Facebook Ads Insights (source)

Integrating Facebook Ads Insights into GearPlug allows you to extract the necessary data to assess your campaigns’ performance, importing their metrics into a database.

As a source, Facebook Ads Insights offers 4 actions. Each one draws information at a different level:

* **Ad account**: Data from your entire account.
* **Campaign**: Data from one campaign.
* **Adset**: Data from one adset.
* **Ads**: Data from one ad.

Follow the steps below to set up your source Plug.

1. **Select Facebook Ads Insights** as your source app in the “Gears” section in your GearPlug app. Click “Create.”

<figure><img src="https://lh4.googleusercontent.com/C-_KVpGVo6rjAZE8rK3afTgPQ1vY-e059A4h0FhzQbYeEYq1HE3gGp_KeGv2r6_uPCPk3Xf8QUV6i249QhdtFoGPSqJUvKbdbOcLf9UE3OVh345_kKuY4qviFU2O890azzFSlnyOzv2Zg4-PufFfPg" alt=""><figcaption></figcaption></figure>

2. **Pick the connection** you want to use, or create a new one. Click “Continue.” GearPlug will run a quick test to verify everything works properly.

<figure><img src="https://lh4.googleusercontent.com/fEql9gIZr7IdoWiik3kVw2p-40UEspikdiZZQPGx15J7rP9mx2F5gidbjgQkFhUfdzbfT6uTYjiPNRVog5-O0sK_H1mpTgr0A8RQFZvqupHDYzB7BEHwb7teTCozLEl4o2Kiv4Oiz267CnBjfGXgaw" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
GearPlug will check whether the connection functions properly before moving on. If it doesn’t, you won’t be able to continue setting up your Gear.&#x20;
{% endhint %}

3. **Choose the action** according to the data level you want to extract: your account, a campaign, an adset, or an ad. Fill in the required fields, including the ad account, from which day, month, and year you want to cover, and how often you want to draw data. Click “Create.”

<figure><img src="https://lh4.googleusercontent.com/dpMlhzwDcA8ARIE955MLgSnRIvSPX-18pwgUbKWm9scfSI46I-qC8UW9ZPJsVYduSeo-NzhL1XY-bV_TePXWD0GXDn9Zb4lJhASLoBon4WKt0fKPfdxYVdrLIhdEmKsD4a-s08pfy4tOxuh-r9UJdA" alt=""><figcaption></figcaption></figure>

4. **Review the imported data** to make sure everything works properly. Then, click “OK” to finish setting up your source Plug.

<figure><img src="https://lh5.googleusercontent.com/2ISqLKICw5nrDbvB1sEa1od12a1iEp-D7PPfCaO8BqlUxeVUs42lDjzVIzVi_QH_pDIskUmEpbR-umEFFByv0kUeyhx9KumNzP37k4Z8cFCmSPLrm-IOLLydochdnYDn-_ZavtSMQoQ8QF9NPE0m8g" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Empty fields**: Under the imported record, you’ll find a drop-down list of “Empty Fields.” There, you’ll find fields you can import—but weren’t used in your record.
{% endhint %}


---

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

```
GET https://docs.gearplug.io/english/set-up-your-integrations/facebook-ads/facebook-ads-insights-source.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.