Metrics

Este documento define as métricas que a API YouTube Reporting recupera. Essa API recupera relatórios de dados em massa que contêm dados do YouTube Analytics para um canal ou proprietário do conteúdo.

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 métricas como contagens e classificações de exibições de vídeos (marcações "Gostei" e "Não gostei").

Principais métricas

Embora a API YouTube Reporting esteja sujeita à política de suspensão de uso definida nos Termos de Serviço, as métricas (e as dimensões não principais) não relacionadas ao assunto estão sujeitas à política. Nas definições desta página, qualquer métrica que seja uma métrica principal é identificada explicitamente como tal.

A lista abaixo identifica as principais métricas da API. Qualquer uma dessas métricas usadas na API YouTube Analytics também são essenciais nessas APIs.

Para mais informações, consulte a lista de APIs do YouTube sujeitas à política de descontinuação.

Ver métricas

visualizações (métrica principal)
O número de visualizações de um vídeo. Em um relatório de playlist, a métrica indica o número de visualizações de um vídeo no contexto de uma playlist. A Central de Ajuda do YouTube oferece mais informações sobre como as visualizações são informadas. This is a core metric and is subject to the Deprecation Policy.
red_views (em inglês)
O número de vezes que um vídeo foi visto por assinantes do YouTube Premium (anteriormente conhecido como YouTube Red).
views_percentage (métrica principal)
A porcentagem de espectadores que fizeram login 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

