---
description: >-
  Step-by-step guide to ingest data from your Facebook Ads account into
  RudderStack.
---

# Facebook Ads

[Facebook Ads](https://www.facebook.com/business/ads) is an online advertising platform that lets you create and run cross-device marketing campaigns, and track their performance with easy to read reports. With Facebook Ads, you can create, publish and purchase ads across all Facebook platforms - including Facebook, Instagram, Facebook Messenger, and Audience Network.

This document guides you in setting up Facebook Ads as a source in RudderStack. Once configured, RudderStack automatically ingests your specified Facebook Ads data, which can then be routed to your data warehouse destination supported by RudderStack.

**All the Cloud Extract sources support sending data only to a data warehouse destination.**

## Getting Started

To add Facebook Ads as a source in RudderStack, follow these steps:

* Log into your [RudderStack dashboard](https://app.rudderlabs.com/signup?type=freetrial).
* From the left panel, select **Sources**. Then, click on **Add Source**, as shown:

![Add Source](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-12cb52c49bfb39c9d6a5771907761809351a813e%2F1%20\(4\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(2\)%20\(4\).png?alt=media)

* Next, select **Facebook Ads** from the list of **Cloud Sources**, and click on **Next**.

![Facebook Ads](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-430066b793604549d7a83d9e2a25b8e08bf2237f%2F2%20\(1\).png?alt=media)

* Assign a name to your source, and click on **Next**.

![Assign a name to your source](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-edd94b3841f98de1d0e4b167024e7f93faa24978%2Fscreen-shot-2021-02-08-at-1.21.12-pm.png?alt=media)

### Setting Up the Connection

* Click on **Connect with Facebook Ads** and give RudderStack the required access permissions. Then, click on **Next**.

![Connect with Facebook Ads](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-056f1f58aadc34c5b2f0cbbd08357fefae770894%2Fscreen-shot-2021-02-08-at-1.23.21-pm%20\(1\).png?alt=media)

If you have already connected RudderStack to your Facebook Ads account, your credentials should appear automatically under **Use existing credentials**.

### Configuring the Source

* In the next screen, choose the **Page** from where you want RudderStack to import the data. Also, select the **Historical data** as well as the **Attribution window** timeframe, and click on **Next**.
  * **Historical Data** - this sets the range for the first sync, and can be used to fetch the historical pull
  * **Attribution window** - this sets the date range for any subsequent sync

![Attribution Window](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-5b4ff61e926a85e1ff47c8a98a7069d239682e75%2Fscreen-shot-2021-02-08-at-1.22.07-pm.png?alt=media)

RudderStack will not sync the data which is older than the selected timeframes.

### Setting the Data Update Schedule

* Next, you will be required to set the **Run Frequency** to schedule the data import from your Facebook Ads account to RudderStack. You can also specify the time when you want this synchronization to start, by choosing the time under the **Sync Starting At** option.

![Run Frequency](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-c34cfd88008158944caf9ea7dd64d9641d157738%2F6%20\(7\).png?alt=media)

### Specifying the Data to Import

* Finally, select the data from the Facebook Ads page that you want RudderStack to import. You can choose to import data from select columns, or import all the data by clicking on **Select All**. Then, click on **Next**.

![Import Data](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-2bfec50b60cc73c183b56fb779bcdfe0a61d8080%2Fscreen-shot-2021-02-08-at-1.24.13-pm.png?alt=media)

That's it! Facebook Ads is now successfully configured as a source on your RudderStack dashboard.

RudderStack will start importing data from Facebook Ads as per the specified frequency. You can further connect this source to your data warehouse by clicking on **Connect Destinations** or **Add Destinations**, as shown:

![Connect Destinations](https://876606571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq5Ea6fHVg3dSxMCgyQ%2Fuploads%2Fgit-blob-24905686f4cfe2ee7f5ebeb80adb4cb34b4792ec%2Fscreen-shot-2021-02-08-at-1.24.32-pm.png?alt=media)

Use the **Connect Destinations** option if you have already configured a data warehouse destination in RudderStack. To configure a data warehouse destination from scratch, click on the **Add Destination** button.

## What Facebook Ads Data does RudderStack Import?

| **Property**         | **Table Name**         | **Description**                                                                                                                                                               |
| -------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Account Insights** | **`account_insights`** | This table contains insights, aggregated for the whole account. Insights include Total Impressions, CPP, CPC, Reach, and CPM.                                                 |
| **Campaigns**        | **`campaigns`**        | This table holds information information about your campaigns. The columns of this table include: `name`, `objective`, `account_id`, and`status`.                             |
| **AdSets**           | **`adsets`**           | This tables has information about your Ad Sets. The columns of this table are: `bid_amount`,`updated_time`,`campaign_id`,`daily_budget`,`lifetime_budget`, and `pacing_type`. |
| **Ads**              | **`ads`**              | This table contains information about your Facebook Ads.                                                                                                                      |
| **Ad Creatives**     | **`ad_creatives`**     | This table contains the creative content for your Facebook Ads account that you can use in your ads.                                                                          |

## FAQs

#### Is it possible to have multiple Cloud Extract sources writing to the same schema?

Yes, it is.

We have implemented a feature wherein RudderStack associates a table prefix for every Cloud Extract source writing to a warehouse schema. This way, multiple Cloud Extract sources can write to the same schema with different table prefixes.

## Contact Us

If you come across any issues while configuring Facebook Ads as a source on the RudderStack dashboard, please feel free to [contact us](mailto:%20docs@rudderstack.com). You can also start a conversation in our [Slack](https://rudderstack.com/join-rudderstack-slack-community) community; we will be happy to talk to you!
