> ## 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 Advanced Connector

## Intro

Domo's Facebook Advanced 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 Advanced version of the connector includes more report types and configuration parameters. It also allows you to retrieve more than 30 days worth of Facebook data. To learn about the simplified version of the connector, see [Facebook Connector](https://domo-support.domo.com/s/article/360043434433?language=en_US "Facebook Connector").

You connect to your Facebook account in the Data Center. This topic discusses the fields and menus that are specific to the Facebook Advanced 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 class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Retrieving social media metrics, tracking content, and viewing your Facebook page performance. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Impressions </p></li><li><p> Engagement </p></li><li><p> Comments </p></li><li><p> Likes </p></li><li><p> Shares </p></li><li><p> Reactions </p></li><li><p> Page fans </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> CMO </p></li><li><p> Director of marketing </p></li><li><p> Marketing analyst </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Usually less than an hour, but could take much longer to pull the desired data. </p></td></tr><tr><td class="mt-noheading" 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" colspan="1" rowspan="1"><p> 4 </p></td></tr></tbody></table>

## 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 in 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 Advanced 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 Advanced accounts in Domo) to open the Facebook OAuth screen where you can enter your Facebook credentials. Once you have entered valid Facebook credentials, you can use the same account any time you go to create a new Facebook Advanced 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. If you have connected Facebook to Domo in the past your pop-up bro screen will look slightly different. By clicking the button **Edit Settings** on the Facebook OAuth popup. This option allows users to select the specific pages they want Domo to access.
</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 Advanced 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> Account Information </p></td><td colspan="1" rowspan="1"><p> Returns information about the authenticated user, such as first and last name, gender, Facebook URL, location, time zone, etc. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Application Insights (deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information on insights for specified application IDs. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Complete Domain Insights </p></td><td colspan="1" rowspan="1"><p> Returns domain insights for the specified domain IDs. </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> Complete Page Post Insights </p></td><td colspan="1" rowspan="1"><p> Returns a full list of metrics for the posts on the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Instant Article Aggregated Insights </p></td><td colspan="1" rowspan="1"><p> Returns information about all instant articles on the pages selected under <b> Accounts </b>, aggregated together. </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 Impression 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 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 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 information about how many users have interacted with any content associated with 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 Comments </p></td><td colspan="1" rowspan="1"><p> Returns a list of comments from Posts from 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 InsightsResult metrics. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Post Lifetime Metrics </p></td><td colspan="1" rowspan="1"><p> Returns information about views/impressions that each post in selected pages has received, and where those views came from. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Ratings </p></td><td colspan="1" rowspan="1"><p> Returns details about ratings that the selected pages have received. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Post Video Daily Metrics </p></td><td colspan="1" rowspan="1"><p> Returns information about the number of people that watch or interacted with videos on the selected page(s), broken down by day. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page Post Video Metrics </p></td><td colspan="1" rowspan="1"><p> Returns metrics related to the number of users who watched or interacted with videos on the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Public Page Info </p></td><td colspan="1" rowspan="1"><p> Returns publicly available information for pages whose IDs are entered in the <b> Page IDs </b> field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Public Page Insights (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns publicly available insight metrics for pages whose IDs are entered in the <b> Page IDs </b> field. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Public Page Posts </p></td><td colspan="1" rowspan="1"><p> Returns information about posts on the public pages specified by Page IDs. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Published Posts </p></td><td colspan="1" rowspan="1"><p> Returns information about everything you have published to the selected Pages. This includes status updates, videos, links, etc. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Referrals from Page (Deprecated) </p></td><td colspan="1" rowspan="1"><p> Returns information about the number of users who followed links on the pages selected under <b> Accounts </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Video Crosspost Information </p></td><td colspan="1" rowspan="1"><p> Returns about crossposting of videos posted by the pages selected under <b> Accounts </b> during the specified time range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Video Insights </p></td><td colspan="1" rowspan="1"><p> Returns lifetime insight metrics for videos posted by the pages selected under <b> Accounts </b> during the specified time range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Videos </p></td><td colspan="1" rowspan="1"><p> Returns a list of videos posted by the pages selected under <b> Accounts </b> during the specified time range. </p></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> Start Date </p></td><td colspan="1" rowspan="1"><p> Enter the start date for the report using the format <span class="mt-font-courier-new"> yyyy-MM-dd </span> (for example, <span class="mt-font-courier-new"> 2015-01-15 </span> ). </p><p> You can also use the keywords <span class="mt-font-courier-new"> today </span> or <span class="mt-font-courier-new"> yesterday </span> to return data for those days. If you want, you can specify an offset like <span class="mt-font-courier-new"> yesterday-3 </span>. This would set the start date to 3 days in the past. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Enter the end date for the report using the format <span class="mt-font-courier-new"> yyyy-MM-dd </span> (for example, <span class="mt-font-courier-new"> 2015-01-15 </span> ). </p><p> You can also use the keywords <span class="mt-font-courier-new"> today </span> or <span class="mt-font-courier-new"> yesterday </span> to return data for those days. If you want, you can specify an offset like <span class="mt-font-courier-new"> yesterday-3 </span>. This would set the end date to 3 days in the past. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date Should Be Inclusive? </p></td><td colspan="1" rowspan="1"><p> Select <b> Yes </b> if you want data to be retrieved for all days up to and including the specified end date. </p><p> Select <b> No </b> if you want data to be retrieved for all days up to but not including the specified end date. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Backfill </p></td><td colspan="1" rowspan="1"><p> Enter the number of days before the start date that should be backfilled. This action will be performed only the first time the DataSet runs. On subsequent runs, the specified <b> Start Date </b> to <b> End Date </b> range is used. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Page IDs </p></td><td colspan="1" rowspan="1"><p> Enter a comma-separated list of page IDs. </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><tr><td colspan="1" rowspan="1"><p> Application ID </p></td><td colspan="1" rowspan="1"><p> Enter the ID of the user-managed application you want to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Domain IDs </p></td><td colspan="1" rowspan="1"><p> Enter a comma-separated list of Domain IDs to retrieve information for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Insight Metrics </p></td><td colspan="1" rowspan="1"><p> Select all metrics you want to retrieve information for. If you select none, information is retrieved for all of them. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Skip Errors </p></td><td colspan="1" rowspan="1"><p> If you select <b> True </b>, pages that return errors are silently skipped, and all other Pages will be included in the results. If you select <b> False </b>, the DataSet fails with an error if any page returns an error. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Instant Article Metric </p></td><td colspan="1" rowspan="1"><p> Select an Instant Article Metric to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Fields </p></td><td colspan="1" rowspan="1"><p> Select all fields you want to retrieve data for. If you don't select any fields, a default list of fields is retrieved. </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](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## FAQs

## Troubleshooting

* 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 time frame that you are trying to pull.
* Be aware that when comparing page statistics in your Facebook Advanced 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.
