Facebook Social Walkthrough
  • 4 Minutes to read
  • Dark
  • PDF

Facebook Social Walkthrough

  • Dark
  • PDF

Article Summary

Currently Supported:
Marketing API version 14
Graph API version 15.


Each Facebook report is connected to one or more Facebook pages.

In order to view the list of pages you own, click the refresh button after adding your Facebook connection.

You can also leave the box empty in order to pull data for all the pages owned by your user.

In order to pull data from pages you do not own you need to manually add the relevant page_id.

The page_id can be found using the Facebook page URL. For example, The page_id for https://www.facebook.com/rivery.io is rivery.io
Select the Facebook page/s you want to pull data from.



The pages fields that data can be pulled from are only the fields that you can see in Facebook public pages, and not additional fields like: Best_page, Access_token and others.

Facebook Social reports in Rivery

Rivery currently offers 4 types of reports:

  • Choose Report type:


  1. Feed Report: Returns data on the selected Facebook page Feeds (Likes / Comments / Shares..).

    Data can be pulled from private pages that your Facebook account owns, or to any other Facebook pages that are set as Public. The data in public pages may contain less columns than asked, due to Facebook regulations and privacy settings of the pages.
    Do note that Facebook has a limit of 200 calls per hour per user for pages you don't own, exceeding this limit will result in errors.

    1. Insights - Page Returns data on the selected Facebook page insight metrics (Impressions / Clicks..). Data can be pulled only from private pages that your Facebook account owns.
      Note: The metrics also include the number of reactions from other pages that have shared the post. i.e if a page shares another pages post and likes to the shared post also results in likes being logged to the original for page insight metrics. So the number is expected to be greater than what's shown on the UI. The Feed Report should be used in order to get the metrics that are shown in the UI

    2. Insights - Post Returns data on the posts of the selected Facebook pages insight metrics (Impressions / Clicks..).

    3. Insights - Video

    Returns data on the videos of the selected Facebook pages insight metrics (Impressions / Clicks..).

    Video insights are calculated across pages.

    For example, if a video is posted on two pages you own, the insights you will receive will be aggregated.

    Feed Report: Select the metadata fields for the page
    You can leave the input box empty to pull all available fields.
    In the Feed reports section, select the fields you want to pull for each reporting level (Feed / Comments / Reactions..)

    fb social

    At the bottom of the page check the relevant boxes in order to include

    data of Tagged or Hidden posts.
    The feed report also inherently brings the total number of comments and reactions by reaction type (happy, sad, like etc') on the selected date range.

    Insights Reports

    1. Select pages

    2. Select metadata fields* on the report level. For example, the insights posts reports offer fields on the post level.

    3. Select metrics

    4. Select metrics period

    5. Some insights reports have an option for additional data in a checkbox at the bottom of the page. For example, insights posts report as an option to add all Promotable (dark) posts in addition to the regular posts.

    Metrics starting with page_* are for the page insights report

    Metrics starting with post_* are for the post insights report

    Metrics starting with post_video_* are for the posts video insights report

    The shares metrics is located as a field in the insights posts report
    *Restrictions on Post Fields:

    To extract post fields for a live video which ended you must have an admin role on that posts' page.

    Known fields that require admin role page: description, name, object_id, source and type


    Relevant to all insights reports.
    Select the metrics you wish to measure in the report (Impressions / Views / ..etc')

    Metrics period resolution

    The time frame for which your metrics will be calculated is referred to as the metrics period resolution.
    Choosing the Daily period for the "Impressions" metric, for example, will return daily results of impressions in the selected date range.

    This is applicable to all insights reports:

    Please note that some metrics may not work with the Metrics Period Resolution of your choice. Please see the Facebook Documentation Page for the metrics and their potential period value.

    Time Period

    Relevant for all type of Facebook Social Reports.

    image123.pngSelect the type of time period of the report.

    It can be a custom date range (as described in the picture above) or a defined time period shown in the pop-up list (for example Yesterday, last week etc.)

    Instructions if selecting ‘Date Range’:
    1. Select the start date and end date.

    2. Leave the end date empty in order to pull data until the moment

    the river runs.

    1. After each run of the river, the start date will be updated automatically with the end date, and the end date will be updated with the empty value. This enables the next run to pull data from the end of the previous run.

    2. Select the time zone offset. It will be relevant only if the end date is empty in order to find the moment of the river’s run according to the time zone.

    3. Days back - use this input to tell Rivery to pull data from the given days back before the given start date.

    4. The Start Date won't be advanced if a River run is unsuccessful.
      If you don't want this default setting, click More Options and check the box to advance the start date even if the River run is unsuccessful (Not recommended).

    Instructions if selecting any other value:


    Select the timezone offset in order to send the correct dates that consider that offset.

    Watch a video demo:

Was this article helpful?