{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/comments/31142882","id":31142882,"diff_hunk":"@@ -0,0 +1,164 @@\n+.. _Engagement_Video:\n+\n+#############################\n+Engagement with Course Videos\n+#############################\n+\n+Are learners watching the course videos? Do they watch some videos more than\n+others? Of those who watched a video, what percentage watched it to the end?\n+Do learners watch certain parts of the video more than once?\n+\n+The video engagement data in edX Insights gives you perspective on your\n+learners' viewing patterns.\n+\n+Video engagement data is updated every week for the period Monday at 00:00\n+UTC through Sunday at 23:59 UTC.\n+\n+********************************************\n+Gaining Insight into Viewing Patterns\n+********************************************\n+\n+EdX Insights delivers data about learner engagement with videos in a series of\n+charts and reports. Charts, metrics, and data are available for each of the\n+videos in your course. To access data about a specific video, you select the\n+section and subsection of the course that contain that video. When you make\n+these selections, edX Insights provides aggregated data about viewing patterns\n+for all videos in that part of the course outline.\n+\n+For detailed information about the computations, see :ref:`Reference`.\n+\n+*********************************************\n+Selecting the Section, Subsection, and Video\n+*********************************************\n+\n+To access data about a video component, follow these steps.\n+\n+#. Open edX Insights at insights.edx.org. A list of the courses for which you\n+   have the admin or staff role appears.\n+\n+#. Select the course.\n+\n+#. Select **How did students interact with course videos?**. Alternatively,\n+   select **Engagement** and then **Video**. A chart and a table of aggregated\n+   video data for the sections in your course appears. The chart only includes\n+   bars for sections that include at least one video component.\n+\n+#. Select a section in your course that contains video components. A chart and\n+   a table of aggregated video data for each subsection in that section\n+   appears. The chart only includes bars for subsections that include\n+   at least one video component. \n+\n+#. Select a subsection. A chart and a table of aggregated video data for each\n+   unit in that subsection appears. The chart only includes bars for units\n+   that include at least one video component.\n+\n+#. Select the unit that contains the video component. A chart, metrics, and a\n+   table of data for that video file appears.\n+\n+For detailed information about the computations, see :ref:`Reference`.\n+\n+*******************************************************\n+Analytics in Action: Interpreting Viewing Patterns\n+*******************************************************\n+\n+A review of what learners in your course watch can lead to discoveries\n+about your videos and about your course.\n+\n+* You can determine how many learners watch each video.\n+\n+* You can determine how many learners watch the entire video, and where the\n+  other learners drop out.\n+\n+* You can find video segments that learners watched more than once.\n+\n+You can use this information to guide research on your video files and assess\n+where you might make changes.\n+\n+=======================================================\n+Investigating Video Views for Sections and Subsections\n+=======================================================\n+\n+To access data about a video, you select the section and subsection that\n+contain the video. When you make each of these selections, edX Insights\n+provides aggregated data of complete and incomplete video views.\n+\n+In this chart of video views for the sections in a completed course, each bar\n+represents the number of views of all videos in a section. Each of the bars is\n+divided into the number of completed views in green and the number of\n+incomplete views in gray.\n+\n+.. image:: ../images/video_sections.png\n+ :alt: A stacked bar chart showing varying levels of complete video watching.\n+\n+Reviewing the aggregated data in this chart might lead you to investigate\n+several questions. You might want to understand why there are so many more\n+incomplete views in some of the sections than in others. Does your course have\n+numerous short videos in most of the sections, and fewer, comparatively long\n+videos in one or two of the other sections? Is there a difference in quality?\n+Could you have, accidentally or deliberately, included the same video file in\n+your course more than once?\n+\n+When you select a section with a relatively low number of complete views,\n+another stacked bar chart displays for the subsections in that section. \n+\n+.. image:: ../images/video_subsections.png\n+ :alt: A stacked bar chart for three subsections. In one subsection, fewer\n+  than a third of the students who started videos finished watching them.\n+\n+This chart helps you focus your investigation on the first subsection, in\n+which more than twice as many learners begin to view a video than complete the\n+viewing. After you select that subsection, the chart for video views in the\n+units appears. Once again, the aggregate data can help guide your\n+investigation into the disproportionate number of incomplete video views.\n+\n+================================\n+Researching Replayed Segments\n+================================\n+\n+When you review the chart for a video, you can see which five second segments\n+learners played more than once. The stacked area graph shows replays in darker\n+blue above plays by unique users.\n+\n+When you see the graph for this video, you decide to investigate what exactly\n+happens at the 40 second mark.\n+\n+.. image:: ../images/video_replays.png\n+ :alt: A chart showing a noticeable increase in the number of replays 40\n+  seconds in to the video.","path":"docs/en_us/dashboard/source/engagement/Engagement_Video.rst","position":127,"original_position":127,"commit_id":"514c78e227483cb329e497bc50853a335fe2cd9e","original_commit_id":"514c78e227483cb329e497bc50853a335fe2cd9e","user":{"login":"dsjen","id":5265058,"avatar_url":"https://avatars.githubusercontent.com/u/5265058?v=3","gravatar_id":"","url":"https://api.github.com/users/dsjen","html_url":"https://github.com/dsjen","followers_url":"https://api.github.com/users/dsjen/followers","following_url":"https://api.github.com/users/dsjen/following{/other_user}","gists_url":"https://api.github.com/users/dsjen/gists{/gist_id}","starred_url":"https://api.github.com/users/dsjen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dsjen/subscriptions","organizations_url":"https://api.github.com/users/dsjen/orgs","repos_url":"https://api.github.com/users/dsjen/repos","events_url":"https://api.github.com/users/dsjen/events{/privacy}","received_events_url":"https://api.github.com/users/dsjen/received_events","type":"User","site_admin":false},"body":"I believe this should be \"into\" instead of \"in to.\"","created_at":"2015-05-27T15:03:39Z","updated_at":"2015-05-27T15:03:39Z","html_url":"https://github.com/edx/edx-analytics-dashboard/pull/314#discussion_r31142882","pull_request_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/comments/31142882"},"html":{"href":"https://github.com/edx/edx-analytics-dashboard/pull/314#discussion_r31142882"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314","id":36239767,"html_url":"https://github.com/edx/edx-analytics-dashboard/pull/314","diff_url":"https://github.com/edx/edx-analytics-dashboard/pull/314.diff","patch_url":"https://github.com/edx/edx-analytics-dashboard/pull/314.patch","issue_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/314","number":314,"state":"open","locked":false,"title":"Ahodges/video","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=3","gravatar_id":"","url":"https://api.github.com/users/lamagnifica","html_url":"https://github.com/lamagnifica","followers_url":"https://api.github.com/users/lamagnifica/followers","following_url":"https://api.github.com/users/lamagnifica/following{/other_user}","gists_url":"https://api.github.com/users/lamagnifica/gists{/gist_id}","starred_url":"https://api.github.com/users/lamagnifica/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamagnifica/subscriptions","organizations_url":"https://api.github.com/users/lamagnifica/orgs","repos_url":"https://api.github.com/users/lamagnifica/repos","events_url":"https://api.github.com/users/lamagnifica/events{/privacy}","received_events_url":"https://api.github.com/users/lamagnifica/received_events","type":"User","site_admin":false},"body":"Initial draft of the Video Engagement documentation for edX Insights. The project page https://openedx.atlassian.net/wiki/display/DOC/Analytics%3A+Per-video+report contains links to the various stories and analytics epic for this new feature. Stage at https://stage-insights.edx.org has up to date UI. \r\n@shnayder @mhoeber please review for level of detail, quality of examples, etc. \r\n@dsjen @brianhw please review for accuracy and completeness.\r\n","created_at":"2015-05-26T20:02:01Z","updated_at":"2015-05-27T15:03:40Z","closed_at":null,"merged_at":null,"merge_commit_sha":"861746e55c5ce912935eb55baea2394d33a6530c","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314/commits","review_comments_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314/comments","review_comment_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/314/comments","statuses_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/statuses/514c78e227483cb329e497bc50853a335fe2cd9e","head":{"label":"edx:ahodges/video","ref":"ahodges/video","sha":"514c78e227483cb329e497bc50853a335fe2cd9e","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":20941273,"name":"edx-analytics-dashboard","full_name":"edx/edx-analytics-dashboard","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-analytics-dashboard","description":"Dashboard to display course analytics to course teams","fork":false,"url":"https://api.github.com/repos/edx/edx-analytics-dashboard","forks_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/forks","keys_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/teams","hooks_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/events","assignees_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/tags","blobs_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/languages","stargazers_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/subscription","commits_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/merges","archive_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/downloads","issues_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/releases{/id}","created_at":"2014-06-17T22:14:33Z","updated_at":"2015-05-08T00:57:13Z","pushed_at":"2015-05-27T14:05:39Z","git_url":"git://github.com/edx/edx-analytics-dashboard.git","ssh_url":"git@github.com:edx/edx-analytics-dashboard.git","clone_url":"https://github.com/edx/edx-analytics-dashboard.git","svn_url":"https://github.com/edx/edx-analytics-dashboard","homepage":null,"size":16925,"stargazers_count":18,"watchers_count":18,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":23,"mirror_url":null,"open_issues_count":5,"forks":23,"open_issues":5,"watchers":18,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"a5576c2286b12ccc1257b978efd857e389a4e308","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":20941273,"name":"edx-analytics-dashboard","full_name":"edx/edx-analytics-dashboard","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-analytics-dashboard","description":"Dashboard to display course analytics to course teams","fork":false,"url":"https://api.github.com/repos/edx/edx-analytics-dashboard","forks_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/forks","keys_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/teams","hooks_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/events","assignees_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/tags","blobs_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/languages","stargazers_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/subscription","commits_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/merges","archive_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/downloads","issues_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-analytics-dashboard/releases{/id}","created_at":"2014-06-17T22:14:33Z","updated_at":"2015-05-08T00:57:13Z","pushed_at":"2015-05-27T14:05:39Z","git_url":"git://github.com/edx/edx-analytics-dashboard.git","ssh_url":"git@github.com:edx/edx-analytics-dashboard.git","clone_url":"https://github.com/edx/edx-analytics-dashboard.git","svn_url":"https://github.com/edx/edx-analytics-dashboard","homepage":null,"size":16925,"stargazers_count":18,"watchers_count":18,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":23,"mirror_url":null,"open_issues_count":5,"forks":23,"open_issues":5,"watchers":18,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314"},"html":{"href":"https://github.com/edx/edx-analytics-dashboard/pull/314"},"issue":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/314"},"comments":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/issues/314/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/pulls/314/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-analytics-dashboard/statuses/514c78e227483cb329e497bc50853a335fe2cd9e"}}}}