Metrics

Este documento define as métricas que você pode recuperar usando a API YouTube Analytics. Essa API suporta consultas em tempo real para gerar relatórios personalizados do YouTube Analytics.

As métricas são medidas individuais de atividade do usuário, desempenho de anúncios ou receita estimada. As métricas de atividade do usuário incluem coisas como contagens e classificações de visualizações de vídeos (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 que não são principais (e as dimensões não principais) não estão sujeitas à política. Nas definições desta página, qualquer métrica que seja principal é identificada explicitamente como tal.

A lista abaixo identifica as principais métricas da API.

Observação:as seguintes métricas principais foram totalmente descontinuadas:
  • A métrica principal earnings foi descontinuada em 4 de agosto de 2016 e renomeada como estimatedRevenue. De acordo com a política de descontinuação definida nos Termos de Serviço, as métricas earnings e estimatedRevenue tinham suporte simultâneo até 10 de agosto de 2017.
  • As métricas principais favoritesAdded e favoritesRemoved foram descontinuadas em 31 de março de 2015. Essas métricas só podem ser recuperadas por meio da API YouTube Analytics.

Consulte a lista de APIs do YouTube sujeitas à política de descontinuação para saber mais.

Ver métricas

visualizações (métrica principal)
Esta métrica representa números diferentes em tipos diferentes de relatórios:
  • Nos relatórios de vídeos, essa métrica especifica o número de vezes que um vídeo foi assistido.
  • Nos relatórios de playlists que não usam a dimensão isCurated, essa métrica especifica o número total de visualizações dos vídeos na playlist, independentemente de elas terem ocorrido no contexto da playlist. O valor da métrica inclui apenas as visualizações dos vídeos do proprietário do canal.

    Nesses relatórios, a métrica playlistViews indica o número de vezes que os vídeos foram assistidos no contexto de uma playlist específica.
  • Nos relatórios de playlists que usam a dimensão isCurated, essa métrica indica o número de vezes que os vídeos foram assistidos no contexto de uma playlist específica. A métrica playlistViews não é compatível com esses relatórios.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Essa métrica é definida na seção de métricas da playlist.
redViews
O número de vezes que um vídeo foi assistido pelos assinantes do YouTube Premium (antes conhecido como YouTube Red).
uniques (descontinuados em 27 de setembro de 2016)
O número de espectadores únicos que assistiram a um vídeo. Esse cálculo é baseado no número de cookies únicos e, portanto, vai contabilizar em excesso os usuários que usam vários dispositivos ou navegadores.
A métrica uniques foi descontinuada em 27 de setembro de 2016. Essa não é uma métrica principal e terá suporte até 31 de outubro de 2016.
viewerPercentage (métrica principal)
A porcentagem de espectadores que fizeram login enquanto assistiam o vídeo ou a playlist. This is a core metric and is subject to the Deprecation Policy.

Métricas do tempo de exibição

estimatedMinutesWatched (métrica principal)
O número de minutos em que os usuários assistiram vídeos do canal, do proprietário do conteúdo, do vídeo ou da playlist especificada. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
O número de minutos que os assinantes do YouTube Premium (anteriormente conhecido como YouTube Red) assistiram a um vídeo.
averageViewDuration (métrica principal)
A duração média, em segundos, das reproduçõ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 assistida de um vídeo durante a 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. Acesse a Central de Ajuda do YouTube para mais informações. This is a core metric and is subject to the Deprecation Policy.
marcações "Gostei" (métrica principal)
O número de vezes que os usuários indicaram que gostaram de um vídeo atribuindo uma avaliação positiva a ele. This is a core metric and is subject to the Deprecation Policy.
não gostei (métrica principal)
O número de vezes que os usuários indicaram que não gostaram de um vídeo atribuindo uma classificação negativa a ele. This is a core metric and is subject to the Deprecation Policy.
compartilhamentos (métrica principal)
O número de vezes que os usuários compartilharam um vídeo usando o botão Share. Acesse a Central de Ajuda do YouTube para mais informações. 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, nos relatórios que usam a dimensão video ou o parâmetro filter para restringir a resposta a apenas dados de um vídeo específico, a métrica subscribersGained vai incluir apenas as 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 forma semelhante à métrica subscribersGained. 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ão video ou o parâmetro filter para restringir a resposta a somente dados de um vídeo específico, essa métrica inclui apenas 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 uma playlist do YouTube. Os vídeos podem ter sido adicionados à playlist do proprietário do vídeo ou às playlists de outros canais.

O valor da métrica inclui o número de vezes que os vídeos foram adicionados às playlists padrão, como a playlist "Assistir mais tarde". No entanto, ela não considera playlists a 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, ou seja, se um usuário adicionar um vídeo a uma playlist, removê-lo e adicioná-lo novamente, o valor da métrica refletirá o vídeo que está sendo adicionado a uma playlist duas vezes. Os dados desta métrica não estão disponíveis para datas anteriores a 1o 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 do vídeo ou das playlists de outros canais.

O valor da métrica inclui o número de vezes que os vídeos foram removidos das playlists padrão, como a playlist "Assistir mais tarde".

Essa métrica retorna um número absoluto, ou seja, se um usuário adicionar e remover um vídeo de uma playlist, o valor da métrica vai refletir o vídeo que está sendo removido de uma playlist duas vezes. Os dados desta métrica não estão disponíveis para datas anteriores a 1o de outubro de 2014.

Métricas de engajamento descontinuadas

As seguintes métricas eram as principais que tiveram o uso suspenso em 31 de março de 2015.

favoritesAdded (métrica principal) (descontinuado em 31 de março de 2015)
O número de vezes que os usuários marcaram um vídeo como favorito. Acesse a Central de Ajuda do YouTube para mais informações. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (métrica principal) (descontinuado em 31 de março de 2015)
O número de vezes que os usuários removeram um vídeo das listas de vídeos favoritos deles. Acesse a Central de Ajuda do YouTube para mais informações. This is a core metric and is subject to the Deprecation Policy.

Métricas de playlists

Os relatórios de playlists 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 que são agregadas para todos os vídeos na playlist que também pertencem ao canal proprietário da playlist. As métricas para vídeos de outros canais não são computadas na agregação. Como resultado, se um canal criar uma playlist que contenha somente vídeos de outros canais, os relatórios dessas playlists não fornecerão 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 definições de métricas de vídeo agregadas compatíveis.

  • As métricas na playlist refletem a atividade e o engajamento do usuário no contexto da página da playlist. Essas métricas incluem as visualizações de todos os vídeos da playlist, independentemente do canal proprietário deles, mas contam somente as visualizações que ocorreram no contexto da playlist.

A maioria das métricas listadas abaixo são métricas na playlist. As demais métricas, como playlistSaves, são sobre interações do usuário com a playlist em si, e não com os vídeos dela. Assim, elas 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 a vídeos em uma playlist após o início dela. 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. A métrica averageTimeInPlaylist, por outro lado, representa o tempo médio que cada espectador passa assistindo a playlist como um todo. Essa métrica inclui dados de vídeos em playlists que pertencem a outros canais.
playlistEstimatedMinutesWatched
O número de minutos em que os usuários assistiram ao conteúdo da playlist como parte da playlist. O tempo de exibição que ocorreu em outros contextos (por exemplo, o tempo de exibição de visualizações ocorridas 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 em playlists de 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 líquido de alterações, o que significa que, se um usuário salvar uma playlist, removê-la da lista de playlists salvas e salvá-la novamente, o valor da métrica refletirá um salvamento de playlist que está sendo adicionado.
playlistStarts
O número de vezes que os espectadores iniciaram a reprodução de 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 da playlist foram assistidos no contexto dela. Esta métrica inclui dados de vídeos em playlists de outros canais.
viewsPerPlaylistStart
O número médio de visualizações de vídeo que ocorriam cada vez que uma playlist era 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 do YouTube Analytics retornam somente dados para as métricas annotationClickThroughRate e annotationCloseRate desde 10 de junho de 2012. Além disso, os relatórios da API YouTube Analytics retornam dados somente para as métricas de anotação restantes a partir de 16 de julho de 2013.

annotationImpressions
O número total de impressões de anotação.
annotationClickableImpressions
O número de anotações que apareceram e receberam cliques.
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. Na Central de Ajuda do YouTube, você encontra mais informações sobre como criar anotações e usar anotações de links.
annotationClosableImpressions
O número de anotações que apareceram e podem 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 tem instruções mais detalhadas para adicionar cartões aos seus vídeos e o Relatório de cards do YouTube Analytics.

cardImpressions
O número de vezes que os cards foram exibidos. Quando o painel do card é aberto, uma impressão é registrada para cada card do vídeo.
cardClicks
Número de vezes que os cards foram clicados.
cardClickRate
A taxa de cliques para cartões, que é calculada como a proporção entre cliques no cartão e impressões de cartão.
cardTeaserImpressions
Número de vezes que os teasers de card foram exibidos. Uma exibição de vídeo pode gerar várias impressões de teaser.
cardTeaserClicks
O número de cliques em teasers de card. Os cliques no ícone do card são atribuídos ao último teaser exibido ao usuário.
cardTeaserClickRate
A taxa de cliques para teasers de cartão, que é calculada como a proporção de cliques em teasers de cartão em relação ao número total de impressões de teasers de cartão.

Métricas de retenção de público

audienceWatchRatio
A proporção absoluta de espectadores que assistiram o vídeo em um determinado momento do vídeo. Ela é 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 elapsedVideoTimeRatio identifica a parte do vídeo à qual a métrica corresponde.

Vale lembrar que uma parte de um vídeo pode ser assistida mais de uma vez (ou não) na mesma exibição. Por exemplo, se os usuários retrocedem e assistem à mesma parte de um vídeo várias vezes, a proporção absoluta dessa parte do vídeo pode ser maior que 1.

Os exemplos a seguir ilustram 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 nenhuma parte do vídeo mais de uma vez. Nesse caso, o valor dessa métrica seria 1 para os intervalos de tempo no primeiro quarto do vídeo, e o valor dela seria 0.50 para o restante do vídeo.
  • Um vídeo de um minuto é assistido 100 vezes. Todos os espectadores assistem ao vídeo inteiro, mas 20 assistem até a marca de 45 segundos, depois voltam para a marca de 30 segundos e assistem o restante do vídeo. Nesse caso, o valor da métrica seria 1 para os intervalos de tempo na primeira metade ou no último quarto do vídeo. No entanto, o valor seria 1.2 para os intervalos de tempo no terceiro trimestre do vídeo, já que 100% dos espectadores assistiram esse segmento do vídeo, mas 20% deles assistiram o segmento duas vezes.
relativeRetentionPerformance
Uma medida que mostra a retenção de espectadores de um vídeo durante as reproduções em comparação com todos os vídeos do YouTube de duração semelhante. A métrica tem um valor entre 0 e 1 que identifica o desempenho de retenção relativa do vídeo em um determinado momento. O ponto no vídeo é fornecido pela dimensão elapsedVideoTimeRatio.

Um valor de 0 indica que o vídeo retém menos espectadores do que qualquer outro vídeo de duração semelhante, enquanto o valor de 1 indica que o vídeo retém os espectadores melhor do que qualquer outro vídeo de duração semelhante. Um valor médio de 0.5 indica que metade dos vídeos com duração semelhante retêm melhor os espectadores, enquanto metade retêm pior os espectadores.

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 com 10 minutos de duração continuam assistindo após 3 minutos, e 70% após 8 minutos. No entanto, para um vídeo específico de 10 minutos de duração, apenas 80% dos espectadores continuam assistindo após 3 minutos, mas todos continuam assistindo após 8 minutos.
  • No valor de elapsedVideoTimeRatio que corresponde ao ponto três minutos no vídeo, a métrica relativeRetentionPerformance teria um valor abaixo de 0.5, já que, naquele momento, o vídeo tem um desempenho pior do que o vídeo normal.
  • No valor de elapsedVideoTimeRatio correspondente ao ponto que há oito minutos no vídeo, a métrica relativeRetentionPerformance teria um valor maior do que 0.5, já que, naquele momento, o vídeo tem um desempenho melhor do que outros de duração semelhante.

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 ou veiculada por parceiros. Consulte a Central de Ajuda do YouTube para mais informações e observações sobre valores estimados de receita.

Por padrão, todos os valores de receita estimada são informados em USD. No entanto, a API YouTube Analytics é compatível com o parâmetro currency para algumas métricas de receita estimada e performance de anúncios, permitindo que você recupere esses dados em outras moedas.
estimatedRevenue (métrica principal) (anteriormente chamada de earnings)
A receita líquida total estimada de todas as origens de publicidade vendidas pelo Google, bem como de fontes não relacionadas ao período e 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 ou veiculada por parceiros.
estimatedAdRevenue (anteriormente, adEarnings)
A receita líquida total estimada de todas as fontes de publicidade vendida 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 redPartnerRevenue)
A receita total estimada gerada com assinaturas do YouTube Premium (anteriormente 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 ajuste no final 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 veiculados por parceiros. A receita bruta não deve ser confundida com a receita estimada ou receita líquida, que inclui seus contratos de participação na receita e a cota de propriedade.
cpm (anteriormente chamado de impressionBasedCpm)
A receita bruta estimada por mil impressões de anúncios.
adImpressions (nome anterior como impressions)
O número de impressões de anúncios verificadas veiculadas.
monetizedPlaybacks
O número de instâncias em que um espectador assistiu seu vídeo e recebeu 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 reproduções.