January 14 2020
This week, we announced an update to our Developer Roadmap that outlines a plan requiring all apps to migrate to OAuth 2.0, process the signed_request parameter, and obtain an SSL certificate by October 1. We also added two frequently requested How-To guides.
Subscribing to comment threads in the Comments Box
We added the ability to subscribe and unsubscribe from specific comment threads in the Comments Box. If you are interested in a particular part of the conversation, just click the subscribe link, and you'll receive a notification when others reply on thread. Similarly, you can unsubscribe to stop the notifications.
Like Story Feedback now available in Insights
Last month we expanded the story size that is shown when a user Likes a page on your site. We've now added a "Like Story Feedback" dashboard to Insights for your website. This dashboard shows you engagement data such as how many users liked and commented on these stories:
Using this data you can work on generating more interesting stories to fuel the conversation around your content.
API access to Send button metrics
You can now query the Graph API and the Insights FQL table for metrics on Send button activity. When a user engages with the Send button, one or more of the following sequence of actions occurs: the user views the button, then clicks on it, the receiver then views the item in their Messages, and clicks on it. These actions correspond to the following metrics that can be requested via the Graph API or the FQL table:
Each of these metrics is aggregated based on a domain claimed by your application. The FQL Insights documentation contains further details and the list of all available metrics. Here is some example code to retrieve the number of Send button views for a domain for the last three days (the default, see docs for other options):
<?php $app_id = "YOUR_APP_ID"; $app_secret = "YOUR_APP_SECRET"; $app_domain = "YOUR_APP_DOMAIN"; // e.g. developers.facebook.com // First, get a valid access token for the app $token_url = "https://graph.facebook.com/oauth/access_token?" . "client_id=" . $app_id . "&client_secret=" . $app_secret . "&grant_type=client_credentials"; $app_access_token = file_get_contents($token_url); // Query the Graph API for the send views $graph_url="https://graph.facebook.com/insights/" . "domain_widget_send_views?" . "domain=" . $app_domain . "&" . $app_access_token; $response = file_get_contents($graph_url); // Use the results echo "<pre>"; print_r(json_decode($response)); echo "</pre>"; ?>
As part of Operation Developer Love, we continue to improve our documentation. This week we updated the Album reference documentation for the Graph API. We plan to update the other Graph API reference docs based on this "template", so please let us know in the comments what you think about it. We will be adding information about errors relevant to the Graph API soon.
Documentation activity for the past 7 days:
Bugzilla activity for the past 7 days:
Developer Forum activity for the past 7 days:
Zhen Fang, on the Developer Relations team, wants to see metrics of how many people sent this post to a friend with the Send button.