Observação:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
Nesta página, listamos os relatórios que os proprietários de conteúdo podem recuperar com a API YouTube Analytics. Os relatórios de proprietário do conteúdo incluem métricas de canais vinculados a um proprietário de conteúdo específico do YouTube. As métricas são medições individuais da atividade do usuário, da performance do anúncio ou da receita estimada.
-
Os relatórios de vídeo contêm atividade do usuário, performance de anúncios e métricas de receita estimada para vídeos nos canais de um proprietário de conteúdo.
-
Os relatórios de playlists fornecem estatísticas relacionadas especificamente às visualizações de vídeo que ocorrem no contexto de uma playlist. Os relatórios de playlist usam muitas das mesmas dimensões e filtros dos relatórios de vídeo.
-
Os relatórios de performance de anúncios contêm métricas relacionadas à receita e à performance de anúncios. Eles usam a dimensão adType para agrupar métricas com base nos tipos de anúncios veiculados durante as reproduções de vídeo. A seção Relatórios de performance de anúncios explica os dois tipos de métricas de performance de anúncios compatíveis com a API.
Como recuperar um relatório
Para recuperar um relatório do proprietário do conteúdo, chame o método reports.query da API e defina o valor do parâmetro ids na solicitação da API como contentOwner==OWNER_NAME, em que OWNER_NAME especifica o ID do proprietário do conteúdo. Se não tiver certeza, pergunte ao gerente de parcerias.
Autorização
Todas as solicitações da API YouTube Analytics precisam ser autorizadas. O guia de autorização explica como usar o protocolo OAuth 2.0 para recuperar tokens de autorização.
As solicitações da API YouTube Analytics usam os seguintes escopos de autorização:
| Escopos |
| https://www.googleapis.com/auth/yt-analytics.readonly |
Visualizar os relatórios do YouTube Analytics para seu conteúdo do YouTube. Este escopo fornece acesso às métricas de atividade do usuário, como contagens de visualização e de classificação. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
Visualizar os relatórios monetários do YouTube Analytics para seu conteúdo do YouTube. Esse escopo dá acesso a métricas de atividade do usuário e a métricas estimadas de receita e performance de anúncios. |
| https://www.googleapis.com/auth/youtube |
Gerenciar sua conta do YouTube. Na API YouTube Analytics, os proprietários de canais usam esse escopo para gerenciar grupos e itens de grupo do YouTube Analytics. |
| https://www.googleapis.com/auth/youtubepartner |
Ver e gerenciar recursos do YouTube e conteúdo associado na plataforma. Na API YouTube Analytics, os proprietários de conteúdo usam esse escopo para gerenciar grupos e itens de grupo do YouTube Analytics. |
Observação:as métricas marcadas com um asterisco (*) exigem um token de autorização que conceda acesso ao escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Filtros
Todas as solicitações de API para recuperar relatórios de proprietários de conteúdo precisam filtrar os dados usando a dimensão video, a dimensão channel ou uma combinação compatível das dimensões claimedStatus e uploaderType. As combinações compatíveis estão listadas na definição da dimensão uploaderType.
As tabelas que explicam os relatórios compatíveis identificam os filtros que podem ser usados em qualquer relatório. Nas descrições, os filtros entre parênteses são opcionais. Por exemplo, se um relatório listar video(,country) como uma opção de filtragem, ele poderá ser filtrado para incluir apenas dados de um vídeo específico ou de um vídeo específico em um país específico.
A API também permite especificar vários valores para os filtros video, playlist e channel. Se você especificar vários valores para um desses filtros, também poderá adicioná-lo à lista de dimensões especificada para a solicitação. Isso é válido mesmo que o filtro não esteja listado como uma dimensão compatível para um determinado relatório.
Consulte a definição do parâmetro filters para uma explicação completa de como filtrar os resultados da API para um valor ou conjunto de valores específico.
Como entender as tabelas de relatórios
Esta seção explica a formatação e a terminologia usadas nas tabelas que definem os relatórios compatíveis com a API. A tabela a seguir lista as dimensões, métricas e filtros compatíveis com o relatório de detalhes da reprodução usando a dimensão de tempo e a métrica averageViewPercentage.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
A tabela contém duas linhas para dimensões, uma linha para métricas e três linhas para filtros. Para dimensões e filtros, os valores de cada linha podem ser combinados em uma solicitação de API, desde que a combinação siga as regras de uso na tabela. Por exemplo, os valores de parâmetro dimensions válidos para esse relatório incluem:
dimensions=daydimensions=day,subscribedStatusdimensions=month,subscribedStatus,youtubeProductdimensions=month,youtubeProduct
No entanto, o valor do parâmetro day,month é inválido porque usa duas dimensões baseadas em tempo, e a solicitação precisa usar 0 ou 1.
Terminologia da tabela de relatório
As tabelas usam a seguinte terminologia para indicar se as dimensões são obrigatórias ou opcionais:
- Estes termos significam que um valor é obrigatório:
- Obrigatório:é necessário incluir o valor.
- Use exatamente 1:é necessário incluir um valor do grupo.
- Use um ou mais: é possível incluir qualquer valor do grupo ou todos eles, mas é necessário incluir pelo menos um.
- Estes termos significam que um valor é opcional:
- Opcional:você pode incluir o valor.
- Use 0 ou 1:você pode incluir um valor do grupo.
- Use 0 ou mais:você pode incluir qualquer valor do grupo ou todos eles.
Importante:todas as solicitações de API para recuperar relatórios de vídeo de proprietários de conteúdo precisam filtrar os dados usando a dimensão
vídeo,
canal,
grupo ou uma combinação compatível das dimensões
claimedStatus e
uploaderType. Alguns relatórios não são compatíveis com todas essas opções. As combinações compatíveis, que também estão listadas na definição da dimensão
uploaderType, são:
uploaderType==selfclaimedStatus==claimedclaimedStatus==claimed;uploaderType==selfclaimedStatus==claimed;uploaderType==thirdParty
Relatórios de vídeo
Estatísticas básicas
Estatísticas básicas (incluindo contagem de inscritos)
Esse relatório fornece estatísticas relacionadas às ações dos usuários em todos os canais de um proprietário de conteúdo. É possível filtrar o relatório para retornar somente os dados de um vídeo ou país específicos. Também pode ser usado para recuperar apenas estatísticas de conteúdo reivindicado, incluindo conteúdo reivindicado enviado pelo proprietário do conteúdo, por terceiros ou por ambos.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtros: |
|
Estatísticas básicas dos estados dos EUA
Neste relatório, são exibidas as estatísticas para um estado específico nos EUA ou para o Distrito de Columbia. Ele é compatível apenas com um subconjunto das métricas disponíveis no relatório de país específico descrito acima.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
Por períodos
Atividade por períodos
Esse relatório fornece estatísticas relacionadas às ações dos usuários em todos os canais de um proprietário de conteúdo em intervalos de tempo específicos. É possível filtrar o relatório para retornar somente os dados de um vídeo ou país específicos.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtros: |
|
Atividade do usuário em estados nos EUA em períodos específicos
Neste relatório, são exibidas as estatísticas para um estado específico nos EUA ou para o Distrito de Columbia. Ele é compatível apenas com um subconjunto das métricas disponíveis no relatório de país específico descrito acima.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
Localização do usuário
Atividade do usuário por país
Esse relatório fornece estatísticas relacionadas à atividade do usuário em cada país para todos os canais de um proprietário de conteúdo. É possível filtrar o relatório para retornar apenas dados de um vídeo ou canal específico.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtros: |
|
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. Para esse relatório, defina o valor do parâmetro filters como country==US.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
Atividade do usuário por cidade (<= 250 resultados)
Observação:para gerar esse relatório, defina o parâmetro maxResults como um valor inteiro de 250 ou menos. Ao contrário da maioria dos outros relatórios, este também exige que você especifique um valor para o parâmetro de solicitação sort.
Este relatório mostra as estatísticas de atividade do usuário por cidade.
Detalhes da reprodução
Os relatórios detalhados de reprodução fornecem estatísticas relacionadas aos seguintes atributos de visualização:
- A visualização foi de uma transmissão ao vivo ou de um vídeo on demand?
- O espectador era inscrito no canal que é proprietário do vídeo?
- Em qual produto do YouTube a visualização ocorreu?
Tecnicamente, as dimensões de detalhes de reprodução compatíveis com esses relatórios são opcionais. Se você não incluir dimensões de detalhes de reprodução na sua solicitação, o relatório retornado será semelhante a um dos relatórios de estatísticas básicas, com base no tempo ou geografia do usuário.
Observação:a dimensão e o filtro liveOrOnDemand não podem ser usados com a métrica averageViewPercentage. Por isso, cada uma das subseções a seguir lista dois relatórios. Um relatório é compatível com a dimensão (e filtro) liveOrOnDemand, enquanto o outro é compatível com a métrica averageViewPercentage.
Atividade do usuário por status de inscrição
Esse relatório fornece métricas de atividade do usuário para espectadores inscritos e não inscritos. As estatísticas podem ser agrupadas por período (dia ou mês), e o relatório também pode ser filtrado por país, continente ou subContinent.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
Atividade do usuário por status de inscrição para províncias
Esse relatório fornece métricas de atividade do usuário para espectadores inscritos e não inscritos nos estados dos EUA ou no Distrito de Columbia. Esse relatório é compatível com menos métricas do que o anterior.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
Detalhes da reprodução com dimensão de tempo opcional
A dimensão de tempo (dia ou mês) é opcional para esses relatórios porque, de qualquer forma, você precisa usar os parâmetros de solicitação startDate e endDate para especificar o período que o relatório vai abranger. A dimensão, se presente, indica que você quer que os dados no relatório sejam agregados por dia, mês etc.
Detalhes da reprodução com dimensão de tempo opcional e estatísticas liveOrOnDemand
Esse relatório fornece estatísticas detalhadas de reprodução para intervalos de tempo específicos. Ela é compatível com a dimensão (e filtro) liveOrOnDemand.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes da reprodução com dimensão de tempo opcional e métrica averageViewPercentage
Esse relatório fornece estatísticas detalhadas de reprodução para intervalos de tempo específicos.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes da reprodução por país
Detalhes da reprodução por país com estatísticas liveOrOnDemand
Esse relatório fornece estatísticas detalhadas de reprodução em cada país. Ela é compatível com a dimensão (e filtro) liveOrOnDemand.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes da reprodução por país com a métrica averageViewPercentage
O relatório a seguir é semelhante ao anterior. Ela adiciona suporte à métrica averageViewPercentage, mas não é compatível com liveOrOnDemand como dimensão ou filtro.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes da reprodução por província
Detalhes da reprodução por província com estatísticas de liveOrOnDemand
Esse relatório fornece estatísticas detalhadas de reprodução para os estados dos EUA e o Distrito de Columbia. Ela é compatível com a dimensão (e filtro) liveOrOnDemand.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes da reprodução por província com a métrica averageViewPercentage
O relatório a seguir é semelhante ao anterior. Ela adiciona suporte à métrica averageViewPercentage, mas não é compatível com liveOrOnDemand como dimensão ou filtro.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Locais de reprodução
Relatório do local 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.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes do local da visualização (<= 25 resultados)
Observação:para gerar esse relatório, defina o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, este também exige que você especifique um valor para o parâmetro de solicitação sort.
Esse relatório identifica os players de vídeo incorporados que geraram mais visualizações ou tempo de exibição para o conteúdo de um proprietário. Ao extrair esse relatório, defina o filtro insightPlaybackLocationType como EMBEDDED.
Origens de tráfego
Origem do tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores encontraram seu conteúdo de vídeo. Por exemplo, ele identifica o número de visualizações que surgiram de uma pesquisa do Google ou de um link para um vídeo relacionado.
Observação:esse relatório retorna um erro se o produto de número de vídeos consultados X número de dias no período exceder 50.000. Por exemplo, uma consulta que recupera dados de 500 IDs de vídeo pode solicitar dados de até 100 dias. Para reduzir o número de linhas retornadas por uma solicitação, divida a consulta em várias que especifiquem menos vídeos ou definam períodos mais curtos.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes da origem do tráfego (<= 25 resultados)
Observação:para gerar esse relatório, defina o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, este também exige que você especifique um valor para o parâmetro de solicitação sort.
Esse relatório agrega estatísticas de visualização com base nos referenciadores que geraram mais visualizações para o conteúdo do proprietário. Os referenciadores são categorizados por tipo de origem do tráfego, e na definição da dimensão insightTrafficSourceDetail são identificadas as origens do tráfego para o qual o relatório está disponível. Por exemplo, se você definir o filtro insightTrafficSourceType como ADVERTISING, o relatório vai listar os tipos de anúncios que geraram mais visualizações ou tempo de exibição para o conteúdo do proprietário.
Nota: este relatório é compatível apenas com origens do tráfego específicas. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES e NO_LINK_EMBEDDED são algumas das origens de tráfego não compatíveis.
Tipo de dispositivo e sistema operacional
Tipo de dispositivo
Esse relatório agrega estatísticas de visualização com base no tipo de dispositivo usado pelos espectadores para assistir seu conteúdo. Por exemplo, ele identifica o número de visualizações que ocorreram em tablets ou consoles de jogos.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Sistema operacional
Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em dispositivos Android ou em PlayStations.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Sistema operacional e tipo de dispositivo
Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais e nos tipos de dispositivo dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
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.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Engajamento e compartilhamento de conteúdo
Neste relatório, são exibidas as estatísticas da frequência em que vídeos do canal foram compartilhados em diferentes plataformas sociais.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Retenção de público
Esse relatório mede a capacidade de um vídeo de reter o público. A dimensão elapsedVideoTimeRatio mede a quantidade de vídeo que passou para os valores de métrica correspondentes. As métricas audienceWatchRatio e relativeRetentionPerformance oferecem duas medidas que mostram a eficiência do vídeo em manter o público. O primeiro é um valor absoluto, enquanto o segundo mostra o desempenho do vídeo em relação a outros vídeos do YouTube de duração semelhante.
Observação:os relatórios de retenção de público-alvo não permitem especificar uma lista de valores separados por vírgula para o filtro video. O valor precisa especificar um único ID de vídeo.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Vídeos mais acessados
Observação:esses relatórios exigem que você defina o parâmetro maxResults como um valor inteiro de 200 ou menos. Os dados anteriores a 1º de janeiro de 2013 estão disponíveis apenas para os 10 principais vídeos. Ao contrário da maioria dos outros relatórios, esses também exigem que você especifique um valor para o parâmetro de solicitação sort.
Os melhores vídeos no geral, por país, por continente ou por subcontinente (<= 200 resultados)
Esse relatório lista os principais vídeos do proprietário do conteúdo com base nos critérios de filtragem e classificação especificados.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm* |
|
| Filtros: |
|
| Opções de classificação: |
-engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost |
Vídeos em alta no geral por estado dos EUA (até 200 resultados)
Esse relatório lista os principais vídeos do proprietário de conteúdo em um estado específico dos EUA ou em Washington DC. Ele é compatível apenas com um subconjunto das métricas disponíveis no relatório de país específico descrito acima.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
| Opções de classificação: |
-engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Vídeos em alta para espectadores inscritos ou não inscritos(<= 200 resultados)
Esse relatório lista os principais vídeos para espectadores inscritos ou não inscritos. O relatório pode ser filtrado para listar os principais vídeos por país, continente ou subContinent. O relatório anterior permite recuperar os vídeos mais assistidos em um determinado estado dos EUA para espectadores inscritos ou não inscritos, mas oferece suporte a menos métricas do que este.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks |
|
| Filtros: |
|
| Opções de classificação: |
-engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched |
Principais vídeos por produto do YouTube (<= 200 resultados)
Ele lista os principais vídeos e é compatível com filtros geográficos e de detalhes de reprodução. Esse relatório é semelhante ao anterior, mas oferece suporte a menos métricas e adiciona suporte ao filtro youtubeProduct.
Principais vídeos com filtros de detalhes da reprodução (<= 200 resultados)
Esse relatório lista os principais vídeos do proprietário do conteúdo, filtrando por uma ou mais dimensões de detalhes da reprodução: liveOrOnDemand, subscribedStatus e youtubeProduct. O relatório também permite filtrar por região.
Relatórios de playlists
Os relatórios de playlists contêm métricas relacionadas à atividade do usuário em vídeos nas playlists do proprietário do canal. Duas versões desses relatórios estão disponíveis. Para cada uma delas, as seções a seguir contêm uma descrição:
Métricas de vídeo agregadas
Essas métricas fornecem dados de atividade do usuário e de impressão agregados para todos os vídeos da playlist que também pertencem ao canal dela. As métricas de vídeos de outros canais não são calculadas na agregação. Por isso, se um canal criar uma playlist que contenha apenas vídeos de outros canais, os relatórios dessas playlists não vão fornecer valores para essas métricas.
Consulte a seção Métricas de playlist compatíveis para ver uma lista
de métricas de vídeo agregadas que o YouTube aceita.
Métricas na playlist
Essas métricas refletem a atividade e o engajamento do usuário no contexto da página da playlist. Essas métricas incluem visualizações de todos os vídeos da playlist, não importa de qual canal eles sejam, mas contam apenas as visualizações que ocorreram no contexto da playlist.
Métricas de playlist compatíveis
Estatísticas básicas
Esse relatório fornece estatísticas relacionadas às interações dos usuários com os vídeos nas playlists dos canais de um proprietário do conteúdo. O relatório não tem as dimensões necessárias.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtros: |
|
Por períodos
Esse relatório fornece estatísticas relacionadas às interações dos usuários com os vídeos nas playlists dos canais de um proprietário de conteúdo em intervalos de tempo específicos. Você pode filtrar o relatório para retornar apenas dados de uma playlist ou canal específico.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtros: |
|
Localização do usuário
Esse relatório fornece estatísticas relacionadas às interações dos usuários de um determinado país com os vídeos nas playlists do canal.
Esse relatório mostra as estatísticas de playlists por país.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Atividade da playlist por província
Este relatório mostra as estatísticas de atividade das playlists nos estados dos EUA e no Distrito de Columbia. Para esse relatório, inclua country==US no valor do parâmetro filters.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
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.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Detalhes do local da visualização (<= 25 resultados)
Observação:para gerar esse relatório, defina o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, este também exige que você especifique um valor para o parâmetro de solicitação sort.
Esse relatório identifica os players de vídeo incorporados que geraram mais visualizações ou tempo de exibição para as playlists de um proprietário de conteúdo.
Origens de tráfego
Esse relatório agrega estatísticas de visualização com base na forma como os espectadores acessaram o conteúdo da sua playlist. Por exemplo, ele identifica o número de visualizações que surgiram de uma pesquisa do Google ou da página de um canal.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtros: |
|
Detalhes da origem do tráfego (<= 25 resultados)
Observação:para gerar esse relatório, defina o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, este também exige que você especifique um valor para o parâmetro de solicitação sort.
Esse relatório agrega estatísticas de visualização com base nos referenciadores que geraram mais visualizações para as playlists do proprietário do conteúdo. Os referenciadores são categorizados por tipo de origem do tráfego, e na definição da dimensão insightTrafficSourceDetail são identificadas as origens do tráfego para o qual o relatório está disponível. Por exemplo, se você definir o filtro insightTrafficSourceType como ADVERTISING, o relatório vai listar os tipos de anúncios que geraram mais visualizações ou tempo de exibição para as playlists do proprietário do conteúdo.
| Índice |
| Dimensões: |
|
| Métricas: |
| Use 1 ou mais |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
| Filtros: |
|
| Opções de classificação: |
-playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts |
Nota: este relatório é compatível apenas com origens do tráfego específicas. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES e NO_LINK_EMBEDDED são algumas das origens de tráfego não compatíveis.
Tipo de dispositivo e sistema operacional
Tipo de dispositivo para playlists
Esse relatório agrega estatísticas de visualização com base no tipo de dispositivo usado pelos espectadores para assistir o conteúdo da playlist. Por exemplo, ele identifica o número de visualizações que ocorreram em dispositivos móveis ou consoles de jogos.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Sistema operacional para playlists
Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais dos espectadores. Por exemplo, ele identifica o número de visualizações de playlists que ocorreram em dispositivos Android ou em PlayStations.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Sistema operacional e tipo de dispositivo para playlists
Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais e nos tipos de dispositivo dos espectadores. Por exemplo, ele identifica o número de visualizações de playlists que ocorreram em tablets Android ou em computadores Windows.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
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.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
Observação:os valores de
viewerPercentage neste relatório não são normalizados para diferentes valores ou combinações de valores das dimensões de detalhes da reprodução (
subscribedStatus e
youtubeProduct).
Por exemplo, um relatório que usa a dimensão
subscribedStatus retorna dados de
viewerPercentage que somam 100% para visualizações de inscritos
e dados de
viewerPercentage que somam 100% para visualizações de não inscritos. O valor total de todos os campos
viewerPercentage no relatório é de 200%.
Use filtros para garantir que o relatório contenha apenas dados de
viewerPercentage para um valor (ou combinação de valores) das dimensões de detalhes da reprodução.
Playlists mais acessadas
Observação:esses relatórios exigem que você defina o parâmetro maxResults como um valor inteiro de 200 ou menos. Os dados anteriores a 1º de janeiro de 2013 estão disponíveis apenas para as 10 principais playlists. Ao contrário da maioria dos outros relatórios, esses também exigem que você especifique um valor para o parâmetro de solicitação sort.
Esse relatório lista as principais playlists do proprietário do conteúdo com base nos critérios de filtragem e classificação especificados.
Observação:os relatórios de performance de anúncios exigem um token de autorização que conceda acesso ao escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Os relatórios de performance de anúncios fornecem métricas com base 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.
As métricas de performance de anúncios com base em impressões são:
Além disso, alguns relatórios de vídeo oferecem suporte às seguintes métricas de performance de anúncios com base na reprodução. No entanto, essas métricas não são incluídas nos relatórios de performance de anúncios.
| Índice |
| Dimensões: |
|
| Métricas: |
|
| Filtros: |
|
