Nesta página, mostramos exemplos de solicitações da API YouTube Analytics. Cada exemplo descreve brevemente o relatório que está sendo recuperado e mostra os valores de parâmetros dimensions
, metrics
, filters
e sort
correspondentes. Os documentos relatórios de canal e relatórios do proprietário do conteúdo identificam os relatórios que a API suporta.
Cada exemplo está vinculado e preenche o APIs Explorer do Google com os valores mostrados. Os exemplos também usam datas de início e término padrão (YYYY-MM-DD
) de 2023-09-01
e 2024-03-31
.
Após vincular ao APIs Explorer, você ainda precisa especificar o canal ou o proprietário do conteúdo para o qual está recuperando relatórios. O APIs Explorer preencherá o valor do parâmetro ids
com channel==MINE
ou contentOwner==CONTENT_OWNER_ID
, dependendo da consulta em que você clicou. Para relatórios de canal, você pode alterar MINE
para o ID do canal do usuário autenticado. Para relatórios do proprietário do conteúdo, é necessário substituir CONTENT_OWNER_ID
pelo ID do proprietário do conteúdo.
Você também precisa ser autenticado como o canal especificado ou proprietário do conteúdo para que o APIs Explorer possa autorizar suas solicitações de API usando OAuth 2.0.
- Como classificar solicitações por várias dimensões/métricas
- Relatórios do canal
- Relatórios do proprietário do conteúdo
Como classificar solicitações por várias dimensões/métricas
A API é compatível com o recurso de classificar os dados da resposta usando várias dimensões ou métricas. Por exemplo, a solicitação abaixo recupera dados diários de origem do tráfego para vídeos de determinado canal. Cada linha no conjunto de resultados identifica o número de visualizações e o tempo de exibição estimado proveniente de determinado tipo de origem de tráfego (por exemplo, EXT_URL
) em um dia específico.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
Na resposta, os resultados são classificados cronologicamente. No conjunto de resultados de cada dia, os resultados são classificados em ordem decrescente por contagem de visualizações. Dessa forma, a primeira linha do conjunto de resultados contém dados para a origem de tráfego que gerou o maior número de visualizações no primeiro dia do período solicitado. A segunda linha contém dados para a origem de tráfego que gerou o segundo maior número de visualizações no primeiro dia.
Relatórios de canal
Relatórios de vídeo
Total de visualizações, tempo de exibição estimado e mais para um canal
Esta consulta recupera métricas agregadas para o conteúdo do canal. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
Contagens de visualizações específicas de um país e mais para um canal
Esta consulta recupera métricas para um país específico para vídeos de um canal. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
10 mais – Vídeos mais assistidos para um canal
Esta consulta recupera os 10 vídeos mais assistidos de um canal, conforme medido pela estimativa de minutos assistidos durante o período especificado. Os resultados são classificados pela estimativa de minutos assistidos em ordem decrescente.
Observação:esse relatório exige que você especifique um valor para o parâmetro de solicitação sort
e o parâmetro maxResults
para um valor inteiro de 10
ou menos.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
10 mais – Taxas de cliques de anotação para os vídeos mais visualizados de um canal
Esta solicitação recupera contagens de visualizações, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para os 10 vídeos mais visualizados do canal. Os resultados são classificados por contagem de visualizações em ordem decrescente, o que significa que o vídeo mais exibido será listado primeiro.
Observação:esse relatório exige que você especifique um valor para o parâmetro de solicitação sort
e o parâmetro maxResults
para um valor inteiro de 10
ou menos.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Relatórios de playlists
Visualizações totais da playlist de um canal
Essa solicitação recupera o total de inicializações de playlist, a estimativa de minutos assistidos, as visualizações (uma métrica de vídeo agregada), as visualizações da playlist (uma métrica na playlist) e as visualizações por início de playlist para playlists no canal do usuário autenticado.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Estatísticas para uma playlist específica
Essa solicitação recupera o total de inicializações da playlist, a estimativa de minutos assistidos, as visualizações (uma
métrica de vídeo agregada),
as visualizações da playlist (uma métrica na playlist)
e as visualizações por início de playlist de uma playlist específica. Para executar essa consulta no APIs Explorer, substitua a string PLAYLIST_ID
no valor de parâmetro filters
pelo ID da playlist de uma playlist no canal do usuário autenticado.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Para recuperar estatísticas agregadas de várias playlists, você também pode substituir a string PLAYLIST_ID
por uma lista separada por vírgulas de até 500 IDs de playlists para playlists no canal do usuário autenticado.
10 mais – Playlists mais assistidas de um canal
Esta consulta recupera as 10 playlists mais assistidas de um canal, conforme medido pelas visualizações da playlist durante o período especificado. Ele também recupera várias outras métricas de playlist, como o número de vezes que os espectadores iniciaram a reprodução de cada playlist e o tempo médio que um espectador assistiu a vídeos na playlist depois que ela foi iniciada. Os resultados são classificados por visualizações de playlist em ordem decrescente.
Observação:como esse relatório usa a dimensão playlist
, você precisa especificar um valor para o parâmetro de solicitação sort
e também definir o parâmetro maxResults
como um valor inteiro de 10
ou menos.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Relatórios de vídeo
Métricas diárias de tempo de exibição para vídeos de um canal
Esta consulta recupera as contagens diárias de visualização, métricas de tempo de exibição e novas contagens de inscritos para os vídeos de um canal. O relatório retorna uma linha de dados por dia no período solicitado. As linhas são classificadas em ordem cronológica.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Métricas de anotação diárias para vídeos de um canal
Esta solicitação recupera contagens de visualizações diárias, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para o conteúdo do canal. Os resultados são classificados em ordem cronológica.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Relatórios de playlists
Visualizações diárias da playlist de um canal
Esta solicitação recupera contagens de visualizações diárias (uma métrica de vídeo agregada), visualizações de playlist (uma métrica na playlist), inícios de playlist, minutos estimados de exibição e visualizações por início de playlist para o canal do usuário autenticado. Os resultados são classificados em ordem cronológica.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Relatórios de vídeo
Métricas de tempo de exibição específicas de um país para vídeos de um canal
Esta consulta recupera contagens de visualizações específicas do país, métricas de tempo de exibição e números de inscrições para os vídeos de um canal. O relatório retorna uma linha de dados para cada país em que os vídeos do canal foram assistidos. As linhas são classificadas em ordem decrescente do número de minutos assistidos.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=-estimatedMinutesWatched
Métricas de anotação específicas de um país para vídeos de um canal
Esta solicitação recupera contagens de visualizações específicas do país, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para os vídeos do canal. Os resultados são classificados por taxa de clique de anotação em ordem decrescente, o que significa que o país com a maior taxa de clique de anotação será o primeiro da lista.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Métricas específicas da província para os estados dos EUA e Washington D.C.
Esta solicitação recupera o detalhamento das contagens de visualizações, de minutos assistidos estimados e da duração média da visualização dos vídeos do canal. Os dados abrangem os estados dos EUA e Washington D.C. Os resultados são classificados em ordem alfabética pelos códigos ISO 3166-2 das províncias.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 mais – Vídeos mais visualizados em um país específico
Esta consulta recupera os 10 vídeos mais visualizados do canal, conforme medido pelo número de visualizações durante o período especificado em determinado país. Os resultados são classificados por contagem de visualizações em ordem decrescente.
Observação:esse relatório exige que você especifique um valor para o parâmetro de solicitação sort
e o parâmetro maxResults
para um valor inteiro de 10
ou menos.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
10 principais cidades dos EUA pelo total de visualizações
Esta consulta recupera uma lista das 10 cidades dos EUA que foram responsáveis pela maior parte das visualizações do conteúdo do canal durante o período especificado. A consulta pode ser modificada para solicitar dados de outro país. Para isso, escolha outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos seus valores válidos. Outros filtros também são aceitos. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=city metrics=views filters=country==US maxResults=10 sort=-views
10 principais cidades dos EUA pelo total de visualizações para cada tipo de conteúdo
Esta consulta recupera uma lista das 10 cidades dos EUA que representaram a maior parte das visualizações do conteúdo do canal durante o período especificado para cada creatorContentType suportado. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=city,creatorContentType metrics=views filters=country==US maxResults=10 sort=-views
10 principais cidades dos EUA por tempo de exibição total
Esta consulta recupera uma lista dos 10 principais dias durante o período especificado, quando qualquer cidade dos EUA foi responsável pelo maior tempo de exibição diário total do conteúdo do canal. Os resultados da consulta identificam o tempo de exibição total, a data em que ocorreu o tempo de exibição e a cidade em que o conteúdo foi estimado. Os resultados são classificados em ordem decrescente do tempo total de exibição.
dimensions=city,day metrics=estimatedWatchTime filters=country==US maxResults=10 sort=-estimatedWatchTime
10 mais – Vídeos mais visualizados na Europa
Esta consulta recupera os 10 vídeos mais visualizados do canal na Europa, conforme medido pelo número de visualizações durante o período especificado. É possível modificar a consulta para solicitar dados de outro continente escolhendo outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos seus valores válidos. Os resultados são classificados por contagem de visualizações em ordem decrescente.
Observação:esse relatório exige que você especifique um valor para o parâmetro de solicitação sort
e o parâmetro maxResults
para um valor inteiro de 10
ou menos.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Relatórios de playlists
Métricas de tempo de exibição específicas de um país para as playlists de um canal
Essa consulta recupera contagens de visualizações específicas do país (uma métrica de vídeo agregada), visualizações de playlist (uma métrica na playlist) e métricas de tempo de exibição para playlists de um canal. O relatório retorna uma linha de dados para cada país em que as playlists do canal foram assistidas. As linhas são classificadas em ordem decrescente do número de minutos assistidos.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
10 principais – Playlists mais ouvidas nos Estados Unidos
Esta consulta recupera as 10 listas de reprodução que espectadores nos Estados Unidos começaram a assistir com mais frequência durante o período especificado. Os resultados são classificados por número de inícios de playlist em ordem decrescente.
Observação:como esse relatório usa a dimensão playlist
, você precisa especificar um valor para o parâmetro de solicitação sort
e também definir o parâmetro maxResults
como um valor inteiro de 10
ou menos.
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
Relatórios de vídeo
Contagens de exibições e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera o número de visualizações e o tempo de exibição estimado para vídeos de determinado canal. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e classificados em ordem decrescente por contagem de visualizações.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Contagens diárias de visualizações e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera as contagens diárias de visualização e o tempo de exibição estimado nos Estados Unidos para vídeos de determinado canal. Os resultados são agrupados por dia para cada tipo de aplicativo ou página em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
10 mais – Sites de terceiros que geram o maior número de visualizações para um vídeo incorporado
Esta consulta recupera as contagens de visualização e o tempo de exibição estimado para um determinado vídeo ou grupo de vídeos. Os resultados são agrupados por site de terceiros em que o vídeo foi incorporado. Os resultados são classificados em ordem decrescente por contagem de visualizações. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
por uma lista separada por vírgulas de um ou mais IDs de vídeo para os vídeos enviados.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Relatórios de playlists
Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Essa consulta recupera o número de contagens de visualizações (uma métrica de vídeo agregada), de visualizações de playlist (uma métrica na playlist), o tempo de exibição estimado e as inicializações de playlist de um determinado canal. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e classificados em ordem decrescente por início de playlist.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Contagens diárias de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Essa consulta recupera as inicializações diárias de playlists, as contagens de visualizações (uma métrica de vídeo agregada), as visualizações de playlist (uma métrica na playlist) e o tempo de exibição estimado nos Estados Unidos para as playlists de um determinado canal. Os resultados são agrupados por dia para cada tipo de página ou aplicativo em que ocorreram visualizações de playlists. Os resultados são classificados em ordem cronológica.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Relatórios de vídeo
Marcações "Gostei" e "Não gostei" por tipo de conteúdo
Esta consulta recupera o número de marcações "gostei" e "não gostei" para cada tipo de conteúdo em um canal.
dimensions=creatorContentType metrics=likes,dislikes
Relatórios de vídeo
Contagens de exibições e tempo de exibição de diferentes origens de tráfego em um país
Esta solicitação recupera o número de visualizações e o tempo de exibição estimado para os vídeos do canal em um país especificado. As métricas são agregadas por origem de tráfego, que descreve a maneira pela qual os usuários chegaram ao vídeo.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego
Esta solicitação recupera as contagens de visualizações diárias e o tempo de exibição diário estimado para os vídeos do canal. As métricas são agregadas diariamente por origem de tráfego e classificadas em ordem cronológica.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched sort=day
10 mais – Termos de pesquisa do YouTube que geram mais tráfego para um vídeo
Esta consulta recupera os 10 termos de pesquisa que geraram o maior número de visualizações nos resultados de pesquisa do YouTube para um ou mais vídeos específicos. Os resultados são classificados por contagem de visualizações em ordem decrescente. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de vídeos.
Por exemplo, execute a consulta por um único vídeo ou substitua VIDEO_ID
para identificar os termos de pesquisa que geram mais tráfego para esse vídeo. Você também pode listar todos os vídeos em uma playlist específica para determinar quais termos de pesquisa geram mais tráfego para qualquer um dos vídeos dessa playlist.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 principais – Sites externos que geram o maior tráfego para um vídeo
Esta consulta recupera os 10 sites externos que geraram o maior número de visualizações para um vídeo específico ou grupo de vídeos. Os resultados são classificados por tempo de exibição estimado em ordem decrescente. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de vídeos para os vídeos enviados.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Relatórios de playlists
Contagens de visualizações de playlists e tempo de exibição de diferentes origens de tráfego em um país
Essa solicitação recupera o número de visualizações (uma métrica de vídeo agregada), de visualizações de playlist (uma métrica na playlist), de inícios de playlist e o tempo de exibição estimado para visualizações de playlist em um país especificado. As métricas são agregadas por origem do tráfego, que descreve como os usuários chegaram à playlist.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Contagens diárias de visualizações de playlists e tempo de exibição de diferentes origens de tráfego
Essa solicitação recupera as visualizações diárias da playlist de um canal (uma métrica na playlist), os inícios da playlist e o tempo de exibição estimado. Ela também recupera o total de visualizações, uma métrica de vídeo agregada. As métricas são agregadas diariamente por origem de tráfego e classificadas em ordem cronológica.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
Relatórios de vídeo
Métricas diárias do tipo de dispositivo para o sistema operacional Android
Esta consulta recupera as contagens diárias de visualização e o tempo de exibição estimado em dispositivos Android para vídeos de determinado canal. Os resultados são agrupados por dia para cada tipo de dispositivo em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Métricas diárias do sistema operacional para dispositivos móveis
Esta consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado em dispositivos móveis para vídeos de determinado canal. Os resultados são agrupados por dia para cada sistema operacional em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Métricas diárias do sistema operacional e do tipo de dispositivo
Esta consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado para um canal. As estatísticas são agrupadas por sistema operacional e tipo de dispositivo. Os resultados são classificados em ordem cronológica.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Relatórios de playlists
Métricas diárias do tipo de dispositivo para visualizações de playlists no sistema operacional Android
Essa consulta recupera visualizações diárias (uma métrica de vídeo agregada), visualizações de playlist (uma métrica na playlist) e o tempo de exibição estimado em dispositivos Android para as playlists de um determinado canal. Os resultados são agrupados por dia para cada tipo de dispositivo em que ocorreram as visualizações de playlist. Os resultados são classificados em ordem cronológica.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Métricas diárias do sistema operacional para visualizações de playlists em dispositivos móveis
Essa consulta recupera visualizações diárias (uma métrica de vídeo agregada), visualizações de playlist (uma métrica na playlist) e o tempo de exibição estimado em dispositivos móveis para as playlists de um determinado canal. Os resultados são agrupados por dia para cada sistema operacional em que as visualizações da playlist ocorreram. Os resultados são classificados em ordem cronológica.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Relatórios de vídeo
Informações demográficas dos espectadores na Califórnia (idade e gênero)
Este relatório recupera estatísticas sobre a faixa etária e o gênero dos espectadores na Califórnia que assistiram os vídeos do canal. Os resultados são classificados por sexo e depois por faixa etária. É possível modificar esta consulta para recuperar as mesmas estatísticas de todos os espectadores do mundo todo ou de todos os espectadores em um país, continente, subcontinente ou outro estado dos EUA. Para isso, ajuste o valor do parâmetro filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Relatórios de playlists
Informações demográficas dos espectadores da playlist na Califórnia (idade e gênero)
Este relatório recupera estatísticas sobre a idade e o gênero dos espectadores na Califórnia que
assistiram as playlists do canal. Os resultados são classificados por sexo e depois por faixa etária. É possível modificar essa consulta para recuperar as mesmas estatísticas de todos os espectadores do mundo todo ou de todos os espectadores de um país, continente, subcontinente ou outro estado dos EUA. Para isso, ajuste o valor do parâmetro filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Métricas de compartilhamento, agregadas por serviço onde os vídeos foram compartilhados
Esta solicitação recupera o número de vezes que os usuários utilizaram o botão Share
para compartilhar vídeos de um canal. Os resultados são agregados por serviço de compartilhamento (Google+, Twitter etc) e classificados em ordem decrescente do número de compartilhamentos.
dimensions=sharingService metrics=shares sort=-shares
Métricas de retenção de público para um vídeo
Esse relatório mede a capacidade de um vídeo de manter o público. O relatório só pode ser recuperado para um único vídeo por vez. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
pelo ID do vídeo para um dos vídeos enviados. Os relatórios de retenção de público não são compatíveis com a capacidade de especificar vários valores para o filtro video
.
Neste exemplo, o relatório usa o filtro audienceType
para restringir a resposta para que ela contenha apenas dados de visualizações orgânicas, que são resultado de uma ação direta do usuário, como uma pesquisa por um vídeo ou um clique em um vídeo sugerido. Sendo assim, o relatório não inclui dados de visualizações de anúncios TrueView in-stream ou TrueView em Display. Você pode remover o filtro para recuperar os dados de retenção de público do vídeo para todos os tipos de público.
Os dados do filtro audienceType
estão disponíveis desde 25 de setembro de 2013. A API não retornará dados para consultas que usam o filtro para tentar recuperar dados de datas anteriores. As consultas que não usam o filtro funcionam para qualquer data posterior a 1o de julho de 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Métricas de receita do canal e performance de anúncios
Esta solicitação recupera a receita de um canal e as métricas de desempenho de anúncios. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Métricas de receita diária e performance de anúncios
Esta solicitação recupera a receita diária de um canal e as métricas de desempenho de anúncios.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Métricas de receita e performance de anúncios específicas do país
Esta solicitação recupera as métricas de receita e desempenho de anúncios específicas de um canal do país. Os resultados são classificados em ordem decrescente por valor de receita, o que significa que o primeiro país listado será aquele em que o parceiro teve a maior receita líquida.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
10 mais – Vídeos com a maior receita
Esta solicitação recupera métricas de receita e desempenho de anúncios para os 10 vídeos do canal com a maior receita. Os resultados são classificados em ordem decrescente por valor de receita, o que significa que o primeiro vídeo será o que teve a maior receita estimada.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks maxResults=10 sort=-estimatedRevenue
Métricas de desempenho de anúncios para diferentes tipos de anúncios
Esta solicitação recupera métricas de desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo. Os resultados são agrupados por tipo de anúncio, o que permite comparar os valores de receita e de CPM em diferentes tipos de anúncios.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Relatórios do proprietário do conteúdo
Relatórios de vídeo
Contagens totais de visualização, tempo de exibição estimado e mais para todo o conteúdo reivindicado
Esta consulta recupera métricas agregadas para o conteúdo reivindicado do proprietário do conteúdo. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
Contagens de visualizações específicas de um país (e mais) para todos os vídeos enviados automaticamente
Esta consulta recupera métricas para um país específico para os vídeos que o proprietário do conteúdo enviou. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Contagens totais de visualização (e mais) de todo o conteúdo reivindicado de terceiros
Esta consulta recupera métricas agregadas para os vídeos que o proprietário do conteúdo reivindicou, mas não enviou. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Contagens totais de visualização (e mais) de todo o conteúdo enviado automaticamente
Esta consulta recupera métricas agregadas para os vídeos que o proprietário do conteúdo enviou. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
Contagens totais de visualização (e mais) para todo o conteúdo enviado automaticamente
Esta consulta recupera métricas agregadas para os vídeos que o proprietário do conteúdo enviou e reivindicou. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
10 mais – Vídeos mais visualizados para um proprietário do conteúdo
Esta consulta recupera os 10 vídeos mais visualizados, conforme medido pelo número de visualizações durante o período especificado, que o proprietário do conteúdo enviou. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
10 mais – Vídeos mais assistidos para um proprietário do conteúdo
Esta consulta recupera os 10 vídeos mais assistidos, conforme medido pela estimativa de minutos assistidos durante o período especificado. Os resultados são classificados pela estimativa de minutos assistidos em ordem decrescente.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
10 mais – Vídeos mais visualizados no canal de um proprietário do conteúdo
Esta consulta recupera os 10 vídeos mais visualizados de um canal específico ou grupo de canais que o proprietário do conteúdo gerencia. Os resultados são classificados por contagem de visualizações em ordem decrescente. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
10 mais – Taxas de cliques de anotação para os vídeos mais visualizados de um canal
Esta solicitação recupera contagens de visualizações, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para os 10 vídeos mais visualizados em um canal ou grupo de canais especificado. Os resultados são classificados por contagem de visualizações em ordem decrescente, o que significa que o vídeo mais exibido será listado primeiro. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
Relatórios de playlists
Visualizações de playlists dos canais de um proprietário do conteúdo
Esta solicitação recupera o total de inicializações de playlist, a estimativa de minutos assistidos, as visualizações
e as visualizações por início de playlist para playlists nos canais do proprietário do conteúdo. A
métrica playlistViews
conta apenas as visualizações de vídeos que ocorreram no contexto de uma
playlist. Como todas as métricas solicitadas estão na playlist, a solicitação não
também precisa incluir o filtro playlist ou group.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Estatísticas para uma playlist específica
Essa solicitação recupera o total de inicializações da playlist, a estimativa de minutos assistidos, as visualizações (uma
métrica de vídeo agregada),
as visualizações da playlist (uma métrica na playlist)
e as visualizações por início de playlist de uma playlist específica. Para executar essa consulta no APIs Explorer, você precisa substituir a string PLAYLIST_ID
no valor de parâmetro filters
pelo ID da playlist em um dos canais do proprietário do conteúdo.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Para recuperar estatísticas agregadas de várias playlists, você também pode substituir a string PLAYLIST_ID
por uma lista separada por vírgulas de até 500 IDs de playlists para playlists nos canais do proprietário do conteúdo.
Relatórios de vídeo
Métricas diárias de tempo de exibição para conteúdo enviado automaticamente
Esta consulta recupera métricas diárias de tempo de exibição, além de contagens de visualizações, de reproduções monetizadas e contagens de impressões para os vídeos que o proprietário do conteúdo enviou. O relatório retorna uma linha de dados para cada dia no período solicitado. As linhas são classificadas em ordem cronológica.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
Métricas de anotação para o conteúdo reivindicado
Esta solicitação recupera contagens de visualizações diárias, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para o conteúdo reivindicado do proprietário do conteúdo. Os resultados são classificados em ordem cronológica.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Relatórios de playlists
Visualizações diárias de playlists de um proprietário do conteúdo
Esta solicitação recupera métricas para interações diárias do usuário com vídeos nas playlists do proprietário do conteúdo. As métricas recuperadas no relatório são playlistViews, playlistStarts, playlistEstimatedMinutesWatched e viewsPerPlaylistStart. Todas essas métricas são na playlist. Como todas as métricas solicitadas estão na playlist, a solicitação não precisa incluir também o filtro playlist ou group.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Relatórios de vídeo
Métricas do tempo de exibição específicas de um país para o conteúdo enviado automaticamente
Esta consulta recupera as contagens de visualizações, as métricas de tempo de exibição e a receita estimada de anúncios para cada país. As métricas são para vídeos que o proprietário do conteúdo enviou. O relatório retorna uma linha de dados para cada país em que os vídeos foram assistidos. As linhas são classificadas em ordem decrescente do número de minutos assistidos.
dimensions=country metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue filters=uploaderType==self sort=-estimatedMinutesWatched
Métricas de anotação específicas de um país para o conteúdo enviado automaticamente
Esta solicitação recupera contagens de visualizações específicas do país, taxas de cliques de anotação, taxas de fechamento de anotação e impressões de anotação para os vídeos enviados do proprietário do conteúdo. Os resultados são classificados por taxa de clique de anotação em ordem decrescente, o que significa que o país com a maior taxa de clique de anotação será o primeiro da lista.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=uploaderType==self sort=-annotationClickThroughRate
Métricas específicas da província para os estados dos EUA e Washington D.C.
Esta solicitação recupera o detalhamento das contagens de visualizações, de minutos assistidos estimados e de duração média da visualização dos vídeos reivindicados do proprietário do conteúdo. Os dados abrangem os estados dos EUA e Washington D.C. Os resultados são classificados em ordem alfabética pelos códigos ISO 3166-2 das províncias.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 principais cidades dos EUA pelo total de visualizações
Esta consulta recupera uma lista das 10 cidades dos EUA que representaram o maior número de visualizações de vídeos reivindicados do proprietário do conteúdo durante o período especificado. A consulta pode ser modificada para solicitar dados de outro país. Para isso, escolha outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos seus valores válidos. Outros filtros também são aceitos. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=city metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
10 principais cidades dos EUA pelo total de visualizações para cada tipo de conteúdo
Esta consulta recupera uma lista das 10 cidades dos EUA que representaram o maior número de visualizações do conteúdo reivindicado do proprietário do conteúdo durante o período especificado para cada creatorContentType suportado. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=city,creatorContentType metrics=views filters=claimedStatus==claimed;country==US maxResults=10 sort=-views
10 principais cidades dos EUA por tempo de exibição total
Esta consulta recupera uma lista dos 10 principais dias durante o período especificado, quando qualquer cidade dos EUA foi responsável pelo maior tempo de exibição diário total do conteúdo reivindicado do proprietário do conteúdo. Os resultados da consulta identificam o tempo de exibição total, a data em que ocorreu o tempo de exibição e a cidade em que o conteúdo foi estimado. Os resultados são classificados em ordem decrescente do tempo total de exibição.
dimensions=city,day metrics=estimatedWatchTime filters=claimedStatus==claimed;country==US maxResults=10 sort=-estimatedWatchTime
10 mais – Vídeos mais assistidos na Europa
Esta consulta recupera os 10 vídeos mais assistidos na Europa, entre vídeos reivindicados pelo proprietário do conteúdo, conforme medido pelo número de visualizações durante o período especificado. É possível modificar a consulta para solicitar dados de outro continente escolhendo outro valor válido para esse filtro. Da mesma forma, a consulta pode ser modificada para recuperar dados de um subcontinente, como a Europa Ocidental ou o Sudeste Asiático, usando o filtro subContinent e um dos seus valores válidos. Os resultados são classificados por contagem de visualizações em ordem decrescente.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=claimedStatus==claimed;filters=continent==150 maxResults=10 sort=-estimatedMinutesWatched
Relatórios de playlists
Métricas de tempo de exibição específicas de um país para as playlists de um proprietário de conteúdo
Esta consulta recupera contagens de visualizações de playlist específicas do país e métricas de tempo de exibição da playlist para todas as playlists nos canais do proprietário do conteúdo. O relatório retorna uma linha de dados para cada país em que as playlists foram assistidas. As linhas são classificadas em ordem decrescente do número de minutos assistidos.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
10 principais – Playlists mais ouvidas nos Estados Unidos
Esta consulta recupera as 10 playlists dos canais do proprietário do conteúdo que os espectadores nos Estados Unidos começaram a assistir com mais frequência durante o período especificado. Os resultados são classificados por número de inícios de playlist em ordem decrescente.
Observação: como esse relatório usa a dimensão playlist
, você precisa especificar um valor para o parâmetro de solicitação sort
e também definir o parâmetro maxResults
como um valor inteiro de 10
ou menos.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Relatórios de vídeo
Marcações "Gostei" e "Não gostei" por tipo de conteúdo
Esta consulta recupera o número de marcações "gostei" e "não gostei" para cada tipo de conteúdo em um canal ou grupo de canais específico. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=creatorContentType metrics=likes,dislikes filters=channel==CHANNEL_ID
Relatórios de vídeo
Contagens de exibições e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera o número de visualizações e o tempo de exibição estimado para vídeos enviados a um canal ou grupo de canais específico. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e classificados em ordem decrescente por contagem de visualizações. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Contagens diárias de visualizações e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera as contagens diárias de visualização e o tempo de exibição estimado nos Estados Unidos para vídeos enviados a um canal ou grupo de canais específico. Os resultados são agrupados por dia para cada tipo de aplicativo ou página em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica inversa. Para executar essa consulta no APIs Explorer, substitua a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US;channel==CHANNEL_ID sort=-day
10 mais – Sites de terceiros que geram o maior número de visualizações para um vídeo incorporado
Esta consulta recupera as contagens de visualização e o tempo de exibição estimado para um determinado vídeo ou grupo de vídeos. Os resultados são agrupados por site de terceiros em que o vídeo foi incorporado. Os resultados são classificados em ordem decrescente por contagem de visualizações. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de vídeos para os vídeos enviados.
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
Relatórios de playlists
Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera o número de visualizações e o tempo de exibição estimado da lista de reprodução, bem como o número de inicializações da lista de reprodução para todas as listas de reprodução nos canais de um proprietário de conteúdo. Os resultados são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram e classificados em ordem decrescente por inícios de playlist.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
Esta consulta recupera inícios de playlist diários, contagens de visualização de playlist e tempo de exibição estimado de playlist nos Estados Unidos para todas as playlists nos canais de um proprietário de conteúdo. Os resultados são retornados para cada tipo de página ou aplicativo em que as visualizações de playlist ocorreram.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Relatórios de vídeo
Contagens de exibições e tempo de exibição de diferentes origens de tráfego
Esta solicitação recupera o número de visualizações e o tempo exibição estimado para os vídeos do proprietário do conteúdo. As métricas são agregadas por origem de tráfego, que descreve a maneira pela qual os usuários chegaram ao vídeo.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego
Esta solicitação recupera as contagens de visualizações diárias e o tempo de exibição diário estimado para vídeos do proprietário do conteúdo. As métricas são agregadas diariamente por origem de tráfego e classificadas em ordem cronológica inversa.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Observação: os dois próximos exemplos de relatório são compatíveis apenas com origens de tráfego específicas. Por exemplo, a origem de tráfego NO_LINK_EMBEDDED
não tem detalhes adicionais e, portanto, os relatórios não estão disponíveis para ela. Confira a definição de insightTrafficSourceType para detalhes sobre as origens de tráfego para as quais esses tipos de relatório estão disponíveis.
10 mais – Termos de pesquisa do YouTube que geram mais tráfego para um vídeo
Esta consulta recupera os 10 termos de pesquisa que geraram o maior número de visualizações nos resultados de pesquisa do YouTube para um vídeo específico ou grupo de vídeos. Os resultados são classificados por contagem de visualizações em ordem decrescente. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de vídeos para os vídeos enviados.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
10 principais – Sites externos que geram o maior tráfego para um vídeo
Esta consulta recupera os 10 sites externos que geraram o maior número de visualizações a partir dos resultados da pesquisa do Google para um vídeo específico ou grupo de vídeos. Os resultados são classificados por tempo de exibição estimado em ordem decrescente. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de vídeos para os vídeos enviados.
dimensions=insightTrafficSourceDetail metrics=estimatedMinutesWatched,views filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL maxResults=25 sort=-estimatedMinutesWatched
Relatórios de playlists
Contagens de visualizações de playlists e tempo de exibição de diferentes origens de tráfego em um país
Esta solicitação recupera o número de visualizações e inícios de playlist e o tempo de exibição estimado para visualizações de playlist em um país especificado. As métricas são agregadas por origem do tráfego, que descreve como os usuários chegaram à playlist.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Contagens de visualizações de playlists e tempo de exibição de diferentes origens de tráfego
Esta solicitação recupera visualizações, inícios e tempo de exibição estimado de playlists em um ou mais canais do proprietário do conteúdo. As métricas são agregadas por origem do tráfego. Para executar essa consulta no APIs Explorer, você precisa substituir a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Relatórios de vídeo
Métricas diárias do tipo de dispositivo para vídeos reivindicados
Esta consulta recupera as contagens de visualizações diárias e o tempo de exibição estimado por tipo de dispositivo para vídeos reivindicados por um proprietário do conteúdo específico. Os resultados são agrupados por dia para cada tipo de dispositivo em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Métricas diárias do sistema operacional para vídeos reivindicados visualizados em dispositivos móveis
Esta consulta recupera as contagens diárias de visualização e o tempo de exibição estimado por sistema operacional para visualizações de vídeos reivindicados por um proprietário de conteúdo especificado que ocorreram em dispositivos móveis. Os resultados são agrupados por dia para cada sistema operacional em que as reproduções do vídeo ocorreram. Os resultados são classificados em ordem cronológica.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Métricas diárias do sistema operacional e do tipo de dispositivo
Esta consulta recupera as contagens diárias de visualização e o tempo de exibição estimado para vídeos reivindicados por um proprietário de conteúdo específico. As estatísticas são agrupadas por sistema operacional e tipo de dispositivo. Os resultados são classificados em ordem cronológica.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Relatórios de playlists
Métricas de tipo de dispositivo para visualizações de playlists no sistema operacional Android
Esta consulta recupera as contagens de visualizações e o tempo de exibição estimado da playlist em dispositivos Android para playlists em um ou mais canais do proprietário do conteúdo. Os resultados são retornados para
cada tipo de dispositivo em que as visualizações de playlist ocorreram. Para executar essa consulta no APIs Explorer, você precisa substituir a string CHANNEL_ID
no valor do parâmetro filters
por uma lista separada por vírgulas de até 500 IDs de canal para seus canais.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Métricas do sistema operacional para visualizações de playlists em dispositivos móveis
Esta consulta recupera as contagens de visualização da lista de reprodução e o tempo de exibição estimado da lista em dispositivos móveis para listas de reprodução em qualquer um dos canais do proprietário do conteúdo. Os resultados são retornados para cada sistema operacional em que as visualizações da playlist ocorreram.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Relatórios de vídeo
Informações demográficas dos espectadores na Califórnia (idade e gênero)
Este relatório recupera estatísticas sobre a faixa etária e o gênero dos espectadores na Califórnia que assistiram o conteúdo reivindicado do proprietário. Os resultados são classificados por sexo e depois por faixa etária. É possível modificar esta consulta para recuperar as mesmas estatísticas de todos os espectadores do mundo todo ou de todos os espectadores em um país, continente, subcontinente ou outro estado dos EUA. Para isso, ajuste o valor do parâmetro filters
.
dimensions=ageGroup,gender metrics=viewerPercentage filters=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Métricas de compartilhamento, agregadas por serviço onde os vídeos foram compartilhados
Esta solicitação recupera o número de vezes que os usuários utilizaram o botão Share
para compartilhar vídeos que o proprietário do conteúdo enviou. Os resultados são agregados por serviço de compartilhamento (Google+, Twitter etc) e classificados em ordem decrescente do número de compartilhamentos.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Métricas de retenção de público para um vídeo
Esse relatório mede a capacidade de um vídeo de manter o público. O relatório só pode ser recuperado para um único vídeo por vez. Para executar essa consulta no APIs Explorer, substitua a string VIDEO_ID
no valor de parâmetro filters
pelo ID do vídeo para um dos vídeos enviados. Os relatórios de retenção de público não são compatíveis com a capacidade de especificar vários valores para o filtro video
.
Neste exemplo, o relatório usa o filtro audienceType
para restringir a resposta para que ela contenha apenas dados de visualizações orgânicas, que são resultado de uma ação direta do usuário, como uma pesquisa por um vídeo ou um clique em um vídeo sugerido. Sendo assim, o relatório não inclui dados de visualizações de anúncios TrueView in-stream ou TrueView em Display. Você pode remover o filtro para recuperar os dados de retenção de público do vídeo para todos os tipos de público.
Os dados do filtro audienceType
estão disponíveis desde 25 de setembro de 2013. A API não retornará dados para consultas que usam o filtro para tentar recuperar dados de datas anteriores. As consultas que não usam o filtro funcionam para qualquer data posterior a 1o de julho de 2008.
dimensions=elapsedVideoTimeRatio metrics=audienceWatchRatio,relativeRetentionPerformance filters=video==VIDEO_ID;audienceType==ORGANIC
Métricas de receita e desempenho de anúncios para conteúdo reivindicado
Esta solicitação recupera métricas de receita e desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo. O relatório retorna uma única linha de dados que contém os totais de cada métrica solicitada durante o período especificado.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Métricas de receita diária e performance de anúncios
Esta solicitação recupera a receita diária e as métricas de desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Métricas de receita e performance de anúncios específicas do país
Esta solicitação recupera métricas de receita e desempenho de anúncios específicas de um país para o conteúdo reivindicado do proprietário do conteúdo. Os resultados são classificados em ordem decrescente por valor de receita, o que significa que o primeiro país listado será aquele em que o parceiro teve a maior receita estimada.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed sort=-estimatedRevenue
10 mais – Vídeos com a maior receita
Esta solicitação recupera métricas de receita e desempenho de anúncios para os 10 vídeos que foram reivindicados pelo proprietário do conteúdo e tiveram a maior receita. Os resultados são classificados em ordem decrescente por valor de receita, o que significa que o primeiro vídeo será o que teve a maior receita estimada.
dimensions=video metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed maxResults=10 sort=-estimatedRevenue
Métricas de desempenho de anúncios para diferentes tipos de anúncios
Esta solicitação recupera métricas de desempenho de anúncios para o conteúdo reivindicado do proprietário do conteúdo. Os resultados são agrupados por tipo de anúncio, o que permite comparar os valores de receita e de CPM em diferentes tipos de anúncios.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType