-
Notifications
You must be signed in to change notification settings - Fork 972
Video Ad Events Report
This guide will walk you through how to generate and use the Video Ad Events Report to analyze the performance of ads on your platform. The report provides detailed insights on ads by video, user, event types, and campaigns. Follow the steps below to effectively use the tool.
- Accessing the Report
- Filter Options
- Generating the Report
- Interpreting the Results
- Downloading the Report as CSV
To access the Video Ad Events Report:
- Log in to your admin account.
- Find the Advertising Reports button located in either the AD_Server plugin or the GoogleAds_IMA plugin.
- You will see a form allowing you to select filters and generate reports for ad events.
The report provides several filters to customize the results. These filters allow you to narrow down the data by date range, campaign type, event type, and report type.
You can select a preset date range or manually specify the start and end dates.
- This Week: Selects the current week.
- This Month: Selects the current month.
- Last 2 Months: Shows data from the last two months.
- This Year: Displays data for the current year.
If none of these options fit your needs, you can manually enter the dates using the Start Date and End Date fields.
Choose which ad campaign source you want to analyze:
- All Campaigns: Includes all ads.
- Own Videos (AD_Server): Ads served through your own video content, originating from the AD_Server plugin.
- Third Party Ads (GoogleAds_IMA): Ads from external sources, including GoogleAds_IMA, but this can also include ads from any external VAST ad company.
Event types help you analyze the specific stages and actions related to an ad. Select the event type(s) you want to focus on, or choose All Event Types to include all.
Below is a description of the available event types:
- AdStarted: The ad has started playing.
- AdFirstQuartile: The user has watched the first 25% of the ad.
- AdMidpoint: The user has watched 50% of the ad.
- AdThirdQuartile: The user has watched 75% of the ad.
- AdCompleted: The ad was watched to completion.
- AdPaused: The ad was paused by the user.
- AdResumed: The ad was resumed after being paused.
- AdSkipped: The user skipped the ad before completion.
- AdClicked: The user clicked on the ad.
- AdError: There was an error during the ad playback.
- AdMuted: The ad's sound was muted by the user.
- AdUnmuted: The ad's sound was unmuted by the user.
- AdRewind: The ad was rewound.
- AdFullscreen: The user switched the ad to fullscreen mode.
- AdCreativeView: The user viewed the creative (non-linear) ad content.
- AdExitFullscreen: The user exited fullscreen mode.
- AdAcceptInvitationLinear: The user accepted an invitation for a linear ad.
- AdCloseLinear: The user closed a linear ad.
Select the type of report you want to generate:
- Ads Per Video: Shows ads by individual video.
- Ad Types Overview: Provides an overview of all ad types.
- Ads for a Single Video: Focuses on ads for one specific video.
- Ads by User: Displays ads categorized by user.
- List Videos and Total Ads by User: Lists videos with the total number of ads by user.
Depending on your selection, additional fields may appear for choosing specific videos or users.
Once you've selected the desired filters:
- Click on the Generate Report button.
- The system will retrieve and display data based on your filters.
The report generates results in two formats: a chart and a data table.
- The chart displays a visual representation of ad events, with bars representing total ads for each video or event type.
- Each bar is color-coded based on the event type, making it easy to identify the distribution of ad events.
- The data table below the chart lists detailed information about each video or user, along with the total number of ads.
- The table includes the following columns:
- Label: Identifies the video or event type.
- Total: Total number of ads for that video or event.
- User: The user associated with the video or ad campaign.
You can click on specific videos or users in the table to generate more focused reports.
To download the report:
- After generating the report, click the Download CSV button at the bottom of the page.
- This will create a CSV file containing the report data, which you can open in spreadsheet applications like Excel or Google Sheets for further analysis.
By following this guide, you'll be able to effectively generate, interpret, and download the Video Ad Events Report to gain insights into ad performance across your platform.