watch_time_minutes (métrica principal)
O número de minutos que os usuários assistiram a vídeos do canal, proprietário do conteúdo, vídeo ou playlist especificado. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
O número de minutos que os assinantes do YouTube Premium (antes conhecido como YouTube Red) assistiram um vídeo.
average_view_duration_seconds (métrica do núcleo)
A duração média, em segundos, das reproduções de vídeo. A partir de 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.
average_view_duration_percentage (em inglês)
É a porcentagem média de um vídeo que é assistida durante a reprodução. A partir de 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. Consulte 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 com uma classificação positiva. 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. 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. Consulte a Central de Ajuda do YouTube para mais informações. This is a core metric and is subject to the Deprecation Policy.
subscribers_gained (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 de vídeos, a página do canal e o guia que aparece na página inicial do YouTube. Para identificar o número de novos inscritos do canal que não se inscreveram por meio de uma página de exibição de vídeos, um relatório básico de atividade do usuário contém uma linha que não especifica um valor de dimensão video_id. Essa linha também especifica um valor para a métrica subscribersLost, mas não para outras métricas.
subscribers_lost (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 desta métrica são informados de maneira semelhante à métrica subscribers_gained. Para identificar o número de usuários que cancelaram a inscrição em uma página de exibição de vídeos, um relatório básico de atividade do usuário contém uma linha que não especifica um valor de dimensão video_id. Essa linha também especifica um valor para a métrica subscribers_gained, mas não para outras métricas.
videos_added_to_playlists
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 a playlists 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 a playlist "Assistir mais tarde". No entanto, não contam as playlists às quais 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 adiciona um vídeo a uma playlist, remove-a e, em seguida, a adiciona novamente, o valor da métrica reflete o vídeo sendo adicionado a uma playlist duas vezes. Os dados dessa métrica não estão disponíveis para datas anteriores a 1o de outubro de 2014.
videos_removed_from_playlists
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 a playlist "Assistir mais tarde".

Essa métrica retorna um número absoluto, ou seja, se um usuário adicionar um vídeo a uma playlist, removê-lo, adicioná-lo novamente e, em seguida, removê-lo novamente, o vídeo será removido da playlist duas vezes. Os dados dessa métrica não estão disponíveis para datas anteriores a 1o de outubro de 2014.

Métricas de playlists

playlist_starts (link em inglês)
O número de vezes que os espectadores iniciaram a reprodução de uma playlist. Essa métrica inclui apenas visualizações de playlists que ocorreram na Web.
playlist_saves_added (compatível apenas com a API Reporting do YouTube)
O número de vezes que os usuários salvaram uma playlist. Consulte a Central de Ajuda do YouTube para mais informações sobre playlists salvas. Essa métrica retorna um número absoluto, o que significa que, se um usuário salva uma playlist, a remove da lista de playlists salvas e a salva novamente, o valor da métrica reflete a adição de duas playlists.
playlist_saves_removed (compatível apenas com a API Reporting do YouTube)
O número de vezes que os usuários removeram a playlist da lista de playlists salvas. Essa métrica retorna um número absoluto, o que significa que, se um usuário salva uma playlist, a remove da lista de playlists salvas, a salva novamente e a remove novamente, o valor da métrica reflete a remoção de duas playlists.

Métricas de anotações

annotation_imp
É o número total de impressões de anotação.
annotation_clickable_impressions (em inglês)
O número de anotações que apareceram e puderam ser clicadas.
annotation_clicks
O número de anotações clicadas.
annotation_click_through_rate (métrica principal)
É a proporção de anotações em que os espectadores clicaram com base no 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.
annotation_closable_imp
O número de anotações que apareceram e poderiam ser fechadas.
annotation_closes
O número de anotações fechadas.
annotation_close_rate (métrica principal)
É a proporção de anotações que os espectadores fecharam em relação ao número total de impressões. This is a core metric and is subject to the Deprecation Policy.

Métricas do cartão

A Central de Ajuda do YouTube contém instruções mais detalhadas sobre como adicionar cards aos seus vídeos e sobre o Relatório de cards do YouTube Analytics.

card_impressions
O número de vezes que os cards foram exibidos. Quando o painel de cards é aberto, uma impressão é registrada para cada card do vídeo.
card_clicks
O número de vezes que os cards foram clicados.
card_click_rate (em inglês)
A taxa de cliques para cards, que é calculada como a proporção entre cliques em cards e impressões de cards.
card_teaser_impressions (link em inglês)
O número de vezes que os teasers de card foram exibidos. Uma visualização de vídeo pode gerar várias impressões de teaser.
card_teaser_clicks
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.
card_teaser_click_rate (em inglês)
A taxa de cliques dos teasers de cartão, calculada como a proporção de cliques nesses teasers em relação ao número total de impressões.

Métricas da tela final

As telas finais são elementos exibidos durante os últimos 5 a 20 segundos de um vídeo para promover seu conteúdo, canal e sites. A Central de Ajuda do YouTube contém instruções mais detalhadas sobre como adicionar telas finais aos seus vídeos e sobre o Relatório de telas finais do YouTube Analytics.

Observação: os dados das métricas de tela final estão disponíveis desde 1o de maio de 2016.

end_screen_element_imp
O número de elementos da tela final que foram exibidos. Uma impressão é registrada para cada elemento da tela final exibido.
end_screen_element_clicks
O número de cliques nos elementos da tela final.
end_screen_element_click_rate
A taxa de cliques dos elementos da tela final, que é calculada como a proporção entre os cliques no elemento da tela final e as impressões do elemento da tela final.

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

audience_retention_percentage (em inglês)
É a proporção absoluta de espectadores que assistem ao vídeo em um determinado ponto do vídeo. A proporção é calculada comparando o número de vezes que uma parte de um vídeo foi assistida ao número total de visualizações do vídeo. A dimensão elapsed_video_time_percentage identifica a parte do vídeo a que a métrica corresponde.

Uma parte de um vídeo pode ser assistida mais de uma vez (ou não) em uma determinada visualização. Por exemplo, se os usuários retrocederem e assistirem a mesma parte de um vídeo várias vezes, a proporção absoluta para essa parte do vídeo poderá 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 param 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 intervalos de tempo no primeiro trimestre do vídeo, e o valor 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 todo, mas 20 assistem até a marca de 45 segundos, 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 trimestre do vídeo. No entanto, o valor seria 1.2 para intervalos de tempo no terceiro trimestre do vídeo, já que 100% dos espectadores assistiram a esse segmento do vídeo, mas 20% deles assistiram duas vezes.

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 valores estimados de receita.

A API YouTube Reporting informa todos os valores estimados de receita e ganhos em USD.
estimated_partner_revenue (métrica principal)
A receita líquida total estimada de todas as fontes de publicidade vendidas pelo Google e de origens não publicitárias no período e na região selecionados.
estimated_partner_ad_revenue
A receita líquida total estimada de todas as fontes de publicidade vendidas pelo Google no período e na região selecionados.

As métricas de receita estimada estão sujeitas a ajuste no final do mês e não incluem publicidade vendida e veiculada por parceiros.
estimated_partner_ad_leilão_revenue (compatível somente com a API Reporting do YouTube)
Os ganhos totais estimados (receita líquida) de publicidade vendida por leilão pelo Google AdSense no período e na região selecionados. Essa métrica era chamada de estimated_partner_ad_sense_revenue.
estimated_partner_ad_sense_revenue (compatível apenas com a API YouTube Reporting)
O total de ganhos estimados (receita líquida) da publicidade do Google AdSense vendida por leilão no período e na região selecionados.
estimated_partner_ad_reserved_revenue (compatível apenas com a API Reporting do YouTube)
Os ganhos totais estimados (receita líquida) de publicidade vendida/reservada via DoubleClick (DCLK) e outras fontes vendidas pelo YouTube. Essa métrica era chamada de estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (compatível apenas com a API Reporting do YouTube)
Os ganhos totais estimados (receita líquida) de publicidade vendida/reservada por meio do DoubleClick (DCLK) e outras fontes vendidas pelo YouTube.
estimated_partner_red_revenue (compatível apenas com a API Reporting do YouTube)
O total de ganhos estimados (receita líquida) do YouTube Premium (anteriormente conhecido como YouTube Red).
estimated_partner_transaction_revenue (compatível apenas com a API Reporting do YouTube)
A receita total estimada das transações, como conteúdo pago e financiamento por fãs, menos os reembolsos cobrados por parceiros.

Métricas de desempenho de anúncios

estimated_youtube_ad_revenue
A receita bruta estimada, em dólares americanos, de toda a publicidade vendida pelo Google ou pelo parceiro do DoubleClick para o período e a 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 líquida, que considera sua parcela de propriedade e os contratos de participação na receita.
CPM estimado
A receita bruta estimada por mil impressões de anúncios.
ad_imp
É o número de impressões de anúncios verificadas.
estimated_monetizationd_playbacks (link em inglês)
É o número de instâncias em 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%.
estimated_playback_cpm_cpm
A receita bruta estimada por mil reproduções.