YouTube Analytics API: Content Owner Reports

Observação:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

Esta página lista relatórios que os proprietários de conteúdo podem recuperar com a API YouTube Analytics. Os relatórios do proprietário do conteúdo contêm métricas dos canais vinculados a um proprietário do conteúdo do YouTube especificado. As métricas são medidas individuais de atividade do usuário, desempenho de anúncios ou receita estimada.

  • Os relatórios de vídeo contêm métricas de atividade do usuário, desempenho de anúncios e receita estimada dos vídeos nos canais do proprietário do conteúdo.

  • Os relatórios de playlist apresentam estatísticas especificamente relacionadas às exibições de vídeos que ocorrem no contexto de uma playlist. Os relatórios de playlists usam muitas das mesmas dimensões e filtros dos relatórios de vídeo.

  • Os relatórios de performance de anúncios contêm métricas relacionadas à receita e ao desempenho dos anúncios. Eles usam a dimensão adType para agrupar métricas com base nos tipos de anúncios que são exibidos durante as reproduções de vídeo. A seção Relatórios de desempenho de anúncios explica os dois tipos de métricas de desempenho de anúncios que a API suporta.

Como recuperar um relatório

Para recuperar um relatório do proprietário do conteúdo, chame o método reports.query da API e defina o valor do parâmetro ids na solicitação de API como contentOwner==OWNER_NAME, em que OWNER_NAME especifica o ID do proprietário do conteúdo. Pergunte ao seu gerente de parcerias se você não tiver certeza do valor.

Autorização

Todas as solicitações da API YouTube Analytics precisam ser autorizadas. O Guia de autorização explica como usar o protocolo OAuth 2.0 para recuperar tokens de autorização.

As solicitações da API YouTube Analytics usam os seguintes escopos de autorização:

Escopos
https://www.googleapis.com/auth/yt-analytics.readonly Visualizar os relatórios do YouTube Analytics para seu conteúdo do YouTube. Este escopo fornece acesso às métricas de atividade do usuário, como contagens de visualização e de classificação.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly Visualizar os relatórios monetários do YouTube Analytics para seu conteúdo do YouTube. Esse escopo fornece acesso às métricas de atividade do usuário, à receita estimada e ao desempenho de anúncios.
https://www.googleapis.com/auth/youtube Gerenciar sua conta do YouTube. Na API YouTube Analytics, os proprietários de canais usam esse escopo para gerenciar grupos e itens de grupos do YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner Veja e gerencie os recursos e conteúdos associados do YouTube na plataforma. Na API YouTube Analytics, os proprietários de conteúdo usam esse escopo para gerenciar grupos e itens de grupos do YouTube Analytics.

Observação:as métricas marcadas com um asterisco (*) exigem um token de autorização que concede acesso ao escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Filtros

Todas as solicitações de API para recuperar relatórios do proprietário do conteúdo precisam filtrar os dados usando as dimensões video, channel, isCurated ou uma combinação compatível das dimensões claimedStatus e uploaderType. As combinações aceitas estão listadas na definição da dimensão uploaderType.

As tabelas que explicam os relatórios compatíveis identificam os filtros que podem ser usados para qualquer relatório. Nas descrições, os filtros entre parênteses são opcionais. Por exemplo, se um relatório lista video(,country) como uma opção de filtro, ele pode ser filtrado para incluir somente dados de um vídeo específico ou somente os dados de um vídeo específico em um país específico.

A API também permite especificar vários valores para os filtros video, playlist e channel. Se você especificar diversos valores para um desses filtros, também poderá adicionar esse filtro à lista de dimensões especificadas para a solicitação. Isso acontece mesmo que o filtro não esteja listado como uma dimensão compatível com um determinado relatório.

Consulte a definição do parâmetro filters para uma explicação completa sobre como filtrar os resultados da API para um valor ou conjunto de valores específico.

Como interpretar as tabelas de relatórios

Esta seção explica a formatação e a terminologia usadas nas tabelas que definem os relatórios compatíveis com a API. A tabela abaixo lista as dimensões, métricas e filtros compatíveis com o relatório de detalhes de reprodução de vídeo usando a dimensão de tempo e a métrica averageViewPercentage.

Conteúdo
Dimensões:
Use 0 ou mais creatorContentType, subscribedStatus, youtubeProduct
Use 0 ou 1 dia, mês
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou 1 vídeo, grupo
Use 0 ou mais subscribedStatus, youtubeProduct

A tabela contém duas linhas para dimensões, uma para métricas e três linhas para filtros. Para dimensões e filtros, os valores de cada linha podem ser combinados em uma solicitação de API, desde que a combinação siga as regras de uso na tabela. Por exemplo, os valores válidos do parâmetro dimensions para esse relatório incluem:

  • dimensions=day
  • dimensions=day,liveOrOnDemand
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

No entanto, o valor do parâmetro day,month é inválido porque usa duas dimensões com base no tempo, mas a solicitação pode usar 0 ou 1. Nesse caso, o valor de parâmetro subscribedStatus,youtubeProduct retorna um relatório, mas as métricas não são agregadas por dia, semana, mês etc. Esse relatório é documentado separadamente na documentação.

Terminologia da tabela de relatórios

As tabelas usam a terminologia a seguir para indicar se as dimensões são obrigatórias ou opcionais:

  • Esses termos significam que um valor é necessário:
    • Obrigatório:você precisa incluir o valor.
    • Usar exatamente 1:você precisa incluir um valor do grupo.
    • Usar 1 ou mais:você pode incluir qualquer um ou todos os valores do grupo, mas precisa incluir pelo menos um.
  • Esses termos significam que um valor é opcional:
    • Opcional:você tem a opção de incluir o valor.
    • Usar 0 ou 1:você tem a opção de incluir um valor do grupo.
    • Usar 0 ou mais:você tem a opção de incluir um ou todos os valores do grupo.
Importante: todas as solicitações de API para recuperar relatórios de vídeo do proprietário do conteúdo precisam filtrar os dados usando a dimensão video, channel, group ou uma combinação compatível das dimensões claimedStatus e uploaderType. Alguns relatórios não suportam todas essas opções. As combinações aceitas, que também estão listadas na definição da dimensão uploaderType, são:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

Relatórios de vídeo

Estatísticas básicas

Estatísticas básicas (incluindo contagens de inscritos)

Este relatório fornece estatísticas relacionadas às ações do usuário nos canais de todos os proprietários de conteúdo. É possível filtrar o relatório para retornar somente os dados de um vídeo ou país específicos. Ela também pode ser usada para recuperar apenas as estatísticas do conteúdo reivindicado, incluindo o conteúdo reivindicado enviado pelo proprietário do conteúdo, por terceiros ou ambos.

Conteúdo
Dimensões:
[None]
Métricas:
Use 1 ou mais views, redViews, comment="#comments, likeimpressões, nemcardRates, videosAddedToPlaylistsaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, continente, subContinent

Estatísticas básicas para os estados dos EUA

Neste relatório, são exibidas as estatísticas para um estado específico nos EUA ou para o Distrito de Columbia. Ele é compatível apenas com um subconjunto das métricas disponíveis no relatório de país específico descrito acima.

