> 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 %}