Skip to content

goes-funky/tap-facebook-pages

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Welcome to the Facebook Pages Singer Tap!

Accepted Config Options

{
  "start_date": "2020-03-04T01:55:24Z",
  "page_ids": [
    "id_1",
    "id_2"
  ],
  "access_token": "access_token"
}

Source Authentication and Authorization

Find page ids following the guide here https://www.facebook.com/help/1503421039731588

Generate a user access tokens following the guide here https://developers.facebook.com/docs/facebook-login/access-tokens/#usertokens

This Singer-compliant tap was created using the Singer SDK.

Consumes the Facebook Pages API documented here https://developers.facebook.com/docs/pages/

Supported streams:

  • page -> Information about the pages identified by the page_ids set in the config file.

  • posts -> Retrieve all posts of the pages specified in the config files

  • post_tagged_profile -> Retrieve the names and the ids of the profiles which have been tagged in each post

  • post_attachments -> Retrieve all attachment informations for post attachments

  • page_insight_CTA_clicks -> page insights for:

    • page_total_actions
    • page_cta_clicks_logged_in_total
    • page_cta_clicks_logged_in_unique
    • page_cta_clicks_by_site_logged_in_unique
    • page_cta_clicks_by_age_gender_logged_in_unique
    • page_cta_clicks_logged_in_by_country_unique
    • page_cta_clicks_logged_in_by_city_unique
  • page_insight_call_phone_clicks -> page insights for:

    • page_call_phone_clicks_logged_in_unique
    • page_call_phone_clicks_by_age_gender_logged_in_unique
    • page_call_phone_clicks_logged_in_by_country_unique
    • page_call_phone_clicks_logged_in_by_city_unique
    • page_call_phone_clicks_by_site_logged_in_unique
  • page_insight_get_directions_clicks -> page insights for:

    • page_get_directions_clicks_logged_in_unique
    • page_get_directions_clicks_by_age_gender_logged_in_unique
    • page_get_directions_clicks_logged_in_by_country_unique
    • page_get_directions_clicks_logged_in_by_city_unique
    • page_get_directions_clicks_by_site_logged_in_unique
  • page_insight_website_clicks -> page insights for:

    • page_website_clicks_logged_in_unique
    • page_website_clicks_by_age_gender_logged_in_unique
    • page_website_clicks_logged_in_by_country_unique
    • page_website_clicks_logged_in_by_city_unique
    • page_website_clicks_by_site_logged_in_unique
  • page_insight_engagement -> page insights for:

    • page_engaged_users
    • page_post_engagements
  • page_insight_consumptions -> page insights for:

    • page_consumptions
    • page_consumptions_unique
    • page_consumptions_by_consumption_type
    • page_consumptions_by_consumption_type_unique
  • page_insight_places_checkin -> page insights for:

    • page_places_checkin_total
    • page_places_checkin_total_unique
    • page_places_checkin_mobile
    • page_places_checkin_mobile_unique
    • page_places_checkins_by_age_gender
    • page_places_checkins_by_locale
    • page_places_checkins_by_country
  • page_insight_feedback -> page insights for:

    • page_negative_feedback
    • page_negative_feedback_unique
    • page_negative_feedback_by_type
    • page_negative_feedback_by_type_unique
    • page_positive_feedback_by_type
    • page_positive_feedback_by_type_unique
  • page_insight_fans -> page insights for:

    • page_fans_online
    • page_fans_online_per_day
    • page_fan_adds_by_paid_non_paid_unique
  • page_insight_impressions -> page insights for:

    • page_impressions
    • page_impressions_unique
    • page_impressions_paid
    • page_impressions_paid_unique
    • page_impressions_organic_v2
    • page_impressions_organic_unique_v2
  • page_insight_impressions_2 -> page insights for:

    • page_impressions_viral
    • page_impressions_viral_unique
    • page_impressions_nonviral
    • page_impressions_nonviral_unique
    • page_impressions_frequency_distribution
    • page_impressions_viral_frequency_distribution
  • page_insight_impressions_by_category -> page insights for:

    • page_impressions_by_story_type
    • page_impressions_by_story_type_unique
    • page_impressions_by_age_gender_unique
  • page_insight_impressions_by_location -> page insights for:

    • page_impressions_by_city_unique
    • page_impressions_by_country_unique
    • page_impressions_by_locale_unique
  • page_insight_post -> page insights for:

    • page_posts_impressions
    • page_posts_impressions_unique
    • page_posts_impressions_paid
    • page_posts_impressions_paid_unique
    • page_posts_impressions_organic
    • page_posts_impressions_organic_unique
    • page_posts_served_impressions_organic_unique
  • page_insight_post_2 -> page insights for:

    • page_posts_impressions_viral
    • page_posts_impressions_viral_unique
    • page_posts_impressions_nonviral
    • page_posts_impressions_nonviral_unique
    • page_posts_impressions_frequency_distribution
  • page_insight_reactions -> page insights for:

    • page_actions_post_reactions_like_total
    • page_actions_post_reactions_love_total
    • page_actions_post_reactions_wow_total
    • page_actions_post_reactions_haha_total
    • page_actions_post_reactions_sorry_total
    • page_actions_post_reactions_anger_total
    • page_actions_post_reactions_total
  • page_insight_demographics -> page insights for:

    • page_fans
    • page_fans_locale
    • page_fans_city
    • page_fans_country
    • page_fans_gender_age
    • page_fans_by_unlike_source_unique
  • page_insight_demographics_2 -> page insights for:

    • page_fan_adds
    • page_fan_adds_unique
    • page_fans_by_like_source
    • page_fans_by_like_source_unique
    • page_fan_removes
    • page_fan_removes_unique
  • page_insight_video_views -> page insights for:

    • page_video_views
    • page_video_views_paid
    • page_video_views_organic
    • page_video_views_by_paid_non_paid
  • page_insight_video_views_2 -> page insights for:

    • page_video_views_autoplayed
    • page_video_views_click_to_play
    • page_video_views_unique
    • page_video_repeat_views
    • page_video_view_time
  • page_insight_video_complete_views -> page insights for:

    • page_video_complete_views_30s
    • page_video_complete_views_30s_paid
    • page_video_complete_views_30s_organic
    • page_video_complete_views_30s_autoplayed
    • page_video_complete_views_30s_click_to_play
    • page_video_complete_views_30s_unique
    • page_video_complete_views_30s_repeat_views
    • post_video_complete_views_30s_autoplayed
    • post_video_complete_views_30s_clicked_to_play
    • post_video_complete_views_30s_organic
    • post_video_complete_views_30s_paid
    • post_video_complete_views_30s_unique
  • page_insight_video_10s_views -> page insights for:

    • page_video_views_10s
    • page_video_views_10s_paid
    • page_video_views_10s_organic
    • page_video_views_10s_autoplayed
    • page_video_views_10s_click_to_play
    • page_video_views_10s_unique
    • page_video_views_10s_repeat
  • page_insight_views -> page insights for:

    • page_views_total
    • page_views_logout
    • page_views_logged_in_total
    • page_views_logged_in_unique
    • page_views_external_referrals
  • page_insight_views_by_category -> page insights for:

    • page_views_by_profile_tab_total
    • page_views_by_profile_tab_logged_in_unique
    • page_views_by_internal_referer_logged_in_unique
    • page_views_by_site_logged_in_unique
    • page_views_by_age_gender_logged_in_unique
    • page_views_by_referers_logged_in_unique
  • page_insight_video_ad_break -> page insights for:

    • page_daily_video_ad_break_ad_impressions_by_crosspost_status
    • page_daily_video_ad_break_cpm_by_crosspost_status
    • page_daily_video_ad_break_earnings_by_crosspost_status
  • post_insight_engagement -> post insights for:

    • post_engaged_users
    • post_negative_feedback
    • post_negative_feedback_unique
    • post_negative_feedback_by_type
    • post_negative_feedback_by_type_unique
    • post_engaged_fan
    • post_clicks
    • post_clicks_unique
    • post_clicks_by_type
    • post_clicks_by_type_unique
  • post_insight_impressions -> post insights for:

    • post_impressions
    • post_impressions_unique
    • post_impressions_paid
    • post_impressions_paid_unique
    • post_impressions_fan
    • post_impressions_fan_unique
    • post_impressions_fan_paid
    • post_impressions_fan_paid_unique
    • post_impressions_organic
    • post_impressions_organic_unique
    • post_impressions_viral
    • post_impressions_viral_unique
    • post_impressions_nonviral
    • post_impressions_nonviral_unique
    • post_impressions_by_story_type
    • post_impressions_by_story_type_unique
  • post_insight_reactions -> post insights for:

    • post_reactions_like_total
    • post_reactions_love_total
    • post_reactions_wow_total
    • post_reactions_haha_total
    • post_reactions_sorry_total
    • post_reactions_anger_total
    • post_reactions_by_type_total
  • post_insight_video -> post insights for:

    • post_video_avg_time_watched
    • post_video_retention_graph
    • post_video_retention_graph_clicked_to_play
    • post_video_retention_graph_autoplayed
    • post_video_length
  • post_insight_video_views -> post insights for:

    • post_video_views_organic
    • post_video_views_organic_unique
    • post_video_views_paid
    • post_video_views_paid_unique
    • post_video_views
    • post_video_views_unique
    • post_video_views_autoplayed
    • post_video_views_clicked_to_play
    • post_video_views_sound_on
    • post_video_view_time
    • post_video_view_time_organic
  • post_insight_video_complete_views -> post insights for:

    • post_video_complete_views_organic
    • post_video_complete_views_organic_unique
    • post_video_complete_views_paid
    • post_video_complete_views_paid_unique
  • post_insight_video_by_sec -> post insights for:

    • post_video_views_15s
    • post_video_views_60s_excludes_shorter
    • post_video_views_10s
    • post_video_views_10s_unique
    • post_video_views_10s_autoplayed
    • post_video_views_10s_clicked_to_play
    • post_video_views_10s_organic
    • post_video_views_10s_paid
    • post_video_views_10s_sound_on
  • post_insight_video_by_category -> post insights for:

    • post_video_view_time_by_age_bucket_and_gender
    • post_video_view_time_by_region_id
    • post_video_views_by_distribution_type
    • post_video_view_time_by_distribution_type
    • post_video_view_time_by_country_id
  • post_insight_activity -> post insights for:

    • post_activity
    • post_activity_unique
    • post_activity_by_action_type
    • post_activity_by_action_type_unique
  • post_insight_video_ad_break -> post insights for:

    • post_video_ad_break_ad_impressions
    • post_video_ad_break_earnings
    • post_video_ad_break_ad_cpm

Releases

No releases published

Packages

No packages published

Languages