Conteúdo
Dimensões:
[None]
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, {annotationMinutesAssisted, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationCloseRate, {annotationAnnotation2Clicks, annotationClickableImpressions, {20CloseViewClicksannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório province

Por períodos

Atividade para períodos

Este relatório fornece estatísticas relacionadas às ações do usuário em todos os canais do proprietário do conteúdo em intervalos de tempo específicos. É possível filtrar o relatório para retornar somente os dados de um vídeo ou país específicos.

Conteúdo
Dimensões:
Use exatamente 1 dia, mês
Opcional creatorContentType
Métricas:
Use 1 ou mais Monetviews, redViews, comment="#comments, like29Clicks, unif DEvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, continente, subContinent

Atividade do usuário em estados nos EUA em períodos específicos

Neste relatório, são exibidas as estatísticas para um estado específico nos EUA ou para o Distrito de Columbia. Ele é compatível apenas com um subconjunto das métricas disponíveis no relatório de país específico descrito acima.

Conteúdo
Dimensões:
Use exatamente 1 dia, mês
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, {annotationMinutesAssisted, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationCloseRate, {annotationAnnotation2Clicks, annotationClickableImpressions, {20CloseViewClicksannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório province

Localização do usuário

Atividade do usuário por país

Este relatório mostra estatísticas relacionadas à atividade do usuário em cada país para todos os canais do proprietário do conteúdo. É possível filtrar o relatório para retornar somente os dados de um vídeo ou canal específico.

Conteúdo
Dimensões:
Obrigatório country
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, comment="#comments, likeimpressões, nemcardRates, videosAddedToPlaylistsaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 continente e subContinent

Atividade do usuário por província

Neste relatório, são exibidas as estatísticas da atividade do usuário para estados nos EUA e para o Distrito de Columbia. Para esse relatório, é necessário definir o valor do parâmetro filters como country==US.

Conteúdo
Dimensões:
Obrigatório province
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, {annotationMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationCloseRate, {annotationAnnotation2Clicks, annotationClickableImpressions, {20CloseViewImpressõesannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório país==BR

Atividade do usuário por cidade (<= 250 resultados)

Observação:neste relatório, é necessário definir o parâmetro maxResults como um valor inteiro de 250 ou menos. Ao contrário da maioria dos outros relatórios, nesse relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Esse relatório fornece estatísticas de atividade do usuário por cidade.

Conteúdo
Dimensões:
Obrigatório city
Use 0 ou mais creatorContentType, country, Territory, subscribedStatus

Observação:se você incluir a dimensão província, também vai precisar usar o filtro country==US.
Use 0 ou 1 dia, mês
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration e averageViewPercentage
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Opções de classificação: -visualizações
-estimatedMinutesWatched

Detalhes da reprodução

Os relatórios de detalhes de reprodução fornecem estatísticas relacionadas aos seguintes atributos de visualização:

  • A visualização foi de uma transmissão ao vivo ou de um vídeo on demand?
  • O espectador estava inscrito no canal proprietário do vídeo?
  • Em qual produto do YouTube a visualização ocorreu?

Tecnicamente, as dimensões de detalhes de reprodução compatíveis com esses relatórios são opcionais. Se você não incluir as dimensões de detalhes de reprodução na sua solicitação, o relatório retornado será semelhante a um dos relatórios de estatísticas básicas, baseados no tempo ou geografia do usuário.

Observação: a dimensão e o filtro liveOrOnDemand não podem ser usados com a métrica averageViewPercentage. Assim, cada uma das subseções a seguir lista dois relatórios. Um relatório é compatível com a dimensão e o filtro liveOrOnDemand, e o outro com a métrica averageViewPercentage.

Atividade do usuário por status de inscrição

Nesse relatório, são exibidas métricas de atividade do usuário para espectadores inscritos e não inscritos. As estatísticas podem ser agrupadas por período (dia ou mês) e o relatório também pode ser filtrado por país, continente ou subContinent.

Conteúdo
Dimensões:
Use 0 ou mais creatorContentType, subscribedStatus
Use 0 ou 1 dia, mês
Métricas:
Use 1 ou mais views, redViews, annotations, interno2Clicks, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, continente, subContinent
Opcional subscribedStatus

Atividade do usuário por status de inscrição para províncias

Neste relatório, são exibidas métricas de atividade do usuário para espectadores inscritos e não inscritos nos estados dos EUA ou no Distrito de Colúmbia. Este relatório suporta menos métricas do que o anterior.

Conteúdo
Dimensões:
Use 0 ou mais creatorContentType, subscribedStatus
Use 0 ou 1 dia, mês
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, {annotationMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationCloseRate, {annotationAnnotation2Clicks, annotationClickableImpressions, {20CloseViewImpressõesannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório province
Opcional subscribedStatus

Detalhes de reprodução com dimensão de tempo opcional

A dimensão de tempo (dia ou mês) é opcional para esses relatórios porque, independentemente disso, você precisa usar os parâmetros de solicitação startDate e endDate para especificar o período que o relatório abrangerá. A dimensão, se presente, indica que você quer que os dados do relatório sejam agregados por dia, mês etc.

Detalhes de reprodução com dimensão de tempo opcional e estatísticas liveOrOnDemand

Esse relatório fornece estatísticas detalhadas de reprodução para intervalos de tempo específicos. Ele aceita a dimensão e o filtro liveOrOnDemand.

Conteúdo
Dimensões:
Use 0 ou mais creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Use 0 ou 1 dia, mês
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus, youtubeProduct
Detalhes de reprodução com dimensão de tempo opcional e métrica averageViewPercentage

Esse relatório fornece estatísticas detalhadas de reprodução para intervalos de tempo específicos.

Conteúdo
Dimensões:
Use 0 ou mais creatorContentType, subscribedStatus, youtubeProduct
Use 0 ou 1 dia, mês
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais subscribedStatus, youtubeProduct

Detalhes de reprodução por país

Detalhes de reprodução por país com estatísticas liveOrOnDemand

Esse relatório fornece estatísticas detalhadas de reprodução por país. Ele aceita a dimensão e o filtro liveOrOnDemand.

Conteúdo
Dimensões:
Opcional country
Use 0 ou mais creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 continente e subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus, youtubeProduct
Detalhes de reprodução por país com a métrica averageViewPercentage

O relatório a seguir é semelhante ao anterior. Ele adiciona suporte para a métrica averageViewPercentage, mas não aceita liveOrOnDemand como uma dimensão ou um filtro.

Conteúdo
Dimensões:
Opcional country
Use 0 ou mais creatorContentType, subscribedStatus, youtubeProduct
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 continente e subContinent
Use 0 ou mais subscribedStatus, youtubeProduct

Detalhes da reprodução por província

Detalhes de reprodução por província com estatísticas liveOrOnDemand

Este relatório fornece estatísticas detalhadas de reprodução para os estados dos EUA e o Distrito de Colúmbia. Ele aceita a dimensão e o filtro liveOrOnDemand.

Conteúdo
Dimensões:
Opcional province
Use 0 ou mais creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório país==US
Use 0 ou mais liveOrOnDemand, subscribedStatus, youtubeProduct
Detalhes de reprodução por província com a métrica averageViewPercentage

O relatório a seguir é semelhante ao anterior. Ele adiciona suporte para a métrica averageViewPercentage, mas não aceita liveOrOnDemand como uma dimensão ou um filtro.

Conteúdo
Dimensões:
Opcional province
Use 0 ou mais creatorContentType, subscribedStatus, youtubeProduct
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório país==US
Use 0 ou mais subscribedStatus, youtubeProduct

Locais de reprodução

Relatório do local de reprodução do vídeo

Neste relatório, são exibidas as estatísticas relacionadas ao tipo de página ou aplicativo em que ocorreram as reproduções do vídeo.

Conteúdo
Dimensões:
Obrigatório insightPlaybackLocationType
Use 0 ou mais creatorContentType, day, liveOrOnDemand, subscribedStatus
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus

Detalhe do local da reprodução (<= 25 resultados)

Observação:neste relatório, é necessário definir o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, nesse relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Esse relatório identifica os players de vídeo incorporados que geraram o maior número de visualizações ou tempo de visualização para o conteúdo do proprietário de um conteúdo. Ao recuperar esse relatório, você precisa definir o filtro insightPlaybackLocationType como EMBEDDED.

Conteúdo
Dimensões:
Obrigatório insightPlaybackLocationDetail
Opcional creatorContentType
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório insightPlaybackLocationType==encodedDED
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus
Opções de classificação: -visualizações
-estimatedMinutesWatched

origens de tráfego

Origem do tráfego

Neste relatório, são agregadas as estatísticas de visualização com base na forma como os espectadores chegaram ao conteúdo de seu vídeo. Por exemplo, nele é identificado o número de visualizações originadas em uma pesquisa no Google ou em um link para um vídeo relacionado.

Conteúdo
Dimensões:
Obrigatório insightTrafficSourceType
Use 0 ou mais creatorContentType, day, liveOrOnDemand, subscribedStatus
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus

Detalhe de origem do tráfego (<= 25 resultados)

Observação:neste relatório, é necessário definir o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, nesse relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Este relatório agrega estatísticas de visualização com base nos referenciadores que geraram o maior número de visualizações para o conteúdo do proprietário do conteúdo. Os referenciadores são categorizados por tipo de origem do tráfego, e na definição da dimensão insightTrafficSourceDetail são identificadas as origens do tráfego para o qual o relatório está disponível. Por exemplo, se você definir o filtro insightTrafficSourceType como ADVERTISING, o relatório listará os tipos de anúncios que geraram mais visualizações ou tempo de visualização para o conteúdo do proprietário do conteúdo.

Conteúdo
Dimensões:
Obrigatório insightTrafficSourceDetail
Opcional creatorContentType
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Obrigatório insightTrafficSourceType (consulte a observação abaixo da tabela)
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus
Opções de classificação: -visualizações
-estimatedMinutesWatched

Nota: este relatório é compatível apenas com origens do tráfego específicas. Por exemplo, a origem de tráfego NO_LINK_EMBEDDED não tem detalhes adicionais e, portanto, não suporta este relatório. Consulte a definição de insightTrafficSourceType para mais detalhes sobre quais origens de tráfego são compatíveis com esse relatório.

Tipo de dispositivo e sistema operacional

Tipo de dispositivo

Neste relatório, são agregadas as estatísticas de visualização com base no tipo de dispositivo que os espectadores usaram ao assistir seu conteúdo. Por exemplo, identifica o número de visualizações que ocorreram em tablets ou consoles de jogos.

Conteúdo
Dimensões:
Obrigatório deviceType
Use 0 ou mais creatorContentType, day, liveOrOnDemand, subscribedStatus e youtubeProduct
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistema operacional

Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em dispositivos Android ou em PlayStations.

Conteúdo
Dimensões:
Obrigatório operatingSystem
Use 0 ou mais creatorContentType, day, liveOrOnDemand, subscribedStatus e youtubeProduct
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

Sistema operacional e tipo de dispositivo

Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais e nos tipos de dispositivo dos espectadores. Por exemplo, nele é identificado o número de visualizações que ocorreram em tablets Android ou em computadores com Windows.

Conteúdo
Dimensões:
Obrigatório operatingSystem,deviceType
Use 0 ou mais creatorContentType, day, liveOrOnDemand, subscribedStatus e youtubeProduct
Métricas:
Use 1 ou mais views e estimatedMinutesWatched
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus, youtubeProduct

Informações demográficas do espectador

Neste relatório, são agregadas as estatísticas de visualização com base na faixa etária e no gênero dos espectadores.

Conteúdo
Dimensões:
Use 1 ou mais ageGroup, gender
Use 0 ou mais creatorContentType, liveOrOnDemand, subscribedStatus
Métricas:
Use 1 ou mais viewerPercentage
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus
Observação:os valores de viewerPercentage neste relatório não são normalizados para valores diferentes da dimensão de detalhes de reprodução subscribedStatus.

Por exemplo, se um relatório usa a dimensão subscribedStatus, ele retorna dados de viewerPercentage que somam 100% para visualizações inscritas e viewerPercentage dos dados de inscrições canceladas, somando a porcentagem de dados de inscrições canceladas. se um relatório usa a dimensão subscribedStatus. O valor total de todos os campos viewerPercentage no relatório é de 200%.

Você pode usar filtros para garantir que o relatório contenha apenas dados viewerPercentage para um valor da dimensão subscribedStatus.

Engajamento e compartilhamento de conteúdo

Neste relatório, são exibidas as estatísticas da frequência em que vídeos do canal foram compartilhados em diferentes plataformas sociais.

Conteúdo
Dimensões:
Obrigatório sharingService
Opcional creatorContentType, subscribedStatus
Métricas:
Use 1 ou mais compartilhamentos
Filtros:
Use exatamente 1 video, channel, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, continente, subContinent
Opcional subscribedStatus

Retenção de público

Esse relatório mede a capacidade de um vídeo de manter o público. A dimensão elapsedVideoTimeRatio mede o tempo decorrido do vídeo para os valores de métrica correspondentes. As métricas audienceWatchRatio e relativeRetentionPerformance fornecem duas medições que mostram a eficiência do vídeo em reter o público. O primeiro é um valor absoluto, enquanto o segundo mostra o desempenho do vídeo em relação a outros vídeos do YouTube de duração semelhante.

Observação: os relatórios de retenção de público não são compatíveis com a capacidade de especificar uma lista de valores separados por vírgulas para o filtro video; o valor precisa especificar um único ID do vídeo.

Conteúdo
Dimensões:
Obrigatório elapsedVideoTimeRatio
Opcional creatorContentType
Métricas:
Use 1 ou mais audienceWatchRatio, relativeRetentionPerformance
Filtros:
Obrigatório vídeo
Use 0 ou mais audienceType, subscribedStatus, youtubeProduct

Vídeos mais acessados

Observação:esses relatórios exigem que você defina o parâmetro maxResults com um valor inteiro de 200 ou menos. Antes de 1o de janeiro de 2013, os dados estão disponíveis somente para os 10 vídeos principais. Diferentemente da maioria dos outros relatórios, neste relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Vídeos mais acessados em geral, por país, por continente ou por subcontinente (<= 200 resultados)

Este relatório lista os principais vídeos do proprietário do conteúdo com base nos critérios de filtragem e classificação especificados.

Conteúdo
Dimensões:
Obrigatório vídeo
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, comment="#comments, likeimpressões, nemcardRates, videosAddedToPlaylistsaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
Filtros:
Use exatamente 1 channel ou uma combinação compatível de uploaderType e claimedStatus
Use 0 ou 1 país, continente, subContinent
Opções de classificação: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

Principais vídeos em geral por estado dos EUA (<= 200 resultados)

Este relatório lista os principais vídeos do proprietário do conteúdo em um determinado estado dos EUA ou no Distrito de Colúmbia. Ele é compatível apenas com um subconjunto das métricas disponíveis no relatório de país específico descrito acima.

Conteúdo
Dimensões:
Obrigatório vídeo
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, {annotationMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationCloseRate, {annotationAnnotation2Clicks, annotationClickableImpressions, {20CloseViewImpressõesannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 channel ou uma combinação compatível de uploaderType e claimedStatus
Obrigatório province
Opções de classificação: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Vídeos mais acessados para espectadores inscritos ou não(<= 200 resultados)

Esse relatório lista os principais vídeos entre espectadores inscritos ou não. O relatório pode ser filtrado para listar os principais vídeos por país, continente ou subContinent. O relatório anterior permitia recuperar os principais vídeos em um determinado estado nos EUA para espectadores inscritos ou não, mas suporta menos métricas do que este.

Conteúdo
Dimensões:
Obrigatório vídeo
Opcional creatorContentType
Métricas:
Use 1 ou mais Annotationviews, redViews, annotations, doesClick3Clicks,Annotation2ClicksRate, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
Filtros:
Use exatamente 1 channel ou uma combinação compatível de uploaderType e claimedStatus
Opcional subscribedStatus
Use 0 ou 1 país, continente, subContinent
Opções de classificação: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Principais vídeos por produto do YouTube (<= 200 resultados)

Esse relatório lista os principais vídeos e é compatível com filtros geográficos e de detalhes de reprodução. Este relatório é semelhante ao anterior, mas oferece suporte a menos métricas e inclui suporte para o filtro youtubeProduct.

Conteúdo
Dimensões:
Obrigatório vídeo
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtros:
Use exatamente 1 channel ou uma combinação compatível de uploaderType e claimedStatus
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais subscribedStatus, youtubeProduct
Opções de classificação: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Principais vídeos com filtros de detalhes de reprodução (<= 200 resultados)

Este relatório lista os principais vídeos do proprietário do conteúdo, filtrando por uma ou mais dimensões de detalhes de reprodução: liveOrOnDemand, subscribedStatus e youtubeProduct. O relatório também é compatível com a filtragem por região.

Conteúdo
Dimensões:
Obrigatório vídeo
Opcional creatorContentType
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched e averageViewDuration
Filtros:
Use exatamente 1 channel ou uma combinação compatível de uploaderType e claimedStatus
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais liveOrOnDemand, subscribedStatus, youtubeProduct
Opções de classificação: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Relatórios de playlists

Os relatórios de playlists contêm métricas relacionadas às atividades do usuário relacionadas aos vídeos nas playlists do proprietário do canal. Há duas versões desses relatórios disponíveis e, para cada relatório disponível, as seções a seguir contêm uma descrição de cada uma delas:

  • A guia Recomendados em cada seção descreve o formato de solicitação de API preferido para recuperar o relatório correspondente. Os relatórios recomendados são compatíveis com um conjunto expandido de métricas que inclui métricas de vídeo agregadas e métricas na playlist. Este formato de solicitação não usa a dimensão isCurated.
  • A guia Usando isCurated em cada seção descreve um formato de solicitação de API mais antigo em que a dimensão isCurated é obrigatória. Esses relatórios são compatíveis somente com métricas na playlist. O uso da dimensão isCurated foi suspenso em todos os relatórios. A nota de aviso abaixo explica o cronograma de descontinuação.

A observação de aviso a seguir explica as mudanças entre as duas versões do relatório com mais detalhes.

Métricas de vídeo agregadas

Elas 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 dela. As métricas para vídeos pertencentes a outros canais não são calculadas 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 a seção de métricas de playlists compatíveis para ver uma lista de métricas agregadas de vídeos compatíveis com o YouTube.

Métricas na playlist

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

Métricas de playlists compatíveis

Estatísticas básicas

Este relatório fornece estatísticas relacionadas às interações dos usuários com os vídeos das playlists nos canais de um proprietário do conteúdo. O relatório não tem dimensões obrigatórias.

Recomendado
Conteúdo
Dimensões:
[None]
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel
Usando isCurated
Conteúdo
Dimensões:
[None]
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obrigatório isCurated==1
Use 0 ou 1 canal, playlist, grupo
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais subscribedStatus, youtubeProduct

Por períodos

Este relatório apresenta estatísticas relacionadas às interações dos usuários com os vídeos nas playlists dos canais de um proprietário do conteúdo em intervalos específicos. É possível filtrar o relatório para retornar somente dados de uma playlist ou canal específico.

Recomendado
Conteúdo
Dimensões:
Use exatamente 1 dia, mês
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel

Localização do usuário

Neste relatório, são exibidas as estatísticas relacionadas às interações dos usuários em um determinado país com os vídeos das playlists do canal.

Este relatório fornece estatísticas de playlists por país.

Atividade da playlist por província

Este relatório mostra estatísticas de atividade de playlists para os estados dos EUA e o Distrito de Colúmbia. Para esse relatório, você inclui country==US no valor de parâmetro filters.

Locais de reprodução

Este relatório fornece estatísticas relacionadas ao tipo de página ou aplicativo em que as reproduções da playlist ocorreram.

Recomendado
Conteúdo
Dimensões:
Obrigatório insightPlaybackLocationType
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel

Detalhe do local da reprodução (<= 25 resultados)

Observação:neste relatório, é necessário definir o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, nesse relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Esse relatório identifica os players de vídeo incorporados que geraram o maior número de visualizações ou tempo de visualização para as listas de reprodução de um proprietário de conteúdo.

Recomendado
Conteúdo
Dimensões:
Obrigatório insightPlaybackLocationDetail
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Obrigatório insightPlaybackLocationType==EMBEDDED
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel
Opções de classificação: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

origens de tráfego

Neste relatório, são agregadas as estatísticas de visualização com base na maneira como os espectadores chegaram ao conteúdo da playlist. Por exemplo, ele identifica o número de visualizações que vieram de uma pesquisa do Google ou de uma página do canal.

Recomendado
Conteúdo
Dimensões:
Obrigatório insightTrafficSourceType
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel

Detalhe de origem do tráfego (<= 25 resultados)

Observação:neste relatório, é necessário definir o parâmetro maxResults como um valor inteiro de 25 ou menos. Ao contrário da maioria dos outros relatórios, nesse relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Este relatório agrega estatísticas de visualização com base nas referências que geraram o maior número de visualizações para as playlists do proprietário do conteúdo. Os referenciadores são categorizados por tipo de origem do tráfego, e na definição da dimensão insightTrafficSourceDetail são identificadas as origens do tráfego para o qual o relatório está disponível. Por exemplo, se você definir o filtro insightTrafficSourceType como ADVERTISING, o relatório listará os tipos de anúncios que geraram mais visualizações ou tempo de visualização para as playlists do proprietário do conteúdo.

Recomendado
Conteúdo
Dimensões:
Obrigatório insightTrafficSourceDetail
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Obrigatório insightTrafficSourceType
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel
Opções de classificação: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Nota: este relatório é compatível apenas com origens do tráfego específicas. Por exemplo, a origem de tráfego NO_LINK_EMBEDDED não tem detalhes adicionais e, portanto, não suporta este relatório. Consulte a definição de insightTrafficSourceType para mais detalhes sobre quais origens de tráfego são compatíveis com esse relatório.

Tipo de dispositivo e sistema operacional

Tipo de dispositivo para playlists

Neste relatório, são agregadas as estatísticas de visualização com base no tipo de dispositivo que os espectadores usaram para assistir o conteúdo da sua playlist. Por exemplo, identifica o número de visualizações que ocorreram em dispositivos móveis ou consoles de jogos.

Recomendado
Conteúdo
Dimensões:
Obrigatório deviceType
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel

Sistema operacional para playlists

Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais dos espectadores. Por exemplo, identifica o número de visualizações de playlists que ocorreram em dispositivos Android ou em PlayStations.

Recomendado
Conteúdo
Dimensões:
Obrigatório operatingSystem
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel

Sistema operacional e tipo de dispositivo para playlists

Neste relatório, são agregadas as estatísticas de visualização com base nos sistemas operacionais e nos tipos de dispositivo dos espectadores. Por exemplo, identifica o número de visualizações de playlist que ocorreram em tablets Android ou em computadores Windows.

Recomendado
Conteúdo
Dimensões:
Obrigatório deviceType e operatingSystem (link em inglês)
Métricas:
Use 1 ou mais views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtros:
Use 0 ou 1* playlist, group

Observação:exatamente um desses filtros precisa ser especificado se alguma das métricas de views, estimatedMinutesWatched ou averageViewDuration for solicitada no relatório.
Opcional channel

Informações demográficas do espectador

Neste relatório, são agregadas as estatísticas de visualização com base na faixa etária e no gênero dos espectadores.

Observação:os valores de viewerPercentage neste relatório não são normalizados para diferentes valores ou combinações de valores para as dimensões de detalhes de reprodução (subscribedStatus e youtubeProduct).

Por exemplo, um relatório que usa a dimensão subscribedStatus retorna dados de viewerPercentage, adicionando até 100% para visualizações de inscritos e a porcentagem de visualizações de usuários inscritos. a porcentagem de visualizações canceladas.viewerPercentage O valor total de todos os campos viewerPercentage do relatório é de 200%.

Você pode usar filtros para garantir que o relatório contenha apenas dados de viewerPercentage para um valor (ou combinação de valores) para as dimensões de detalhes de reprodução.

Playlists mais acessadas

Observação:esses relatórios exigem que você defina o parâmetro maxResults com um valor inteiro de 200 ou menos. Antes de 1o de janeiro de 2013, os dados estão disponíveis somente para as 10 playlists principais. Diferentemente da maioria dos outros relatórios, neste relatório também é necessário especificar um valor para o parâmetro de solicitação sort.

Esse relatório lista as principais playlists do proprietário do conteúdo com base nos critérios de filtragem e classificação especificados.

Usando isCurated
Conteúdo
Dimensões:
Obrigatório playlist
Métricas:
Use 1 ou mais views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtros:
Obrigatório isCurated==1
Use 0 ou 1 playlist, channel
Use 0 ou 1 país, província, continente, subContinent
Use 0 ou mais subscribedStatus, youtubeProduct
Opções de classificação: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Relatórios de desempenho do anúncio

Observação:os relatórios de performance de anúncios exigem um token de autorização que concede acesso ao escopo https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

Os relatórios de desempenho de anúncios fornecem métricas com base em impressões para anúncios exibidos durante reproduções de vídeo. Essas métricas representam cada impressão de anúncio, e cada reprodução de vídeo pode gerar várias impressões.

As métricas de desempenho de anúncios baseados em impressão são:

Além disso, alguns relatórios de vídeo são compatíveis com as seguintes métricas de desempenho de anúncios com base em reprodução. Entretanto, essas métricas não estão incluídas nos relatórios de desempenho dos anúncios.

Performance do anúncio por tipo de anúncio

Conteúdo
Dimensões:
Obrigatório adType
Opcional dia
Métricas:
Use 1 ou mais grossRevenue, adImpressions, cpm
Filtros:
Use exatamente 1 video, group ou uma combinação compatível de uploaderType e claimedStatus.
Use 0 ou 1 país, continente, subContinent