> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Connector

## Intro

Domo's Facebook connector can combine Facebook insights with data from any other source—finance analytics, CRM software, etc.—to target campaigns with unparalleled precision. Use this connector to retrieve data about posts, page fans, referrals, account information, and the like. To learn more about the Facebook API, visit their page ([https://developers.facebook.com](https://developers.facebook.com/ "https://developers.facebook.com") ).

This version of the Facebook connector allows you to retrieve only 30 days worth of Facebook data. The Advanced version allows you to retrieve more than 30 days worth of data and also includes more report types and configuration parameters. To learn about the Advanced version of the connector, see [Facebook Advanced Connector](https://domo-support.domo.com/s/article/360043434413?language=en_US "Facebook Advanced Connector").

The Facebook connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

You connect to your Facebook account in the Data Center. This topic discusses the fields and menus that are specific to the Facebook connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

<table border="1" class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p> This connector lets you retrieve data about Facebook impressions, followers, likes, and sentiment toward your company. </p></td></tr><tr><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><ul><li><p> Followers </p></li><li><p> Post likes </p></li><li><p> Trending posts </p></li><li><p> Reaction to posts </p></li><li><p> Audience demographics </p></li><li><p> Page ratings </p></li><li><p> Impressions </p></li><li><p> Views </p></li><li><p> Comments </p></li><li><p> Top post metrics over time </p></li></ul></td></tr><tr><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><ul><li><p> Director of marketing </p></li><li><p> Social media manager </p></li><li><p> CMO </p></li><li><p> Sales and marketing teams </p></li></ul></td></tr><tr><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p> Typically less than an hour, but it may take longer to get the right data in. </p></td></tr><tr><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading wysiwyg-text-align-left" colspan="1" rowspan="1"><p> 4 <span /></p></td></tr></tbody></table>

## Best Practices

* Multiple accounts can be selected for reports. This is useful for large organizations with multiple locations or divisions.
* Reports allow for custom date ranges to be selected.
* This connector only provides 30 days worth of data. If you want to retrieve more data, use the [Facebook Advanced connector](https://domo-support.domo.com/s/article/360043434413?language=en_US "Facebook Advanced Connector").

## Prerequisites

To connect to your Facebook account and create a DataSet, you must have the following:

* Your Facebook username or your telephone number
* Your Facebook password

## Connecting to Your Facebook Account

This section enumerates the options in the Credentials and Details panes on the Facebook Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet,** are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Credentials Pane

The Domo Facebook connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing Facebook accounts in Domo) to open the Facebook OAuth screen where you can enter your Facebook username and password. Once you have entered valid Facebook credentials, you can use the same account any time you go to create a new Facebook DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector/Adapter Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector/Adapter Accounts").

<Note>
  **Note:** If you are already logged into Facebook when you connect in Domo, you are authenticated automatically when you click **Add account**. If you want to connect to an account that is different from the one you are logged into, you must first log out of Facebook.
</Note>

## Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Facebook report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p><b> Report Name </b></p></td><td colspan="1" rowspan="1"><p><b> Description </b></p></td></tr><tr><td colspan="1" rowspan="1"><p> Complete Page Insights </p></td><td colspan="1" rowspan="1"><p> Returns a full list of available insights for pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Fans </p></td><td colspan="1" rowspan="1"><p> Returns information on users who have “liked” the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Fans by City </p></td><td colspan="1" rowspan="1"><p> Returns information on users who have “liked” the pages selected under <b> Accounts </b>, broken down by city. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Fans by Country </p></td><td colspan="1" rowspan="1"><p> Returns information on users who have “liked” the pages selected under <b> Accounts </b>, broken down by country. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Fans Online (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information on users who have “liked” the pages selected under <b> Accounts </b>, broken down by the hours in which they are online. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Feed </p></td><td colspan="1" rowspan="1"><p> Returns a list of Posts on the pages selected under <b> Accounts </b>. This includes Posts created by the Page, and those created by other users. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Impressions by Age, Gender (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information on users that have seen any content associated with the pages selected under <b> Accounts </b>, broken down by age and gender. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Impressions by City (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information on users that have seen any content associated with the pages selected under <b> Accounts </b>, broken down by city. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Impressions by Country (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information on users that have seen any content associated with the pages selected under <b> Accounts </b>, broken down by country. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Impressions by View Frequency (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information on users that have seen any content associated with the pages selected under <b> Accounts </b>, broken down by the number of times they have seen the content. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Impressions Details </p></td><td colspan="1" rowspan="1"><p> Returns metrics relating to how many people saw or interacted with the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Info </p></td><td colspan="1" rowspan="1"><p> Returns information about pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Interactions (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns metrics relating to how many users interacted with certain parts of the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Posts </p></td><td colspan="1" rowspan="1"><p> Returns information about posts on the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Post Daily Metrics </p></td><td colspan="1" rowspan="1"><p> Returns a list of Daily Insights Result metrics. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Post Lifetime Metrics </p></td><td colspan="1" rowspan="1"><p> Returns the lifetime metrics related to page posts selected under <b> Accounts </b>. </p></td></tr></tbody></table><p /></td></tr><tr><td colspan="1" rowspan="1"><p> Accounts </p></td><td colspan="1" rowspan="1"><p> Check the box for each page you want to pull data from. You can select all attributes for the entity by clicking <b> Select All </b> or clear all selected pages by clicking <b> Clear All </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Period </p></td><td colspan="1" rowspan="1"><p> Select the time period for which insight metrics will be shown. </p><div /></td></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## FAQs

## Troubleshooting

* Make sure your authentication remains valid.
* Review the configuration to make sure that all required items have been selected.
* Review the connector history for error messages.
* In rare cases, you may be requesting too much information and reaching API limitations or timeouts. If this is the case, you can review the history of the connector run to see the error message and duration. If this is the case, you can reduce the number of accounts that are being pulled, choose a smaller number of metrics for the report that you are pulling, or reduce the timeframe that you are trying to pull.
* Be aware that when comparing page statistics in your Facebook DataSet to those found in Facebook’s Insights UI, the dates are generally off by 1 day. For example, if the Facebook UI shows 1000 views for a page on March 3, the connector will report 1000 views with a date timestamp of March 4. This is because the API returns data for a time period that *ends* at the timestamp specified. In this example, there were 1000 views during the day that ended at midnight on March 4—in other words, March 3. The Insights UI takes this into account, and reports the 1000 views as having happened on March 3.