get_video_retention
Analyze viewer drop-off points in a video to optimize content, identify engaging moments, and improve completion rates. Provides 101 data points showing viewer retention at each percentage of the video, enabling precise comparisons between audience segments.
Instructions
Analyze WHERE viewers stop watching in a video. USE WHEN: Optimizing video content, finding boring sections, identifying engaging moments, improving completion rates. RETURNS: 101 data points (0-100%) showing viewer count at each percent of video. EXAMPLES: 'Where do viewers drop off in video 1_abc123?', 'What parts get replayed?', 'Compare retention for anonymous vs logged-in users'. Shows exact percentages where audience is lost.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
compare_segments | No | Compare filtered segment vs all viewers | |
entry_id | Yes | Video to analyze (required, format: '1_abc123'). Get from search_entries or get_media_entry. | |
from_date | No | Start date (optional, defaults to 30 days ago) | |
to_date | No | End date (optional, defaults to today) | |
user_filter | No | Optional viewer segment: 'anonymous' (not logged in), 'registered' (logged in), 'user@email.com' (specific user), 'cohort:students' (named group). Compare different audience behaviors. |