Reports metrics, dimensions, filters, products


Reporting metrics

MetricsDescription
VIEWSNumber of views
TIME_WATCHED_SECONDSTime watched in seconds
VIEW_THROUGH_RATEVideo view-through rate
AVERAGE_WATCH_TIME_SECTotal watch time in seconds ÷ views over the selected period. Returns null (or 0) when views = 0.
UPLOADSNumber of videos uploaded
LIVE_VIEWERSLive viewers
LIVE_TIME_WATCHED_SECONDSLive time watched
ESTIMATED_EARNINGS_USDEstimated earnings in USD
ESTIMATED_EARNINGS_EUREstimated earnings in EUR
TOTAL_INVENTORYTotal ad opportunities generated by your content or your embeds
NO_ADSAd opportunities identified to be not eligible for monetization
NO_AD_RATEShare of ad opportunities not eligible for monetization
SELLABLE_INVENTORYAd opportunities available for monetization
NB_IMPRESSIONTotal number of ads displayed
FILL_RATEShare of sellable inventories filled with an ad impression
NB_MISSED_IMPRESSIONMonetizable ad opportunities that were not filled with an ad impression (includes errors, timeouts, nofills)
VIEWABILITY_SCOREShare of ad impressions with high viewability
GDPR_FULL_CONSENT_SCOREShare of users who granted their full consent for the processing of their personal data
VTR_SCOREShare of users who watched a full ad


Reporting dimensions

DimensionsDescription
MONTHMonth of the event
DAYDay of the event
HOURHour of the event
CHANNEL_SLUGChannel slug
VIDEO_OWNER_CHANNEL_SLUGVideo owner's channel slug
VIDEO_IDVideo ID
VIDEO_TITLETitle of the video
VISITOR_DOMAIN_GROUPVisitor's domain group
VISITOR_SUBDOMAINVisitor's subdomain
VISITOR_PAGE_URLURL of the visitor's page
VISITOR_COUNTRYCountry of the visitor
VISITOR_DEVICE_TYPEDevice type used by the visitor
MONETIZATION_TYPEType of monetization
INVENTORY_POSITIONPosition of the ad opportunity. Usually one of the following – preroll, midroll, postroll, ivv
OUTCOMEBreakdown of missed impression by category
NOAD_REASON_READABLENo ads grouped by why they were not available for monetization. Click here to learn more about no ad reason
AD_ERROR_READABLEAd errors returned by our advertising system for the selected metric
AD_ERROR_CODEAd error code returned by our advertising system for the selected metric
BUYERPotential and actual buyers of the inventory
BUYER_TYPEType of buyer of the inventory. Usually either P1 or Dailymotion
ACTION

Action defines how a view or inventory was generated by clarifying the stakeholders involved.

Example my content played on other properties shows that the ad inventory was generated because one of my content was being played on another account’s website or application

AD_FORMATType of ad being displayed. Usually one of the following:
  • instream - a video ad
  • display_preroll- a static image ad
PLAYER_IDID(s) of the player(s) used to play your content. (The ID(s) listed can be yours or from third parties)
PLAYER_TITLETitle(s) of the player(s) used to play your content.(The title(s) listed can be yours or from third parties)
PLAYLIST_IDID(s) of the playlist(s) used to play your content. The ID(s) listed can be yours or from third parties.
PLAYLIST_TITLETitle(s) of the playlist(s) used to play your content. (The title(s) listed can be yours or from third parties)
VIDEO_POSITIONPosition of the video within a playlist
CONTENT_TAG

Breakdown the data by each tag specified on content.

Note that more than one tag can be added to a single content: when using this dimension the returned metrics (data) may overlap and cannot be summed up.

Example:
Video A has tags (Tag 1, Tag 2) and has accumulated 10 views on March 5, 2022 - Generating a report for this date might result in the following:

DAY, VIDEO TITLE, CONTENT_TAG, VIEWS 2022-03-05, Video A, Tag 1, 10 2022-03-05, Video A, Tag 2, 10

Since Video A is using both Tag 1 and Tag 2,
the views column here cannot be summed as it would result in 20 views which is not the total number of views.

CONTENT_TAG_LISTComma separated list of tags specified on content


Reporting filters

FiltersDescription
channelSlug / profile_nameFilter by channel slug
videoOwnerChannelSlug / video_owner_profile_nameFilter by video owner's channel slug
mediaType

Limits the results to a specific media type.

Possible values: VIDEO or LIVE

visitorDomainGroupFilter by visitor's domain group
monetizationType

Limits the results to a monetization type.

Possible values: Video monetization Website moentization or claim



Reporting products

ProductsDescription
CONTENTThis is the default value if no product is specified. Returns data for content that belongs to this account.
EMBEDReturns data for embeds that belong to this account.
CLAIMReturns data for claimed content owned by this account. Only available if you have active claims.
ALLReturns combines data for content, embeds and claims associated to this account.