https://github.com/robdwaller/fableau
A Tableau Web Data Connector for Facebook Pages
https://github.com/robdwaller/fableau
facebook facebook-graph-api facebook-page javascript tableau tableau-connector tableau-desktop web-data-connector
Last synced: about 1 year ago
JSON representation
A Tableau Web Data Connector for Facebook Pages
- Host: GitHub
- URL: https://github.com/robdwaller/fableau
- Owner: RobDWaller
- License: mit
- Created: 2017-05-27T15:59:33.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-09-04T06:18:26.000Z (almost 8 years ago)
- Last Synced: 2025-02-13T12:33:06.849Z (over 1 year ago)
- Topics: facebook, facebook-graph-api, facebook-page, javascript, tableau, tableau-connector, tableau-desktop, web-data-connector
- Language: JavaScript
- Homepage: https://fableau.io
- Size: 137 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [Fableau](http://fableau.io) (Beta)
[](https://travis-ci.org/RobDWaller/fableau) [](https://codecov.io/gh/RobDWaller/fableau) [](https://codeclimate.com/github/RobDWaller/fableau/maintainability)
A Tableau Web Data Connector for Facebook that allows you to pull your Facebook post and
page metrics data into Tableau.
The WDC is currently in alpha and requires further testing and tidy up.
You can use this code to create your own Web Data Connector however you can use
the connector itself at [Fableau.io](http://fableau.io)
## End Points
The Web Data Connector pulls data from the following Facebook Graph API end points.
```
//Post Meta Data
https://graph.facebook.com/{page-id}/posts?fields=created_time,message,id,link,type&access_token={access-token}
//Post Metric Data
https://graph.facebook.com/{page-id}/posts?fields=insights.metric(post_impressions,post_impressions_unique,post_impressions_paid,post_impressions_paid_unique,post_reactions_like_total,post_reactions_love_total,post_reactions_wow_total,post_reactions_haha_total,post_reactions_sorry_total,post_reactions_anger_total)&access_token={access-token}
//Page Meta Data
https://graph.facebook.com/{page-id}?fields=link,name,category,about&access_token={access-token}
//Page Metric Data
https://graph.facebook.com/{page-id}/insights/page_impressions,page_impressions_unique,page_impressions_paid,page_impressions_organic,page_engaged_users,page_consumptions,page_consumptions_unique,page_negative_feedback,page_negative_feedback_unique,page_fan_adds_unique,page_views_total,page_views_logged_in_unique,page_posts_impressions,page_posts_impressions_unique,page_posts_impressions_paid,page_posts_impressions_organic,page_post_engagements,page_video_views?access_token={access-token}&since={date}&until=${date}
```
## Notes
This Web Data Connector only allows you to take single snapshots of data from
Facebook. You cannot use it to auto refresh on Tableau Server as this WDC only
stores short term access tokens. This is because the WDC only makes use of
JavaScript which is client based code and Facebook advise against asking for a
long term access token via client code.
For more information on this issue please see the [Facebook documentation](https://developers.facebook.com/docs/facebook-login/access-tokens).
It is relatively simple to solve this problem using server based code such as
PHP, Python or NodeJS. We have no plans to extend this Web Data Connector to solve
this problem at this time.
## License
MIT
## Author
[@RobDWaller](https://twitter.com/RobDWaller)