Insights for Crossposted Videos
Insights for Crossposted Videos
Crossposted Videos gives Pages the ability to create posts from videos without re-uploading them again. The major benefit of this is that you can see total insights from all videos crossposted across Facebook and a breakdown of metrics across the multiple posts created from it. You can use video_insights edge on the Video API to read the total insights. This is different from {post_id}/insights since it allows you to read insights from a single post.
All available metrics are shown below.
| Name | Description | Values for `period` |
|---|---|---|
| Total number of times your video was viewed for 3 seconds or viewed to the end, whichever happened first. | lifetime |
| Number of unique people who viewed your video for 3 seconds or viewed to the end, whichever happened first. | lifetime |
| Number of times your video started automatically playing and people viewed it for 3 seconds or viewed it to the end, whichever happened first. | lifetime |
| Number of times people clicked to play your video and viewed it for 3 seconds or viewed it to the end, whichever happened first. | lifetime |
| Number of times your video was viewed for 3 seconds or viewed to the end (whichever happened first) without paid promotion. | lifetime |
| Number unique viewers who watched for 3 seconds or viewed to the end (whichever happened first) without paid promotion. | lifetime |
| Number of times your video was viewed for 3 seconds or viewed to the end (whichever happened first) with paid promotion. | lifetime |
| Number of unique viewers who watched for 3 seconds or viewed to the end (whichever happened first) without paid promotion. | lifetime |
| Number of times your video was viewed with sound on for 3 seconds or viewed to the end, whichever happened first. | lifetime |
| Number of times your video was viewed for 95% or complete. | lifetime |
| Number of unique viewers who watched for 95% or complete. | lifetime |
| Number of times your video started playing automatically and people viewed it for more than 95%. | lifetime |
| Number of times people clicked to play your video and viewed it for more than 95%. | lifetime |
| Number of times your video was viewed to 95% of its length without any paid promotion. | lifetime |
| Number of times your video was viewed to 95% of its length without any paid promotion. | lifetime |
| Number of times your video was viewed to 95% of its length after paid promotion. | lifetime |
| Number of times your video was viewed to 95% of its length after paid promotion. | lifetime |
| Total number of times your video was viewed for 10 seconds or viewed to the end, whichever happened first. | lifetime |
| Number of unique people who viewed your video for 10 seconds or viewed to the end, whichever happened first. | lifetime |
| Number of times your video started playing automatically and people viewed it for 10 seconds or viewed it to the end, whichever happened first. | lifetime |
| Number of times people clicked to play your video and viewed it for 10 seconds or viewed it to the end, whichever happened first. | lifetime |
| Number of times your video was viewed for 10 seconds or viewed to the end, whichever happened first, without a paid promotion. | lifetime |
| Number of times your video was viewed for 10 seconds or viewed to the end, whichever happened first, after a paid promotion. | lifetime |
| Number of times your video was viewed with sound on for 10 seconds or viewed to the end, whichever happened first. | lifetime |
| Views of your video at each moment as a percentage of all views, including views shorter than 3 seconds. | lifetime |
| Auto-played views of your video at each moment as a percentage of all views, including views shorter than 3 seconds. | lifetime |
| Clicked-to-play views of your video at each moment as a percentage of all views, including views shorter than 3 seconds. | lifetime |
| Average time video was viewed. | lifetime |
| Total time (in ms) video has been viewed. | lifetime |
| Total time (in ms) video has been viewed without paid promotion. | lifetime |
| Total time (in ms) video has been viewed with paid promotion. | lifetime |
| The number of impressions of the video. | lifetime |
| Number of people your video was served to. | lifetime |
| Number of people your advertised Page Video was served to. | lifetime |
| Number of impressions of your Page Video in after paid promotion. | lifetime |
| Number of people who saw your Page Video without paid promotion. | lifetime |
| The number of impressions of your Video without paid promotion. | lifetime |
| Number of people who saw your Page Video in a story from a friend. | lifetime |
| Number of impressions of your Page Video in a story generated by a friend. | lifetime |
| Number of people who saw your Page video because they have liked your Page. | lifetime |
| Number of impressions of your Page Video to people who have liked your Page. | lifetime |
| Number of people who like your Page and who saw your Page Video in an ad or sponsored story. | lifetime |
| Number of paid impressions of your Page Video Asset to people who have liked your Page. | lifetime |
| Number of stories created about your Page Video, by action type. | lifetime |
| The total number of reactions to your post by type. | lifetime |
| Total time (in milliseconds) video has been viewed by Top Audiences. | lifetime |
| Total time (in milliseconds) video has been viewed by Top 45 Locations (Region - Country). | lifetime |
| Number of times your video was viewed by distribution type (page_owned and shared). | lifetime |
| Total time (in milliseconds) video has been viewed by distribution type (page_owned, crossposted, shared). | lifetime |
Reading
Total insights from all video posts associated with this video.
GET /v2.10/{video-id}/video_insights HTTP/1.1
Host: graph.facebook.com/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
$session,
'GET',
'/{video-id}/video_insights'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result *//* make the API call */
FB.api(
"/{video-id}/video_insights",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{video-id}/video_insights",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{video-id}/video_insights"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];Permissions
Developers usually request these permissions for this endpoint:Marketing Apps
ads_managementread_insights
read_insightspages_show_list
read_insights
Parameters
| Name | Description |
|---|---|
metriclist<A valid metric for an insights endpoint> | The list of metrics that needs to be fetched |
periodenum{day, week, days_28, month, lifetime, total_over_range} | The aggregation period |
Fields
Reading from this edge will return a JSON formatted result:
{ "
data": [], "paging": {} }
data
A list of InsightsResult nodes.paging
For more details about pagination, see the Graph API guide.Validation Rules
| Error | Description |
|---|---|
| 100 | Invalid parameter |