Nesta página, listamos os relatórios que os proprietários de conteúdo podem recuperar com a API YouTube Reporting. O id de cada relatório, retornado pelo método reportTypes.list da API, é mostrado entre parênteses ao lado do nome do relatório.
Relatórios de vídeo
Os relatórios de vídeo fornecem estatísticas sobre toda a atividade do usuário relacionada aos vídeos de um canal ou de um proprietário do conteúdo. Por exemplo, esses relatórios contêm o número de vezes que seus vídeos foram visualizados.
Atividade do usuário
Este relatório mostra as estatísticas de atividade do usuário relacionadas aos canais de um proprietário de conteúdo e aos vídeos deles.
O id deste relatório é content_owner_basic_a4.
Atividade do usuário por província
Este relatório mostra as estatísticas de atividade do usuário para os estados dos EUA e o Distrito de Columbia.
O id deste relatório é
content_owner_province_a3
.
Locais de reprodução
Neste relatório, são exibidas as estatísticas relacionadas ao tipo de página ou aplicativo em que ocorreram as reproduções do vídeo.
O id deste relatório é
content_owner_playback_location_a3
.
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores encontraram os vídeos nos canais do proprietário do conteúdo. Por exemplo, ele identifica o número de visualizações que vieram de uma pesquisa no Google ou de um link para um vídeo relacionado.
O id deste relatório é
content_owner_traffic_source_a3
.
Tipo de dispositivo e sistema operacional
Esse relatório agrega estatísticas de visualização de vídeo com base nos sistemas operacionais e tipos de dispositivos dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows.
O id deste relatório é
content_owner_device_os_a3
.
Informações demográficas do espectador
Neste relatório, são agregadas as estatísticas de visualização com base na faixa etária e no gênero dos espectadores.
O id deste relatório é
content_owner_demographics_a1
.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
| Métricas: | views_percentage |
Compartilhamento de conteúdo por plataforma
Esse relatório mostra estatísticas sobre a frequência com que os vídeos nos canais do proprietário do conteúdo foram compartilhados em diferentes plataformas sociais.
O id deste relatório é
content_owner_sharing_service_a1
.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métricas: | ações |
Anotações
Esse relatório fornece estatísticas sobre as anotações que aparecem durante os vídeos nos canais de um proprietário do conteúdo.
Os dados do relatório medem a performance de anotações individuais em cada vídeo. Já o relatório de atividade do usuário agrega estatísticas de todas as anotações de um vídeo.
O id deste relatório é
content_owner_annotations_a1
.
Cartões
Esse relatório mostra as impressões e as estatísticas de cliques dos cards que aparecem durante os vídeos nos canais de um proprietário de conteúdo.
Os dados do relatório medem a performance de cards individuais. Já o relatório de atividade do usuário agrega estatísticas de todos os cards de um vídeo.
O id deste relatório é
content_owner_cards_a1
.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
| Métricas: | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Telas finais
Esse relatório mostra as estatísticas de impressão e taxa de cliques das telas finais que aparecem depois que um vídeo para de ser reproduzido.
O relatório contém estatísticas de vídeos nos canais de um proprietário de conteúdo.
O id deste relatório é
content_owner_end_screens_a1
Legendas
Esse relatório fornece estatísticas sobre o idioma da legenda descritiva usado por mais tempo durante as visualizações de vídeo. As visualizações em que as legendas estão desativadas na maior parte do tempo são excluídas.
O id deste relatório é content_owner_subtitles_a3.
Combinado
Esse relatório fornece estatísticas detalhadas de vídeo combinando dimensões usadas nos relatórios local de reprodução, origem do tráfego e dispositivo/SO.
O id deste relatório é content_owner_combined_a3.
Relatórios de playlists
Os relatórios de playlists fornecem estatísticas relacionadas especificamente às visualizações de vídeo que ocorrem no contexto de uma playlist.
Atividade do usuário
Esse relatório mostra estatísticas relacionadas às interações dos usuários com playlists nos canais de um proprietário de conteúdo.
O id deste relatório é content_owner_playlist_basic_a2.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
| Métricas: | engaged_views, views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Atividade do usuário por província
Este relatório mostra as estatísticas de atividade do usuário relacionadas às interações com playlists nos canais de um proprietário de conteúdo para usuários nos estados dos EUA e no Distrito de Columbia. O relatório é filtrado para incluir dados somente se o valor da dimensão country_code for US.
O id deste relatório é content_owner_playlist_province_a2.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
| Métricas: | engaged_views, views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Locais de reprodução
Esse relatório fornece estatísticas relacionadas ao tipo de página ou aplicativo em que as reproduções de playlists ocorreram.
O id deste relatório é
content_owner_playlist_playback_location_a2
.
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores acessaram os vídeos da playlist nos canais de um proprietário do conteúdo. Por exemplo, esse relatório identifica o número de visualizações que vieram de uma pesquisa no Google ou de um link para um vídeo relacionado.
O id deste relatório é content_owner_playlist_traffic_source_a2.
Tipo de dispositivo e sistema operacional
Esse relatório agrega estatísticas de visualização de playlists com base nos sistemas operacionais e tipos de dispositivos dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows.
O id deste relatório é
content_owner_playlist_device_os_a2
.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, operating_system |
| Métricas: | engaged_views, views, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed |
Combinado
Esse relatório oferece estatísticas detalhadas de playlists combinando dimensões usadas nos relatórios local de reprodução, origem do tráfego e dispositivo/SO.
O id deste relatório é content_owner_playlist_combined_a2.
Relatórios de taxa de anúncios
Os relatórios de taxa de anúncio fornecem métricas baseadas em impressões para anúncios veiculados durante a reprodução de vídeos. Essas métricas consideram cada impressão de anúncio, e cada reprodução de vídeo pode gerar várias impressões.
A API oferece suporte ao seguinte relatório de taxa de anúncios, que fornece métricas de taxa de anúncios para os vídeos de um proprietário de conteúdo.
O id deste relatório é content_owner_ad_rates_a1.
O ID da versão anterior deste relatório, que agora está totalmente descontinuada, era content_owner_ad_performance_a1.
A única diferença da versão anterior é que esta atualiza o nome do relatório para usar a palavra rates em vez de performance. Como resultado, o próprio relatório tem o mesmo número de versão (a1) da versão anterior, mas o report ID é diferente.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claimed_status, uploader_type, country_code, ad_type |
| Métricas: | estimated_youtube_ad_revenue, ad_impressions, estimated_cpm |
Relatórios de receita estimada
Os relatórios de receita estimada mostram a receita total estimada dos vídeos de fontes de publicidade vendidas pelo Google e de fontes não relacionadas a publicidade. Esses relatórios também contêm algumas métricas de performance de anúncios.
As métricas de ganhos identificam fontes de receita específicas e o valor da receita total acumulada por esses fluxos.
Receita de vídeo estimada
Esse relatório mostra os ganhos totais de todos os vídeos de um proprietário de conteúdo provenientes de fontes de publicidade vendidas pelo Google e de fontes não relacionadas a publicidade. Ele também contém algumas métricas de performance de anúncios.
O id deste relatório é content_owner_estimated_revenue_a2.
Receita de recursos estimada
Esse relatório mostra os ganhos totais de todos os recursos de um proprietário de conteúdo de fontes de publicidade vendidas pelo Google e de fontes não relacionadas a publicidade. Ele também contém algumas métricas de performance de anúncios. A dimensão channel_id identifica o canal que enviou o video_id para o qual as métricas estão sendo fornecidas.
O id deste relatório é content_owner_asset_estimated_revenue_a2.
- Adiciona a métrica estimated_partner_red_revenue
- Adiciona a métrica estimated_partner_transaction_revenue
- Renomeia a métrica estimated_partner_ad_sense_revenue para estimated_partner_ad_auction_revenue
- Renomeia a métrica estimated_partner_double_click_revenue para estimated_partner_ad_reserved_revenue
- Atualiza o nome do relatório para usar a palavra
revenueem vez deearnings. Como resultado, o próprio relatório tem o mesmo número de versão (a1) da versão anterior, mas oreport IDé diferente.
Relatórios de recursos
Os relatórios de recursos fornecem métricas de atividade do usuário relacionadas a vídeos vinculados aos recursos de um proprietário de conteúdo. Um vídeo é incluído no relatório de um proprietário de conteúdo se ele reivindicou o vídeo como correspondente a um dos recursos dele. O vídeo pode ter sido enviado pelo proprietário do conteúdo ou por outro usuário do YouTube.
Nos relatórios de recursos, a dimensão channel_id identifica o canal que enviou o video_id para o qual as métricas estão sendo fornecidas.
Por exemplo, em um determinado dia, suponha que um vídeo seja visualizado 10 vezes, depois reivindicado e, em seguida, visualizado mais 10 vezes. O relatório de recursos desse dia vai mostrar que o vídeo foi visualizado 20 vezes, mesmo que apenas 10 dessas visualizações tenham ocorrido após a reivindicação. As métricas de todos os dias subsequentes precisam refletir com precisão a atividade do usuário relacionada ao vídeo reivindicado.
Atividade do usuário
Esse relatório fornece estatísticas relacionadas às ações dos usuários em vídeos vinculados aos recursos de um proprietário de conteúdo.
O id desta versão do relatório é content_owner_asset_basic_a3.
Atividade do usuário por província
Este relatório mostra as estatísticas de atividade do usuário para os estados dos EUA e o Distrito de Columbia. Isso significa que o relatório é filtrado para incluir dados somente se o valor da dimensão country_code for US. O id deste relatório é content_owner_asset_province_a3.
O id desta versão do relatório é
content_owner_asset_province_a3.
Locais de reprodução do vídeo
Neste relatório, são exibidas as estatísticas relacionadas ao tipo de página ou aplicativo em que ocorreram as reproduções do vídeo.
O id desta versão do relatório é content_owner_asset_playback_location_a3.
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores acessaram o conteúdo de vídeo vinculado aos recursos de um proprietário de conteúdo. Por exemplo, ele identifica o número de visualizações que vieram de uma pesquisa no Google ou de um link para um vídeo relacionado.
O id desta versão do relatório é content_owner_asset_traffic_source_a3.
Tipo de dispositivo e sistema operacional
Esse relatório agrega estatísticas de visualização de vídeo com base nos sistemas operacionais e tipos de dispositivos dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows.
O id desta versão do relatório é content_owner_asset_device_os_a3.
Informações demográficas do espectador
Neste relatório, são agregadas as estatísticas de visualização com base na faixa etária e no gênero dos espectadores. O id deste relatório é content_owner_asset_demographics_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gender |
| Métricas: | views_percentage |
Compartilhamento de conteúdo por plataforma
Esse relatório mostra estatísticas sobre a frequência com que os vídeos vinculados aos recursos de um proprietário do conteúdo foram compartilhados em diferentes plataformas sociais. O id deste relatório é content_owner_asset_sharing_service_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métricas: | ações |
Anotações
Esse relatório fornece estatísticas sobre as anotações que aparecem durante os vídeos vinculados aos recursos de um proprietário de conteúdo. Os dados do relatório medem a performance de anotações individuais. Já o relatório de atividade do usuário agrega estatísticas de todas as anotações de um vídeo. O id deste relatório é content_owner_asset_annotations_a1.
Cartões
Esse relatório fornece estatísticas de impressões e cliques para cards que aparecem durante vídeos vinculados aos recursos de um proprietário do conteúdo. Os dados do relatório medem a performance de cards individuais. Já o relatório de atividade do usuário agrega estatísticas de todos os cards exibidos em cada vídeo vinculado a um recurso. O id deste relatório é content_owner_asset_cards_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claimed_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type, card_id |
| Métricas: | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Telas finais
Esse relatório mostra as estatísticas de impressão e taxa de cliques das telas finais que aparecem depois que um vídeo para de ser reproduzido. O relatório contém estatísticas de vídeos reivindicados nos canais de um proprietário do conteúdo e também identifica os recursos associados a eles. O id deste relatório é content_owner_asset_end_screens_a1.
Combinado
Esse relatório fornece estatísticas detalhadas de vídeo combinando dimensões usadas nos relatórios local de reprodução, origem do tráfego e dispositivo/SO.
O id deste relatório é content_owner_asset_combined_a3.