Esta página lista os relatórios que os proprietários do conteúdo podem recuperar com a API YouTube Reporting. O id de cada relatório, conforme retornado pelo método reportTypes.list da API, é exibido 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 todas as atividades dos usuários relacionadas aos vídeos de um canal ou do proprietário do conteúdo. Por exemplo, esses relatórios contêm o número de vezes que seus vídeos foram assistidos.
Atividade do usuário
Este relatório mostra as estatísticas de atividade do usuário relacionadas aos canais do proprietário do conteúdo e os vídeos desses canais. O id da versão atual deste relatório é content_owner_basic_a3.
O id dessa versão do relatório é content_owner_basic_a3. Ele tem as seguintes diferenças em relação à versão a2:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code |
| Métricas: | do zero ou do zero para o usuário do zero |
Observação: o relatório content_owner_basic_a1 foi totalmente descontinuado.
Atividade do usuário por província
Neste relatório, são exibidas as estatísticas da atividade do usuário para estados nos EUA e para o Distrito de Columbia. O id para este relatório é content_owner_province_a2.
O id dessa versão do relatório é content_owner_province_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
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 para este relatório é content_owner_playback_location_a2.
O id dessa versão do relatório é content_owner_playback_location_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na maneira como os espectadores chegaram aos vídeos nos canais do proprietário do conteúdo.
Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado. O id para este relatório é content_owner_traffic_source_a2.
O id dessa versão do relatório é content_owner_traffic_source_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
Tipo de dispositivo e sistema operacional
Este relatório agrega estatísticas de exibição de vídeo com base nos sistemas operacionais dos espectadores e nos tipos de dispositivos. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows. O id para este relatório é content_owner_device_os_a2.
O id dessa versão do relatório é content_owner_device_os_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
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 para este relatório é content_owner_demographics_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group e gender |
| Métricas: | views_percentage (em inglês) |
Compartilhamento de conteúdo por plataforma
Este relatório mostra estatísticas que mostram a frequência com que os vídeos dos canais do proprietário do conteúdo foram compartilhados em diferentes plataformas sociais.
O id para este relatório é content_owner_sharing_service_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métricas: | compartilhamentos |
Anotações
Esse relatório fornece estatísticas para anotações exibidas durante vídeos em canais do proprietário de um conteúdo.
Os dados do relatório medem o desempenho de anotações individuais para cada vídeo. O relatório de atividade do usuário, por outro lado, agrega estatísticas para todas as anotações de um vídeo.
O id para este relatório é content_owner_annotations_a1.
Cards
Este relatório fornece estatísticas de cliques e impressões de cards que são exibidos durante os vídeos nos canais de um proprietário de conteúdo.
Os dados do relatório medem o desempenho de cards individuais. Já o relatório de atividade do usuário agrega estatísticas para todos os cards de um vídeo.
O id para este relatório é content_owner_cards_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claim_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
Este relatório fornece estatísticas de impressões e cliques para telas finais que são exibidas após a interrupção de um vídeo.
O relatório contém estatísticas para vídeos nos canais de um proprietário de conteúdo.
O id para este relatório é content_owner_end_screens_a1.
Legendas
Este relatório mostra estatísticas sobre o idioma das legendas que é usado por mais tempo durante as exibições de vídeos. As visualizações em que as legendas estão desativadas são excluídas. O id para este relatório é content_owner_subtitles_a2.
O id dessa versão do relatório é content_owner_subtitles_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
Combinado
Esse relatório fornece estatísticas de vídeo detalhadas combinando dimensões usadas nos relatórios de local de reprodução, origem de tráfego e dispositivo/SO. O id para este relatório é content_owner_combined_a2.
O id dessa versão do relatório é content_owner_combined_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
Relatórios de playlists
Os relatórios de playlists apresentam estatísticas relacionadas especificamente às exibições de vídeo que ocorrem no contexto de uma playlist.
Atividade do usuário
Este relatório mostra estatísticas relacionadas às interações dos usuários com as playlists nos canais de um proprietário de conteúdo.
O id para este relatório é content_owner_playlist_basic_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code |
| Métricas: | visualizações, 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 estatísticas de atividade dos usuários relacionadas às interações deles com as playlists nos canais de um proprietário de conteúdo para usuários em estados dos EUA e no Distrito de Colúmbia.
Isso significa que o relatório será filtrado para incluir dados somente se o valor da dimensão country_code for US. O id para este relatório é content_owner_playlist_province_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, province_code |
| Métricas: | visualizações, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed. |
Locais de reprodução
Este relatório fornece estatísticas relacionadas ao tipo de página ou aplicativo em que as reproduções da playlist ocorreram. O id para este relatório é content_owner_playlist_playback_location_a1.
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na maneira como os espectadores alcançaram os vídeos da playlist nos canais do proprietário do conteúdo.
Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado. O id para este relatório é content_owner_playlist_traffic_source_a1.
Tipo de dispositivo e sistema operacional
Este relatório agrega estatísticas de visualização da playlist com base nos sistemas operacionais dos espectadores e nos tipos de dispositivo. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows. O id para este relatório é content_owner_playlist_device_os_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, playlist_id, video_id, live_or_on_demand, subscribed_status, country_code, device_type, Operand_system |
| Métricas: | visualizações, watch_time_minutes, average_view_duration_seconds, playlist_starts, playlist_saves_added, playlist_saves_removed. |
Combinado
Esse relatório fornece estatísticas detalhadas da playlist combinando dimensões usadas nos relatórios de local da reprodução, origem do tráfego e dispositivo/SO. O id para este relatório é content_owner_playlist_combined_a1.
Relatórios de taxa de anúncios
Os relatórios de taxa de anúncio fornecem métricas com base em impressões para anúncios que foram exibidos durante as reproduções de vídeo. 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 relatório de taxas de anúncios a seguir, que apresenta métricas relacionadas aos vídeos do proprietário de conteúdo. O id da versão atual deste relatório é content_owner_ad_rates_a1.
O id dessa versão do relatório é content_owner_ad_rates_a1. O ID da versão anterior deste relatório, que agora está totalmente descontinuado, era content_owner_ad_performance_a1.
A única diferença da versão anterior é que esta versão atualiza o nome do relatório para usar a palavra rates em vez da palavra performance. Como resultado, o relatório tem o mesmo número da versão (a1) que a anterior, mas o report ID é diferente.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, claim_status, uploader_type, country_code, ad_type |
| Métricas: | estimated_youtube_ad_revenue, ad_imp, cpm_estimado |
Relatórios de receita estimada
Os relatórios de receita estimada fornecem a receita total estimada dos vídeos provenientes de fontes de publicidade vendidas pelo Google. Esses relatórios também contêm algumas métricas de desempenho do anúncio.
As métricas de ganhos identificam fontes específicas de receita e o valor total da receita acumulado por esses fluxos.
Receita de vídeo estimada
Esse relatório fornece os ganhos totais de todos os vídeos de um proprietário de conteúdo de origens de publicidade vendidas pelo Google, assim como de fontes não publicitárias. Ele também contém algumas métricas de desempenho do anúncio. O id da versão atual deste relatório é content_owner_estimated_revenue_a1.
O id dessa versão do relatório é content_owner_estimated_revenue_a1. Ele tem as seguintes diferenças em relação à versão anterior, que era content_owner_estimated_earnings_a1:
- Adiciona a métrica estimated_partner_red_revenue
- Adiciona a métrica estimated_partner_transaction_revenue
- A métrica estimated_partner_ad_sense_revenue foi renomeada como estimated_partner_ad_leilão_revenue.
- A métrica estimated_partner_double_click_revenue foi renomeada como estimated_partner_ad_reserved_revenue
- Atualiza o nome do relatório para usar a palavra
revenueem vez da palavraearnings. Como resultado, o relatório tem o mesmo número da versão (a1) que a anterior, mas oreport IDé diferente.
Receita de recursos estimada
Esse relatório mostra os ganhos totais de todos os recursos de um proprietário de conteúdo de origens de publicidade vendidas pelo Google, assim como de fontes não publicitárias. Ele também contém algumas métricas de desempenho do anúncio. 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 da versão atual deste relatório é content_owner_asset_estimated_revenue_a1.
O id dessa versão do relatório é content_owner_asset_estimated_revenue_a1. Ele tem as seguintes diferenças em relação à versão anterior, que era content_owner_asset_estimated_earnings_a1:
- Adiciona a métrica estimated_partner_red_revenue
- Adiciona a métrica estimated_partner_transaction_revenue
- A métrica estimated_partner_ad_sense_revenue foi renomeada como estimated_partner_ad_leilão_revenue.
- A métrica estimated_partner_double_click_revenue foi renomeada como estimated_partner_ad_reserved_revenue
- Atualiza o nome do relatório para usar a palavra
revenueem vez da palavraearnings. Como resultado, o relatório tem o mesmo número da versão (a1) que a anterior, mas oreport IDé diferente.
Relatórios de recursos
Os relatórios de recursos apresentam métricas de atividade dos usuários relacionadas aos vídeos vinculados aos recursos dos proprietários de conteúdo. Um vídeo será incluído em um relatório do proprietário do conteúdo se o proprietário do conteúdo tiver reivindicado esse vídeo como correspondente a um dos recursos do proprietário do conteúdo. 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 fez o upload do video_id para o qual as métricas estão sendo fornecidas.
Por exemplo, suponha que em um dia específico, um vídeo seja visualizado 10 vezes, reivindicado depois e visualizado 10 vezes. O relatório de recursos do dia indicará 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 sucessivos devem refletir com precisão a atividade do usuário relacionada ao vídeo reivindicado.
Atividade do usuário
Este relatório mostra estatísticas relacionadas às ações dos usuários nos vídeos vinculados aos recursos de um proprietário de conteúdo. O id para este relatório é content_owner_asset_basic_a2.
O id dessa versão do relatório é content_owner_asset_basic_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code |
| Métricas: | <br>> <ph type> |
Atividade do usuário por província
Neste relatório, são exibidas as estatísticas da atividade do usuário para estados nos EUA e para o Distrito de Columbia. Isso significa que o relatório será filtrado para incluir dados somente se o valor da dimensão country_code for US. O id para este relatório é content_owner_asset_province_a2.
O id dessa versão do relatório é content_owner_asset_province_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
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 para este relatório é content_owner_asset_playback_location_a2.
O id dessa versão do relatório é content_owner_asset_playback_location_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
Origens de tráfego
Este relatório agrega estatísticas de visualização com base na maneira como os espectadores chegaram ao conteúdo de vídeo vinculado aos recursos de um proprietário de conteúdo. Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado. O id para este relatório é content_owner_asset_traffic_source_a2.
O id dessa versão do relatório é content_owner_asset_traffic_source_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, traffic_source_type, {2detail} |
| Métricas: | visualizações, watch_time_minutes, average_view_duration_seconds, average_view_duration_percentage, red_views, red_watch_time_minutes |
Tipo de dispositivo e sistema operacional
Este relatório agrega estatísticas de exibição de vídeo com base nos sistemas operacionais dos espectadores e nos tipos de dispositivos. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows. O id para este relatório é content_owner_asset_device_os_a2.
O id dessa versão do relatório é content_owner_asset_device_os_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes
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 para este relatório é content_owner_asset_demographics_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, age_group, gênero |
| Métricas: | views_percentage (em inglês) |
Compartilhamento de conteúdo por plataforma
Este relatório mostra estatísticas que mostram a frequência com que vídeos vinculados aos recursos de um proprietário de conteúdo foram compartilhados em diferentes plataformas sociais. O id para este relatório é content_owner_asset_sharing_service_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, sharing_service |
| Métricas: | compartilhamentos |
Anotações
Este relatório fornece estatísticas para anotações exibidas durante vídeos vinculados a recursos de um proprietário de conteúdo. Os dados do relatório medem o desempenho de anotações individuais. O relatório de atividade do usuário, por outro lado, agrega estatísticas para todas as anotações de um vídeo. O id para este relatório é content_owner_asset_annotations_a1.
Cards
Este relatório mostra estatísticas de cliques e impressões de cards exibidos durante os vídeos vinculados aos recursos de um proprietário do conteúdo. Os dados do relatório medem o desempenho de cards individuais. O relatório de atividade do usuário, por outro lado, agrega estatísticas para todos os cards exibidos em cada vídeo vinculado a um recurso. O id para este relatório é content_owner_asset_cards_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, card_type_ card |
| Métricas: | card_click_rate, card_teaser_click_rate, card_impressions, card_teaser_impressions, card_clicks, card_teaser_clicks |
Telas finais
Este relatório fornece estatísticas de impressões e cliques para telas finais que são exibidas após a interrupção de um vídeo. O relatório contém estatísticas para vídeos reivindicados nos canais do proprietário de um conteúdo e identifica os recursos associados aos vídeos. O id para este relatório é content_owner_asset_end_screens_a1.
| Índice | |
|---|---|
| Dimensões: | date, channel_id, video_id, asset_id, claim_status, uploader_type, live_or_on_demand, subscribed_status, country_code, end_screen_element_type} |
| Métricas: | end_screen_element_clicks, end_screen_element_impressions e end_screen_element_click_rate |
Combinado
Esse relatório fornece estatísticas de vídeo detalhadas combinando dimensões usadas nos relatórios de local de reprodução, origem de tráfego e dispositivo/SO. O id para este relatório é content_owner_asset_combined_a2.
O id dessa versão do relatório é content_owner_asset_combined_a2. Ele tem as seguintes diferenças em relação à versão a1:
- Adicionar métrica red_views
- Adicionar métrica red_watch_time_minutes