Neste documento, definimos as métricas que podem ser recuperadas usando a API YouTube Analytics. Essa API permite consultas em tempo real para gerar relatórios personalizados do YouTube Analytics.
As métricas são medições individuais da atividade do usuário, da performance do anúncio ou da receita estimada. As métricas de atividade do usuário incluem contagens de visualizações de vídeos e avaliações (marcações "Gostei" e "Não gostei").
Métricas principais
Embora a API YouTube Analytics esteja sujeita à política de descontinuação definida nos Termos de Serviço, as métricas e dimensões não essenciais não estão sujeitas a essa política. Nas definições desta página, qualquer métrica principal é explicitamente identificada como tal.
A lista abaixo identifica as principais métricas da API.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
Consulte a lista de APIs do YouTube sujeitas à política de descontinuação para mais informações.
Ver métricas
- engagedViews (métrica principal)
- É o número de vezes que os vídeos do canal foram assistidos além do primeiro frame ou que o usuário clicou/tocou para reproduzir.
- visualizações (métrica principal)
- Essa métrica representa números diferentes em tipos de relatórios distintos. Essa métrica inclui covisualizações quando várias pessoas assistem juntas em uma tela de TV.
This is a core metric and is subject to the Deprecation Policy.
- playlistViews
- Essa métrica é definida na seção Métricas de playlist.
- redViews
- O número de vezes que um vídeo foi assistido por assinantes do YouTube Premium (antes conhecido como YouTube Red).
- viewerPercentage (métrica principal)
- A porcentagem de espectadores que estavam conectados ao assistir o vídeo ou a playlist. This is a core metric and is subject to the Deprecation Policy.
Métricas de tempo de exibição
- estimatedMinutesWatched (métrica principal)
- O número de minutos que os usuários assistiram de vídeos do canal, proprietário do conteúdo, vídeo ou playlist especificado. Essa métrica inclui covisualizações quando várias pessoas assistem juntas em uma tela de TV. This is a core metric and is subject to the Deprecation Policy.
- estimatedRedMinutesWatched
- O número de minutos que os assinantes do YouTube Premium (antes conhecido como YouTube Red) assistiram um vídeo.
- averageViewDuration (métrica principal)
- A duração média, em segundos, das exibições de vídeo. Desde 13 de dezembro de 2021, essa métrica exclui o tráfego de clipes em loop. Em um relatório de playlist, a métrica indica a duração média, em segundos, das reproduções de vídeo que ocorreram no contexto de uma playlist. This is a core metric and is subject to the Deprecation Policy.
- averageViewPercentage
- A porcentagem média de um vídeo assistida durante uma reprodução. Desde 13 de dezembro de 2021, essa métrica exclui o tráfego de clipes em loop.
Métricas de engajamento
- comentários (métrica principal)
- O número de vezes que os usuários comentaram em um vídeo. Veja mais informações na Central de Ajuda do YouTube. This is a core metric and is subject to the Deprecation Policy.
- marcações "Gostei" (métrica principal)
- A quantidade de vezes que os usuários indicaram que gostaram de um vídeo atribuindo uma classificação positiva. This is a core metric and is subject to the Deprecation Policy.
- dislikes (métrica principal)
- A quantidade de vezes que os usuários indicaram que não gostaram de um vídeo atribuindo uma classificação negativa. This is a core metric and is subject to the Deprecation Policy.
- O número de vezes que os usuários compartilharam um vídeo usando o botão
Share. Veja mais informações na Central de Ajuda do YouTube. This is a core metric and is subject to the Deprecation Policy. - subscribersGained (métrica principal)
- O número de vezes que os usuários se inscreveram em um canal. This is a core metric and is subject to the Deprecation Policy.
Os canais podem ganhar ou perder inscritos em vários lugares, incluindo a página de exibição do vídeo, a página do canal e o guia que aparece na página inicial do YouTube. Nos relatórios do canal, essas métricas incluem inscritos conquistados em qualquer um desses lugares. No entanto, em relatórios que usam a dimensãovideoou o parâmetrofilterpara restringir a resposta e incluir apenas dados de um vídeo específico, a métricasubscribersGainedvai incluir apenas estatísticas da página de exibição do vídeo especificado. - subscribersLost (métrica principal)
- O número de vezes que os usuários cancelaram a inscrição em um canal. This is a core metric and is subject to the Deprecation Policy.
Os dados dessa métrica são informados de maneira semelhante à métricasubscribersGained. Nos relatórios do canal, esta métrica inclui a quantidade de inscritos perdidos por meio de qualquer mecanismo em que o usuário pode cancelar a inscrição. No entanto, nos relatórios que usam a dimensãovideoou o parâmetrofilterpara restringir a resposta e incluir apenas dados de um vídeo específico, essa métrica inclui apenas os usuários que cancelaram a inscrição na página de exibição do vídeo especificado. - videosAddedToPlaylists
- O número de vezes que os vídeos foram adicionados a qualquer playlist do YouTube. Os vídeos podem ter sido adicionados à playlist do proprietário do vídeo ou de outros canais.
O valor da métrica inclui o número de vezes que os vídeos foram adicionados a playlists padrão, como "Assistir mais tarde". No entanto, ela não conta as playlists em que um vídeo é adicionado automaticamente, como a playlist de envios de um canal ou o histórico de exibição de um usuário.
Essa métrica retorna um número absoluto, o que significa que, se um usuário adicionar um vídeo a uma playlist, removê-lo e adicioná-lo novamente, o valor da métrica vai refletir que o vídeo foi adicionado a uma playlist duas vezes. Os dados dessa métrica não estão disponíveis para datas anteriores a 1º de outubro de 2014. - videosRemovedFromPlaylists
- O número de vezes que os vídeos foram removidos de qualquer playlist do YouTube. Os vídeos podem ter sido removidos da playlist do proprietário ou de outros canais.
O valor da métrica inclui o número de vezes que os vídeos foram removidos de playlists padrão, como "Assistir mais tarde".
Essa métrica retorna um número absoluto. Isso significa que, se um usuário adicionar um vídeo a uma playlist, removê-lo, adicioná-lo novamente e removê-lo de novo, o valor da métrica vai refletir que o vídeo foi removido de uma playlist duas vezes. Os dados dessa métrica não estão disponíveis para datas anteriores a 1º de outubro de 2014.
Métricas de playlists
Os relatórios de playlist contêm dois tipos de métricas que explicam como os espectadores interagem com os vídeos em uma playlist:
-
As métricas de vídeo agregadas fornecem métricas de atividade do usuário e de impressões agregadas para todos os vídeos na playlist que também pertencem ao canal que é proprietário da playlist. As métricas de vídeos de outros canais não são calculadas na agregação. Como resultado, 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 as seções métricas de visualização e métricas de tempo de exibição deste documento para ver as definições das métricas de vídeo agregadas compatíveis.
-
As métricas na playlist refletem a atividade do usuário e o engajamento no contexto da página da playlist. Essas métricas incluem visualizações de todos os vídeos na playlist, independentemente do canal proprietário, mas só contam as visualizações que ocorreram no contexto da playlist.
A maioria das métricas a seguir é de playlist. As outras, como
playlistSaves, são sobre as interações do usuário com a playlist em si, e
não com os vídeos dela. Por isso, essas métricas não seriam caracterizadas como
métricas de vídeo agregadas ou métricas na playlist.
- averageTimeInPlaylist
- O tempo médio estimado, em minutos, que um espectador assistiu vídeos em uma playlist
depois que ela foi iniciada. Essa métrica inclui apenas as visualizações de playlists que
ocorreram na Web.
- playlistAverageViewDuration
- A duração média estimada, em segundos, assistida por visualização da playlist. Essa métrica
representa a duração média das visualizações de vídeos individuais em uma playlist. Já a
métrica
averageTimeInPlaylistrepresenta o tempo médio que cada espectador passa assistindo a playlist como um todo. Essa métrica inclui dados de vídeos da playlist que pertencem a outros canais. - playlistEstimatedMinutesWatched
- O número de minutos que os usuários assistiram o conteúdo como parte da playlist. O tempo de exibição
que ocorreu em outros contextos, como as visualizações que ocorreram quando
os espectadores estavam assistindo o mesmo vídeo como parte de outras playlists, não é contabilizado. Essa métrica
inclui dados de vídeos de playlists que pertencem a outros canais.
- playlistSaves
- O número líquido de vezes que os usuários salvaram uma playlist. Acesse a
Central de Ajuda do YouTube para mais
informações sobre playlists salvas. Essa métrica retorna um número de mudança líquida. Ou seja, se um
usuário salvar uma playlist, removê-la da lista de playlists salvas e salvá-la novamente, o
valor da métrica vai refletir uma playlist salva adicionada.
- playlistStarts
- O número de vezes que os espectadores iniciaram uma playlist. Essa métrica
inclui apenas as visualizações de playlists que ocorreram na Web.
- playlistViews
- O número de vezes que os vídeos na playlist foram assistidos no contexto dessa playlist.
Essa métrica inclui dados de vídeos de playlists que pertencem a outros canais.
- viewsPerPlaylistStart
- O número médio de visualizações de vídeo que ocorreram cada vez que uma playlist foi iniciada. Essa métrica inclui apenas as visualizações de playlists que ocorreram na Web.
Métricas de anotações
Observação: os relatórios da API YouTube Analytics só retornam dados das métricas annotationClickThroughRate e annotationCloseRate a partir de 10 de junho de 2012. Além disso, os relatórios da API YouTube Analytics só retornam dados das métricas de anotação restantes a partir de 16 de julho de 2013.
- annotationImpressions
- O número total de impressões de anotações.
- annotationClickableImpressions
- O número de anotações que apareceram e poderiam ser clicadas.
- annotationClicks
- O número de anotações clicadas.
- annotationClickThroughRate (métrica principal)
- A proporção de anotações em que os espectadores clicaram em relação ao número total de impressões de anotações clicáveis. This is a core metric and is subject to the Deprecation Policy. A Central de Ajuda do YouTube tem mais informações sobre como criar anotações e usar anotações de link.
- annotationClosableImpressions
- O número de anotações que apareceram e puderam ser fechadas.
- annotationCloses
- O número de anotações fechadas.
- annotationCloseRate (métrica principal)
- A proporção de anotações que os espectadores fecharam em relação ao número total de impressões de anotações. This is a core metric and is subject to the Deprecation Policy.
Métricas do card
A Central de Ajuda do YouTube contém instruções mais detalhadas sobre como adicionar cards aos seus vídeos e o Relatório de cards do YouTube Analytics.
- cardImpressions
- O número de vezes que os cards foram mostrados. Quando o painel de cards é aberto, uma impressão é registrada para cada um dos cards do vídeo.
- cardClicks
- O número de vezes que os cards foram clicados.
- cardClickRate
- A taxa de cliques dos cards, que é calculada como a proporção de cliques em relação às impressões dos cards.
- O número de vezes que os teasers de cards foram mostrados. Uma visualização de vídeo pode gerar várias impressões de teaser.
- O número de cliques em teasers de cards. Os cliques no ícone do card são atribuídos ao último teaser exibido para o usuário.
- A taxa de cliques dos teasers de card, que é calculada como a proporção de cliques em teasers de card em relação ao número total de impressões de teasers de card.
Métricas de transmissão ao vivo (espectadores simultâneos)
- averageConcurrentViewers
- O número médio de espectadores simultâneos de um vídeo específico. Essa métrica inclui
covisualizadores quando várias pessoas assistem juntas em uma tela de TV. Se a dimensão livestreamPosition
for especificada para o relatório, o valor
averageConcurrentViewersvai especificar o número médio de espectadores simultâneos durante um segmento específico .
- peakConcurrentViewers
- O número máximo de espectadores simultâneos de um vídeo específico. Essa métrica inclui
covisualizadores quando várias pessoas assistem juntas em uma tela de televisão. Se a dimensão livestreamPosition
for especificada para o relatório, o valor
peakConcurrentViewersespecificará o número máximo de espectadores simultâneos durante um segmento específico do vídeo.
Métricas de retenção de público
- audienceWatchRatio
- A proporção absoluta de espectadores que assistiram ao vídeo em um determinado momento. A proporção é calculada comparando o número de vezes que uma parte de um vídeo foi assistida com o número total de visualizações do vídeo. A dimensão
elapsedVideoTimeRatioidentifica a parte do vídeo a que a métrica corresponde.
Observação: uma parte de um vídeo pode ser assistida mais de uma vez (ou nenhuma) em uma determinada exibição de vídeo. Por exemplo, se os usuários voltarem e assistirem à mesma parte de um vídeo várias vezes, a proporção absoluta dessa parte poderá ser maior que1.
Os exemplos a seguir mostram como o valor é calculado:- Um vídeo de um minuto é assistido 100 vezes. Metade dos espectadores para de assistir após 15 segundos, e o restante assiste o vídeo inteiro. Nenhum dos espectadores assiste a qualquer parte do vídeo mais de uma vez. Nesse caso, o valor dessa métrica seria
1para os períodos no primeiro quarto do vídeo e0.50para o restante do vídeo. - Um vídeo de um minuto é assistido 100 vezes. Todos os espectadores assistem o vídeo inteiro, mas 20 deles assistem até os 45 segundos, voltam para os 30 segundos e assistem o restante do vídeo. Nesse caso, o valor da métrica seria
1para os períodos na primeira metade ou no último quarto do vídeo. No entanto, o valor seria1.2para os períodos no terceiro trimestre do vídeo, já que 100% dos espectadores assistiram a esse segmento do vídeo, mas 20% deles assistiram ao segmento duas vezes.
- Um vídeo de um minuto é assistido 100 vezes. Metade dos espectadores para de assistir após 15 segundos, e o restante assiste o vídeo inteiro. Nenhum dos espectadores assiste a qualquer parte do vídeo mais de uma vez. Nesse caso, o valor dessa métrica seria
- relativeRetentionPerformance
- Uma métrica que mostra a capacidade de um vídeo de reter espectadores durante as visualizações em comparação com todos os vídeos do YouTube de duração semelhante. A métrica tem um valor entre
0e1que identifica o desempenho relativo de retenção do vídeo em um determinado momento. O ponto no vídeo é fornecido pela dimensãoelapsedVideoTimeRatio.
Um valor de0indica que o vídeo retém os espectadores pior do que qualquer outro vídeo de duração semelhante, enquanto um valor de1indica que o vídeo retém os espectadores melhor do que qualquer outro vídeo de duração semelhante. Um valor mediano de0.5indica que metade dos vídeos de duração semelhante retém melhor os espectadores, enquanto a outra metade retém pior.
O exemplo hipotético a seguir ilustra como os valores podem aparecer em um relatório. Em média, 90% dos espectadores que assistem vídeos de 10 minutos ainda estão assistindo após três minutos, e 70% ainda estão assistindo após oito minutos. No entanto, em um vídeo específico de 10 minutos, apenas 80% dos espectadores continuam assistindo após três minutos, mas todos eles continuam assistindo após oito minutos.- No valor de
elapsedVideoTimeRatioque corresponde ao ponto de três minutos do vídeo, a métricarelativeRetentionPerformanceteria um valor abaixo de0.5, já que, nesse momento, o vídeo tem uma performance pior do que a média. - No valor de
elapsedVideoTimeRatiocorrespondente ao ponto de oito minutos do vídeo, a métricarelativeRetentionPerformanceteria um valor maior que0.5, já que, nesse momento, o vídeo está com uma performance melhor do que outros de duração semelhante.
- No valor de
- startedWatching
- O número de vezes que um segmento específico do vídeo foi o primeiro segmento visto durante uma
reprodução de vídeo.
Por exemplo, imagine que o Vídeo X tenha 5 minutos de duração. Para os fins deste relatório, o YouTube divide o vídeo em 100 segmentos de 3 segundos, que são identificados com a dimensão elapsedVideoTimeRatio. Um espectador acessa o YouTube e assiste ao primeiro minuto e dez segundos do vídeo, que inclui todos ou parte dos primeiros 24 segmentos do vídeo. Em uma visita posterior ao YouTube, o espectador assiste ao restante do vídeo, retomando a reprodução no segmento 24 e continuando até o segmento 100.
Esse exemplo produziria os seguintes valores de métrica de exibição:- O valor da métrica
startedWatchingseria1para os segmentos 1 e 24, e o valor da métrica seria0para todos os outros segmentos. - O valor da métrica
stoppedWatchingseria1para os segmentos 24 e 100, e o valor da métrica seria0para todos os outros segmentos. - O valor da métrica
totalSegmentImpressionsseria2para o segmento 24, e o valor da métrica seria1para todos os outros segmentos.
- O valor da métrica
- stoppedWatching
- O número de vezes que um determinado segmento do vídeo foi o último visto durante uma
reprodução. Consulte a definição da métrica
startedWatchingpara ver um exemplo de como esse valor é calculado. - totalSegmentImpressions
- O número de vezes que um trecho específico de um vídeo foi assistido. Consulte a definição da métrica
startedWatchingpara ver um exemplo de como esse valor é calculado. Um espectador pode assistir o mesmo segmento de um vídeo várias vezes na mesma reprodução.
Métricas de cancelamento de assinaturas
- membershipsCancellationSurveyResponses
- O número de pesquisas respondidas por usuários do YouTube que cancelaram o Clube do Canal especificado durante o período do relatório.
Métricas de receita estimada
Observação: as métricas de receita estimada estão sujeitas a ajustes no final do mês e não incluem publicidade vendida e veiculada por parceiros. Consulte a Central de Ajuda do YouTube para mais informações e observações sobre os números de receita estimada.
currency para algumas métricas de receita estimada e performance do anúncio, permitindo que você recupere dados de receita estimada em outras moedas.- estimatedRevenue (métrica principal) (antes chamada de
earnings) - A receita líquida total estimada de todas as fontes de publicidade vendidas pelo Google e de fontes não publicitárias para o período e a região selecionados.
This is a core metric and is subject to the Deprecation Policy.
As métricas de receita estimada estão sujeitas a ajustes no final do mês e não incluem publicidade vendida e veiculada por parceiros.
- estimatedAdRevenue (anteriormente chamado de
adEarnings) - A receita líquida total estimada de todas as fontes de publicidade vendidas pelo Google para o período e a região selecionados.
As métricas de receita estimada estão sujeitas a ajustes no final do mês e não incluem publicidade vendida e veiculada por parceiros. - estimatedRedPartnerRevenue (anteriormente chamado de
redPartnerRevenue) - A receita total estimada gerada com as assinaturas do YouTube Premium (antes conhecido como YouTube Red) para as dimensões de relatório selecionadas. O valor da métrica reflete a receita de conteúdo musical e não musical e está sujeito a ajustes no fim do mês.
Métricas de desempenho de anúncios
- grossRevenue
- A receita bruta estimada, em USD, de toda a publicidade vendida pelo Google ou por parceiros do DoubleClick no período e na região selecionados. A receita bruta está sujeita a ajustes mensais e não inclui anúncios apresentados por parceiros. A receita bruta não deve ser confundida com a receita estimada ou líquida, que considera sua participação na propriedade e os contratos de participação na receita.
- cpm (anteriormente chamado de
impressionBasedCpm) - A receita bruta estimada por mil impressões de anúncios.
- adImpressions (antes chamado de
impressions) - É o número de impressões de anúncio verificadas que foram veiculadas.
- monetizedPlaybacks
- O número de vezes que um espectador assistiu seu vídeo e viu pelo menos uma impressão de anúncio. A reprodução monetizada é contabilizada se um anúncio precedente for exibido ao espectador e este cancelar a exibição do anúncio antes de seu vídeo começar. O erro estimado esperado para este valor é de cerca de 2%.
- playbackBasedCpm
- A receita bruta estimada por mil exibições.