Traffic from Advertisement for a Video

This query provides detailed metrics about traffic coming from advertisements for a specific YouTube video. It helps track how paid promotions are performing by showing views, watch time, and engagement metrics for different ad campaigns.

Example Output

Parameters

Dimension

The dimension is set to "insightTrafficSourceDetail" which breaks down traffic sources from advertising campaigns.

Start Date

The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).

• Cannot be in the future.

End Date

The end date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-09-30).

• Cannot be in the future.
• Must be after Start Date.

Tip: For scheduled requests, you may need to update the date daily. Instead of specifying the date manually, you can use 'today' or 'yesterday' as the parameter. When the request runs, the date will automatically adjust to the desired day.

IDs

Specifies the channel for which to retrieve data.

• Options:
  • "channel==MINE": Fetches data for your own channel.
  • "channel==CHANNEL_ID": Retrieves data for a specific channel you own.

Sort (Optional)

Default sort is by estimated minutes watched in descending order ("-estimatedMinutesWatched").

• Can be modified to sort by other metrics like:
  • "-views" for sorting by views
  • "-averageViewDuration" for sorting by average view duration

Tip: You can find the technical names of the metrics you can sort by when you click on the chart symbol at the bottom of the Parameters section.

Filters

Required filters to specify:

• Video ID: Replace VIDEO_ID with the ID of a video from your channel
• Traffic Source Type: Set to "ADVERTISING" to show only ad-driven traffic

Example: "video==VIDEO_ID;insightTrafficSourceType==ADVERTISING"

Maximum Results

Enter a number between 1 and 200 to control the number of results returned (default is 10).

Columns

• Dimension: The specific advertising source detail.

• Views: Total number of views generated from advertising.

• Estimated Minutes Watched: The estimated total number of minutes that viewers from ads spent watching the video.

• Average View Duration: Average length of time ad-driven viewers watched the video (in minutes).

Notes

• Results can be sorted by any of the available metrics
• All metrics are filtered to show only traffic from advertising sources
• The query specifically focuses on a single video's performance through paid promotions
• Data is automatically formatted in the sheet with timestamps and filters