Facebook Insights Data

On this Page

Snap type:

Read


Description:

This Snap retrieves Insights data for a page based on the Insight page ID. The Insights data can be fetched based on the selected duration and the metric type. The start and ending dates can be specified using the Since time and Until time fields. The user of this Snap should be the admin of that Facebook page.

  • Expected upstream Snaps: Not applicable.
  • Expected downstream Snaps: JSON Formatter followed by File Writer.
  • Expected input: Insight page IDSince timeUntil time
  • Expected output: The output data for a specified page and its associated Insight page ID with a specified date range (Since time and Until time) and a selected operation (Metric type and Duration).


Prerequisites:

[None]


Support and limitations:Works in Ultra Task Pipelines.
Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring Facebook Accounts for information on setting up this type of account.


Views:
InputThis Snap has at most one document input view.
OutputThis Snap has exactly one document output view. The output data contains the values for: Organic reach, Paid reach, Impression reach, Base growth, reach, Followers lifetime, Reach by post, Engagement index, and Viral reach. 
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label

required


Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Metric type
required


Required. The Metric type for which Insights data is needed. The options available include:

  • Total

  • Paid

  • Unpaid

Default value: Paid


Insight page ID

Required. The page ID for which Insights data has to be fetched. You can find this ID by selecting the number within your URL when viewing your page.


Duration

Required. The time duration of Insights data.
Default value: Days_28


Since time

The date specified (in the format of: yyyy-mm-dd) that marks the beginning of the period of the data to be fetched.


Until time

The date specified (in the format of: yyyy-mm-dd) that marks the end of the period of the data to be fetched.


Snap Execution

Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.


Example


The example assumes that you have configured & authorized a valid Facebook account (see Configuring Facebook Accounts ) to be used with this Snap. The following Insights Data Snap retrieves all insights for the last 28 days from a Facebook page with a page ID, 401484913294377:

After a successful validation of the Snap, you will see a data preview that shows the Facebook page insights as shown below: 


 

Snap Pack History

 Click to view/expand
ReleaseSnap Pack VersionDateTypeUpdates
4.27main12833 StableUpgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25main9554 StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
 
Stable

Upgraded with the latest SnapLogic Platform release.

4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21snapsmrc542
 
StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19snaprsmrc528
 
StableUpgraded with the latest SnapLogic Platform release.
4.18snapsmrc523
 
StableUpgraded with the latest SnapLogic Platform release.
4.17ALL7402
 
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
 
Stable

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16snapsmrc508
 
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
 
StableUpgraded with the latest SnapLogic Platform release.
4.14snapsmrc490
 
StableUpgraded with the latest SnapLogic Platform release.
4.13

snapsmrc486

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.12

snapsmrc480

 
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
 
StableUpgraded with the latest SnapLogic Platform release.
4.10

snapsmrc414

 
StableUpgraded with the latest SnapLogic Platform release.
4.9

snapsmrc405

 
Stable

Upgraded with the latest SnapLogic Platform release.

4.8

snapsmrc398

 
StableUpgraded with the latest SnapLogic Platform release.
4.7

snapsmrc382

 
StableUpgraded with the latest SnapLogic Platform release.
4.6

snapsmrc362

 
StableUpgraded with the latest SnapLogic Platform release.
4.5.1

rcmsf231

 
StableUpgraded with the latest SnapLogic Platform release.
4.5rcmsf231 StableUpgraded with the latest SnapLogic Platform release.
4.3.2NA Latest

Resolved an issue with Facebook Query where the error was not routing to error view for "com.restfb.exception.FacebookJsonMappingException".

4.2.2NA

  • Snap Pack updated to work with the latest Facebook API.
  • Deprecated: FetchConnections Snap and UserDetails Snap are no longer supported in the current Facebook API.
  • Search Snap: Post is no longer a supported object type for search.
January 2014NA

Initial release of this Snap Pack with Fetch Connections, Insights Data, Page Data, Query, Search.