> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Facebook Page Organic data source to Adriel: authorize a Facebook account, select a Page, and import organic page and post metrics.

Facebook Page Organic surfaces page-level and post-level organic performance for a connected Facebook Page through the Meta Graph API. Connecting it brings reach, engagement, reactions, video plays, story metrics, follower growth, and audience demographic breakdowns into Adriel dashboards across feed posts, reels, videos, and stories.

## Before you connect

The following are required:

* A Facebook Page.
* A Facebook account with **admin** access on that Page. If the account lacks admin access, ask a Page admin to grant the appropriate role first.
* A Meta Business account linked to the Page — the OAuth flow requests the business-management scope.
* For ad-attributed metrics on the same Page, the marketing-tier scopes must be granted at connection time.

## Connect Facebook Page Organic

<Steps>
  <Step title="Authorize a Facebook account">
    On the **Data Sources** page, search for **Facebook Page Organic** and select it. Log in to Facebook in the pop-up window, then click **OK** to allow access. The base tier covers page and post insights. The optional marketing tier additionally requests the ad scopes needed to expose ad-attributed Page metrics. Meta shows the exact scope list on the consent screen.
  </Step>

  <Step title="Select the Page">
    On the data source settings, choose the **Page** to connect from the dropdown list. Each data source represents one Page — connect additional Pages as separate data sources under the same OAuth grant.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial sync runs in the background and can take up to one business day. Lifetime metrics begin accumulating from the connection date forward; the initial post backfill covers up to 1098 days, and the daily-page backfill covers up to 90 days.
  </Step>
</Steps>

## What gets imported

The connector imports page-level and post-level organic metrics at daily granularity via the Meta Graph API, bucketed in the Page timezone: reach, engagement, reactions, video plays, story metrics, follower growth, and audience demographic breakdowns by age, country, city, and gender. Raw impression metrics were deprecated by Meta on 2025-11-15 and are no longer available; reach is calculated at parse time from the remaining endpoints.

For the complete list of metrics, breakdowns, and refresh behavior, see the [Facebook Page Organic data reference](/data-sources/a-f/facebook-page-organic/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A Page is not listed during selection">
    The authorizing account does not have admin access on the Page, or the Page is not linked to a Business Manager. Have a Business admin grant the appropriate role or link the Page, then reconnect.
  </Accordion>

  <Accordion title="Impression metrics are missing from the picker">
    Meta deprecated raw impression metrics on 2025-11-15. Use reach and the page video-views metrics to track exposure instead.
  </Accordion>

  <Accordion title="Ad-attributed metrics are not appearing">
    The marketing-tier scopes were not granted at connection time. Reconnect the data source and approve the marketing scopes when prompted.
  </Accordion>

  <Accordion title="Multiple Pages need to be connected">
    Each data source represents one Page. Add a separate data source per Page — the OAuth grant from the first connection can be reused for subsequent Pages.
  </Accordion>

  <Accordion title="Post media views show no data before September 2024">
    The post media-views metrics only return data for posts created on or after 2024-09-22. This is a Meta API constraint, not a connector behavior.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Facebook Page Organic data reference" href="/data-sources/a-f/facebook-page-organic/data-reference">
    Metrics, breakdowns, and refresh behavior for Facebook Page Organic.
  </Card>

  <Card title="Facebook Page Organic FAQs" href="/data-sources/a-f/facebook-page-organic/faqs">
    Common questions and expected behaviors for the Facebook Page Organic data source.
  </Card>

  <Card title="How to connect Facebook Page Public" href="/data-sources/a-f/facebook-page-public/how-to-connect">
    Connect publicly available metrics for any Facebook Page.
  </Card>

  <Card title="How to connect Instagram Organic" href="/data-sources/g-n/instagram-organic/how-to-connect">
    Connect owned Instagram account analytics.
  </Card>

  <Card title="How to connect Meta Ads" href="/data-sources/g-n/meta-ads/how-to-connect">
    Connect paid Facebook and Instagram campaigns.
  </Card>
</CardGroup>