> ## Documentation Index
> Fetch the complete documentation index at: https://www.domo.com/docs/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/)).

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](/docs/s/article/360043434413).

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](/docs/s/article/360042926274).

<table border="1" cellpadding="1" cellspacing="1">
  <thead>
    <tr>
      <th colspan="1" rowspan="1">
        <p />
      </th>

      <th colspan="1" rowspan="1">
        <p />
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td colspan="1" rowspan="1"><p><b>Primary Use Cases</b></p></td>
      <td 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 colspan="1" rowspan="1"><p><b>Primary Metrics</b></p></td>
      <td colspan="1" rowspan="1"><p>- Followers - Post likes - Trending posts - Reaction to posts - Audience demographics - Page ratings - Impressions - Views - Comments - Top post metrics over time</p></td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1"><p><b>Primary Company Roles</b></p></td>
      <td colspan="1" rowspan="1"><p>- Director of marketing - Social media manager - CMO - Sales and marketing teams</p></td>
    </tr>

    <tr>
      <td colspan="1" rowspan="1"><p><b>Average Implementation Time</b></p></td>
      <td 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 colspan="1" rowspan="1"><p><b>Ease of Use (on a 1-to-10 scale with 1 being easiest)</b></p></td>
      <td colspan="1" rowspan="1"><p>4</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](/docs/s/article/360043434413).

## 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](/docs/s/article/360042926274).

## 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](/docs/s/article/360042926054).

<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">
  <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 class="zebra-striped bordered"><tbody><tr><th><b>Report</b></th><th><b>Description</b></th></tr><tr><td>Complete Page Insights</td><td>Returns all available insights for selected pages under <strong>Accounts</strong>.</td></tr><tr><td>Page Fans (Deprecated)</td><td>Returns users who liked the selected pages.</td></tr><tr><td>Page Fans by City (Deprecated)</td><td>Returns page fans grouped by city.</td></tr><tr><td>Page Fans by Country (Deprecated)</td><td>Returns page fans grouped by country.</td></tr><tr><td>Page Fans Online (Deprecated)</td><td>Returns page fans grouped by online activity hours.</td></tr><tr><td>Page Feed</td><td>Returns posts from selected pages, including user-generated content.</td></tr><tr><td>Page Follows</td><td>Returns users who follow the selected pages.</td></tr><tr><td>Page Follows By City</td><td>Returns followers grouped by city.</td></tr><tr><td>Page Follows By Country</td><td>Returns followers grouped by country.</td></tr><tr><td>Page Impressions by Age, Gender (Deprecated)</td><td>Returns impressions grouped by age and gender.</td></tr><tr><td>Page Impressions by City (Deprecated)</td><td>Returns impressions grouped by city.</td></tr><tr><td>Page Impressions by Country (Deprecated)</td><td>Returns impressions grouped by country.</td></tr><tr><td>Page Impressions by View Frequency (Deprecated)</td><td>Returns impressions grouped by view frequency.</td></tr><tr><td>Page Impressions Details</td><td>Returns metrics for content views and interactions.</td></tr><tr><td>Page Info</td><td>Returns details for selected pages.</td></tr><tr><td>Page Interactions (Deprecated)</td><td>Returns user interaction metrics for selected pages.</td></tr><tr><td>Page Post Daily Metrics</td><td>Returns daily metrics for page posts.</td></tr><tr><td>Page Post Lifetime Metrics</td><td>Returns lifetime metrics for page posts.</td></tr><tr><td>Page Posts</td><td>Returns posts from selected pages.</td></tr></tbody></table> </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></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](/docs/s/article/360042926274).

## FAQ

<AccordionGroup>
  <Accordion title="What is the difference between the Facebook and Facebook Advanced connectors?">
    The Facebook Advanced connector provides more reports than the Facebook connector. The Facebook connector's reports are limited to deal directly with pages. Reports about the user, domains, application monitoring and public page information are in the Advanced connector.

    The Facebook connector is also limited to return information about the last 30 days, while the Advanced connector allows the user to query data for any date range.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    Facebook limits the number of calls that can be made each hour for each user and page. As long as you don't run the DataSet too often, the connector manages this for you.
  </Accordion>
</AccordionGroup>

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