Skip to content

PRO - requires MediaShield Pro. Free has no export screen.

Download watch data as a spreadsheet (CSV) or as a PDF report.

Take the numbers out of WordPress: share a spreadsheet with a manager or client, keep a monthly record, or check figures in your own tools.

  • You need the Administrator role.
  • PDF reports run as a background job. Action Scheduler must be available. The free MediaShield plugin includes it.
  • Exports contain personal data (user names, email addresses, IP addresses). Store and share the files carefully.
  1. Go to MediaShield > Export.
  2. Under CSV Export, choose a Data Type.
  3. Optionally set From Date and To Date. Leave both empty to export everything.
  4. Click Download CSV. “CSV download started.” appears and the file downloads.
Data type One row per Columns
Watch Sessions Session ID, Video ID, User ID, Session Token (redacted), IP Address, Total Seconds, Max Position, Started At, Last Heartbeat, Device Type, Browser
Milestones Milestone reached ID, Video ID, Video Title, User ID, User Name, Milestone Pct, Reached At
Users (watch stats) Viewer User ID, Display Name, Email, Total Watch Time (s), Session Count, Unique Videos, Milestone Count

Limits:

  • Watch Sessions and Milestones have no row cap. They are read in pages so large sites do not run out of memory.
  • The Users export stops at 200,000 rows. When that happens a note is written into the file saying it is incomplete, so a short file never passes for a full one. Narrow the dates and export again.

The screen offers date filters only. The underlying API also accepts a user and a video filter. See REST API.

  1. Go to MediaShield > Export.
  2. Under PDF Report, choose a Period: Last 7 days, Last 30 days, Last 90 days or All time.
  3. Click Generate PDF. “PDF report queued.” appears.
  4. Wait. The screen checks for the file and shows Download PDF when it is ready. If it takes too long you see “Report generation timed out. Please try again.”
  5. An email with the same link is sent to your site admin address.

The report holds three sections:

  • Overview: unique viewers, total sessions, total watch time and unique videos.
  • Top 10 Videos by Watch Time.
  • Completion Milestones: how many times each milestone was reached.

It has no per-user section and no alerts section. Use the Users CSV for per-user figures and the Alerts screen for flags.

The download link is tracked for 24 hours. The file itself stays in wp-content/uploads/mediashield/exports/ after that. Delete old reports from that folder if you do not want them kept.

The weekly email summary is configured on this same screen. See Weekly Digest Email.

Pro data is included in WordPress’s own Export Personal Data and Erase Personal Data tools. See Privacy, Data and Retention.

This is an admin screen. Viewers see nothing.

If a PDF never arrives, see Troubleshooting.