Este documento define as dimensões compatíveis com a API YouTube Analytics. Essa API suporta consultas segmentadas em tempo real para gerar relatórios personalizados do YouTube Analytics.
As dimensões são critérios comuns usados para agregar dados, como a data em que a atividade do usuário ocorreu ou o país em que eles estavam.
Cada relatório de consulta identifica as dimensões que ele aceita. Por exemplo, ao recuperar a atividade do usuário por horário, escolha o período para o qual os dados serão informados: dia ou mês. Em todos os relatórios, cada linha de dados tem uma combinação exclusiva de valores de dimensão.
Para recuperar um relatório de consulta, chame o método reports.query
da API YouTube Analytics. Na sua solicitação, use o parâmetro dimensions
para especificar as dimensões que o YouTube usará para calcular os valores de métricas nos relatórios.
Dimensões principais
Embora a API YouTube Analytics esteja sujeita à política de descontinuação definida nos Termos de Serviço, as dimensões não principais (e as métricas não principais) não estão sujeitas à política. Nas definições desta página, qualquer dimensão que seja principal é identificada explicitamente como tal.
A lista a seguir identifica as dimensões principais da API.
Consulte a lista de APIs do YouTube sujeitas à política de descontinuação para saber mais.
Filtros
Todos os relatórios de consulta são compatíveis com filtros. Os filtros identificam valores de dimensão que precisam estar presentes no conjunto de dados recuperado. Assim, eles limitam uma resposta da API para incluir apenas dados correspondentes a um determinado valor ou conjunto de valores. Por exemplo, em vez de recuperar métricas de atividade do usuário para todos os países, é possível usar um filtro para recuperar apenas os dados de um país específico.
Em uma solicitação para recuperar um relatório de consulta, o parâmetro de solicitação filters
opcional especifica os valores de dimensão para os dados que você quer filtrar. Por exemplo, para recuperar métricas de atividade do usuário para a Europa, defina o valor do parâmetro filters
como continent==150
.
Importante: as solicitações de API para recuperar relatórios do proprietário do conteúdo precisam filtrar os dados usando uma das dimensões da entidade de relatório ou uma combinação compatível das dimensões claimedStatus
e uploaderType
.
Dimensões
As seções a seguir definem as dimensões usadas nos relatórios de consulta da API YouTube Analytics. Salvo indicação em contrário, essas dimensões são usadas nos relatórios do canal e do proprietário do conteúdo. As dimensões que só podem ser usadas como filtros também são identificadas.
Recursos
Estas dimensões correspondem aos recursos que canais e proprietários de conteúdo gerenciam no YouTube:
Observação:a API permite especificar vários valores para as dimensões video
, playlist
e channel
quando elas são usadas como filtros. Para isso, defina o valor do parâmetro filters
como uma lista separada por vírgulas dos IDs de vídeo, playlist ou canal em que a resposta da API precisa ser filtrada. O valor do parâmetro pode especificar até 500 IDs.
- vídeo (dimensão principal)
- O ID de um vídeo do YouTube. Na API YouTube Data, esse é o valor da propriedade
id
de um recursovideo
. This is a core dimension and is subject to the Deprecation Policy. - playlist
- O ID de uma playlist do YouTube. Na API YouTube Data, esse é o valor da propriedade
id
de um recursoplaylist
. - canal (dimensão principal) (usado somente em relatórios do proprietário do conteúdo)
- O ID de um canal do YouTube. Na API YouTube Data, esse é o valor da propriedade
id
de um recursochannel
. This is a core dimension and is subject to the Deprecation Policy.
A dimensãochannel
é usada com frequência nos relatórios do proprietário do conteúdo porque eles normalmente agregam dados para vários canais. - grupo (somente filtro)
- O ID de um grupo do YouTube Analytics. Você pode recuperar esse valor usando o método
groups.list
da API YouTube Analytics. Quando você usa o filtrogroup
, a resposta da API contém dados para todos os vídeos, playlists ou canais nesse grupo.
Exemplos
Os exemplos de solicitação a seguir usam filtros ou dimensões de entidade de relatório:
Exemplos de canal
-
Estatísticas básicas
- 10 mais – Vídeos mais assistidos para um canal
- 10 mais – Taxas de cliques de anotação para os vídeos mais visualizados de um canal
- Estatísticas para uma playlist específica
- 10 mais – Playlists mais assistidas de um canal
-
Área geográfica
- 10 mais – Vídeos mais visualizados em um país específico
- 10 mais – Vídeos mais visualizados na Europa
-
Estatísticas básicas
Exemplos de proprietário do conteúdo
-
Estatísticas básicas
- 10 principais - Vídeos mais visualizados para um proprietário do conteúdo
- 10 mais - Vídeos mais assistidos para um proprietário do conteúdo
- 10 principais - Os vídeos mais visualizados no canal de um proprietário do conteúdo
- 10 mais – Taxas de cliques de anotação para os vídeos mais visualizados de um canal
- 10 mais – Playlists mais assistidas por um proprietário do conteúdo
-
Área geográfica
- 10 mais: os vídeos mais assistidos na Europa para um proprietário de conteúdo
- 10 principais – Playlists mais ouvidas nos Estados Unidos
-
Estatísticas básicas
Áreas geográficas
Essas dimensões identificam uma região geográfica associada à atividade do usuário, ao desempenho do anúncio ou às métricas de receita estimada.
- country (dimensão principal)
- O país associado às métricas na linha do relatório. O valor da dimensão é um código de país ISO-3166-1 de duas letras, como
US
,CN
(China) ouFR
(França). O código de paísZZ
é usado para relatar métricas para as quais o YouTube não conseguiu identificar o país associado. This is a core dimension and is subject to the Deprecation Policy. - province
- O estado ou território dos EUA associado às métricas na linha do relatório. O valor da dimensão é um código ISO 3166-2 que identifica um estado dos EUA ou o Distrito de Colúmbia, como
US-MI
(Michigan) ouUS-TX
(Texas). O código de provínciaUS-ZZ
é usado para relatar métricas para as quais o YouTube não conseguiu identificar o estado associado dos EUA. Quando uma solicitação de API incluiprovince
no valor de parâmetrodimensions
, ela também precisa restringir os dados aos Estados Unidos incluindocountry==US
no valor de parâmetrofilters
.Observação:essa dimensão não é compatível com valores ISO 3166-2 que identificam áreas distantes dos EUA, já que esses territórios também têm os próprios códigos de país ISO 3166-1. Ele também não oferece suporte a subdivisões de outros países além dos Estados Unidos.
- city
- A cidade estimada associada às métricas na linha do relatório. Os dados dessa dimensão estão disponíveis para datas a partir de 1o de janeiro de 2022.
- continente (somente filtro)
-
Um código de região estatística das Nações Unidas (ONU). A API é compatível com os seguintes valores:
Valores 002
África 019
Américas (América do Norte, América Latina, América do Sul e Caribe) 142
Ásia 150
Europa 009
Oceania filters
comocontinent==REGION_CODE
, especificando um valor deREGION_CODE
na lista acima. - subContinent (somente filtro)
-
Um código de região estatística da ONU que identifica uma sub-região geográfica. A Divisão de Estatística das Nações Unidas lista sub-regiões e os países que associa a cada região.
Essa dimensão só pode ser usada para filtrar dados. Para usar essa dimensão, defina o valor do parâmetro
filters
comosubContinent==REGION_CODE
, especificando o valorREGION_CODE
na lista de ONU.
Exemplos
Os exemplos de solicitação a seguir usam dimensões ou filtros geográficos:
Exemplos de canal
- Estatísticas básicas: contagens de visualizações específicas do país (e outras) para um canal
-
Área geográfica
- Métricas de tempo de exibição específicas de um país para vídeos de um canal
- Métricas de anotação específicas de um país para vídeos de um canal
- Métricas específicas da província para os estados dos EUA e Washington D.C.
- Métricas de tempo de exibição específicas de um país para as playlists de um canal
- 10 principais – Playlists mais ouvidas nos Estados Unidos
- Local da reprodução: contagens de visualizações diárias e tempo de exibição de diferentes locais de reprodução.
- Origem do tráfego: contagens de visualizações e tempo de exibição de diferentes origens de tráfego em um país
- Informações demográficas: informações demográficas dos espectadores na Califórnia (idade e gênero)
-
Vídeos mais acessados
- 10 mais – Vídeos mais visualizados em um país específico
- 10 mais – Vídeos mais visualizados na Europa
Exemplos de proprietário do conteúdo
- Estatísticas básicas: contagens de visualizações específicas do país (e mais) para todos os vídeos enviados automaticamente
-
Área geográfica
- Métricas do tempo de exibição específicas de um país para o conteúdo enviado automaticamente
- Métricas de anotação específicas de um país para o conteúdo enviado automaticamente
- Métricas específicas da província para os estados dos EUA e Washington D.C.
- Métricas de tempo de exibição específicas de um país para as playlists de um proprietário de conteúdo
- 10 principais – Playlists mais ouvidas nos Estados Unidos
- Local da reprodução: contagens de visualizações diárias e tempo de exibição de diferentes locais de reprodução.
- Informações demográficas: informações demográficas dos espectadores na Califórnia (idade e gênero)
- Vídeos mais acessados: os 10 principais vídeos mais assistidos na Europa para um proprietário do conteúdo
- Receita/performance do anúncio: métricas de receita e performance de anúncios específicas do país
Períodos
Essas dimensões indicam que um relatório deve agregar dados com base em um período, como um dia, uma semana ou um mês. Os parâmetros de solicitação startDate
e endDate
especificam o período em que o relatório inclui dados. Na verdade, o relatório retorna dados até o último dia para o qual todas as métricas especificadas na solicitação estão disponíveis no momento em que a consulta é feita. Nos relatórios, as datas são listadas no formato YYYY-MM-DD
.
Importante: todas as datas se referem ao período que começa à 0h (horário do Pacífico) (UTC-7 ou UTC-8) e termina às 23h59 (horário do Pacífico) no dia, mês e ano especificados. Como resultado, as datas em que os relógios são ajustados para o horário de verão representam um período de 23 horas, e as datas em que os relógios são ajustados para trás representam um período de 25 horas.
A dimensão mês se refere ao período que começa à 0h, horário do Pacífico (UTC-7 ou UTC-8) no primeiro dia do mês e ano especificados.
- dia (dimensão principal)
- Quando você usa essa dimensão, os dados do relatório são agregados diariamente, e cada linha contém dados de um dia. Você pode usar outras dimensões para detalhar ainda mais os dados. Por exemplo, um relatório de origem do tráfego pode agregar estatísticas diárias de visualização com base na maneira como os usuários chegam aos seus vídeos. This is a core dimension and is subject to the Deprecation Policy.
- mês (dimensão principal)
- Os dados do relatório são agregados por mês. Assim como acontece com relatórios diários, é possível usar outros filtros para segmentar os dados ainda mais. No relatório, as datas são listadas no formato
YYYY-MM
.
Observação:se a consulta da API usar a dimensãomonth
, os parâmetrosstart-date
eend-date
precisarão ser definidos para o primeiro dia do mês. This is a core dimension and is subject to the Deprecation Policy.
Exemplos
Os exemplos de solicitação a seguir usam dimensões ou filtros temporais:
Exemplos de canal
-
Com base no tempo
- Métricas diárias de tempo de exibição para vídeos de um canal
- Métricas de anotação diárias para vídeos de um canal
- Visualizações diárias da playlist de um canal
- Local da reprodução: contagens de visualizações diárias e tempo de exibição de diferentes locais de reprodução.
- Origem do tráfego: contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego.
-
Dispositivo/SO
- Métricas diárias do tipo de dispositivo para o sistema operacional Android
- Métricas diárias do sistema operacional para dispositivos móveis
- Métricas diárias do sistema operacional e do tipo de dispositivo
-
Com base no tempo
Exemplos de proprietário do conteúdo
-
Com base no tempo
- Métricas diárias de tempo de exibição para conteúdo enviado automaticamente
- Métricas de anotação para o conteúdo reivindicado
- Visualizações diárias de playlists de um proprietário do conteúdo
- Local da reprodução: contagens de visualizações diárias e tempo de exibição de diferentes locais de reprodução.
- Origem do tráfego: contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego.
-
Dispositivo/SO
- Métricas diárias do tipo de dispositivo para vídeos reivindicados
- Métricas diárias do sistema operacional para vídeos reivindicados visualizados em dispositivos móveis
- Métricas diárias do sistema operacional e do tipo de dispositivo
- Receita/performance do anúncio: métricas de receita diária e performance de anúncios
-
Com base no tempo
Locais de reprodução
Essas dimensões fornecem insights sobre a página ou o aplicativo em que a atividade do usuário ocorreu.
- insightPlaybackLocationType
-
Os dados do relatório são agregados com base no tipo de página ou aplicativo em que as reproduções do vídeo ocorreram. Os valores possíveis para esta dimensão são:
-
BROWSE
– Os dados descrevem as visualizações que ocorreram na página inicial ou na tela inicial do YouTube, no feed de inscrições do usuário ou em outro recurso de navegação do YouTube. -
CHANNEL
– Os dados descrevem as visualizações que ocorreram em uma página do canal. -
EMBEDDED
– Os dados descrevem as visualizações que ocorreram em outro site ou aplicativo em que o vídeo foi incorporado usando<iframe>
ou<object>
. -
EXTERNAL_APP
– Os dados descrevem as visualizações que ocorreram em um aplicativo de terceiros em que o vídeo foi reproduzido usando um método diferente de uma incorporação<iframe>
ou<object>
. Por exemplo, as reproduções em aplicativos que usam a API do Player do YouTube para Android são categorizadas com esse valor. -
MOBILE
– Os dados descrevem as visualizações que ocorreram no site móvel do YouTube ou em clientes aprovados da API YouTube, incluindo dispositivos móveis.Desde 10 de setembro de 2013, as reproduções não são mais categorizadas como
MOBILE
nos relatórios do YouTube Analytics. O valor pode permanecer nos relatórios, já que os dados legados ainda se enquadram nessa categoria. No entanto, após essa data, as reproduções em dispositivos móveis serão classificadas comoWATCH
,EMBEDDED
ouEXTERNAL_APP
, dependendo do tipo de aplicativo em que elas ocorrem. -
SEARCH
– Os dados descrevem as visualizações que ocorreram diretamente na página de resultados da pesquisa do YouTube. -
WATCH
– Os dados descrevem as visualizações que ocorreram na página de exibição do YouTube do vídeo ou em um aplicativo oficial do YouTube, como o app YouTube para Android. -
YT_OTHER
– Os dados descrevem as visualizações não classificadas de outra forma.
-
- insightPlaybackLocationDetail
- Os dados são agregados com base na página em que o jogador está localizado. Esse relatório é suportado apenas por visualizações que ocorreram em players integrados e identifica os players integrados que geraram o maior número de visualizações de um vídeo especificado. Dessa forma, ele fornece uma visualização mais refinada do que o relatório de local de reprodução identificando os URLs ou os aplicativos associados aos principais players integrados.
Exemplos
Os seguintes exemplos de solicitação usam dimensões de local de reprodução:
Exemplos de canal
-
Local da reprodução
- Contagens de exibições e tempo de exibição de diferentes locais de reprodução
- Contagens diárias de visualizações e tempo de exibição de diferentes locais de reprodução
- 10 mais – Sites de terceiros que geram o maior número de visualizações para um vídeo incorporado
- Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
- Contagens diárias de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
-
Local da reprodução
Exemplos de proprietário do conteúdo
-
Local da reprodução
- Contagens de exibições e tempo de exibição de diferentes locais de reprodução
- Contagens diárias de visualizações e tempo de exibição de diferentes locais de reprodução
- 10 mais – Sites de terceiros que geram o maior número de visualizações para um vídeo incorporado
- Contagens de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
- Contagens diárias de visualizações de playlists e tempo de exibição de diferentes locais de reprodução
-
Local da reprodução
Detalhes da reprodução
- creatorContentType
- Essa dimensão identifica o tipo de conteúdo associado às métricas de atividade do usuário na linha de dados. Os dados dessa dimensão estão disponíveis para datas a partir de 1o de janeiro de 2019.
A tabela a seguir lista os valores de dimensão:
Valores LIVE_STREAM
O conteúdo assistido era uma transmissão ao vivo do YouTube. SHORTS
O conteúdo assistido era um Short do YouTube. STORY
O conteúdo assistido era uma Histórias do YouTube. VIDEO_ON_DEMAND
O conteúdo visualizado era um vídeo do YouTube que não se enquadra em um dos outros valores de dimensão. UNSPECIFIED
O tipo de conteúdo visualizado é desconhecido. - liveOrOnDemand
- Esta dimensão indica se as métricas de atividade do usuário na linha de dados estão associadas a visualizações de uma transmissão ao vivo. Os dados dessa dimensão estão disponíveis para datas a partir de 1o de abril de 2014.
A tabela a seguir lista os valores de dimensão:
Valores LIVE
Os dados da linha descrevem a atividade do usuário que ocorreu durante uma transmissão ao vivo. ON_DEMAND
Os dados da linha descrevem a atividade do usuário que não ocorreu durante uma transmissão ao vivo. - subscribedStatus
- Esta dimensão indica se as métricas de atividade do usuário na linha de dados estão associadas a espectadores inscritos no canal do vídeo ou da playlist.
Os valores possíveis são
SUBSCRIBED
eUNSUBSCRIBED
.
O valor da dimensão é preciso para o momento em que a atividade do usuário ocorre. Por exemplo, suponha que um usuário não tenha se inscrito em um canal e assistido a um dos vídeos desse canal, depois se inscreva no canal e assista a outro vídeo, tudo no mesmo dia. O relatório do canal indica que uma visualização tem o valorsubscribedStatus
deSUBSCRIBED
, e a outra tem o valorUNSUBSCRIBED
desubscribedStatus
. - youtubeProduct
- Essa dimensão identifica o serviço do YouTube em que a atividade do usuário ocorreu. Os dados dessa dimensão estão disponíveis desde 18 de julho de 2015.
A tabela a seguir lista os valores de dimensão:
Valores CORE
A atividade de usuários que não ocorreu em um dos aplicativos especializados do YouTube (YouTube Gaming, YouTube Kids ou YouTube Music). Exceção: as atividades dos usuários que ocorreram no YouTube Music antes de 1o de março de 2021 estão incluídas no CORE
.GAMING
A atividade do usuário ocorreu no YouTube Gaming. KIDS
A atividade do usuário ocorreu no YouTube Kids. MUSIC
A atividade do usuário ocorreu no YouTube Music a partir de 1o de março de 2021. Os dados anteriores a essa data estão incluídos em CORE
. Os dados em tempo real não são registrados.UNKNOWN
A atividade do usuário ocorreu antes de 18 de julho de 2015.
origens de tráfego
- insightTrafficSourceType
- Os dados do relatório são agregados com base no tipo de referenciador, que descreve como os usuários chegaram ao vídeo. Os valores possíveis para essa dimensão são:
ADVERTISING
– O espectador foi direcionado ao vídeo por um anúncio. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
vai identificar o tipo de publicidade.ANNOTATION
– Os espectadores chegaram ao vídeo clicando em uma anotação em outro vídeo.CAMPAIGN_CARD
– Visualizações originadas de vídeos reivindicados enviados por usuários que o proprietário do conteúdo usou para promover o conteúdo visualizado. Esta origem de tráfego só é suportada pelos relatórios do proprietário do conteúdo.END_SCREEN
– As visualizações foram direcionadas da tela final de outro vídeo.EXT_URL
– As exibições de vídeo foram direcionadas de um link em outro site. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
vai identificar a página da Web. Essa origem de tráfego inclui referências dos resultados da pesquisa do Google.HASHTAGS
: visualizações originadas de páginas de hashtag de VOD ou de hashtag dos Shorts.LIVE_REDIRECT
: as exibições de vídeo foram direcionadas usando o recurso Redirecionar em tempo real.NO_LINK_EMBEDDED
– O vídeo foi incorporado em outro site quando foi visualizado.NO_LINK_OTHER
: o YouTube não identificou um referenciador para o tráfego. Esta categoria engloba o tráfego direto a um vídeo, o tráfego de aplicativos móveis.NOTIFICATION
– As exibições de vídeo foram direcionadas de um e-mail ou notificação do YouTube.PLAYLIST
– As exibições de vídeo ocorreram enquanto o vídeo estava sendo reproduzido como parte de uma playlist. Ele inclui o tráfego proveniente da página da playlist.PRODUCT_PAGE
: as exibições de vídeo foram direcionadas de uma página de produto.PROMOTED
– As exibições de vídeo foram direcionadas de uma promoção não paga do YouTube, como a página "Vídeos do momento".RELATED_VIDEO
– As exibições de vídeo foram direcionadas de uma lista de vídeos relacionados em outra página de exibição de vídeo. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
especificará o ID desse vídeo.SHORTS
– O espectador foi direcionado ao deslizar verticalmente do vídeo anterior na experiência de visualização dos Shorts.SOUND_PAGE
: visualizações originadas das páginas temáticas dos Shorts.SUBSCRIBER
– As exibições de vídeo foram direcionadas de feeds da página inicial do YouTube ou de recursos de inscrição do YouTube. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
vai especificar os itens do feed da página inicial ou outra página que gerou as visualizações.YT_CHANNEL
– As exibições de vídeo ocorreram em uma página do canal. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
vai especificar o ID do canal.YT_OTHER_PAGE
– As exibições de vídeo foram direcionadas de um link diferente de um resultado de pesquisa ou de um link de vídeo relacionado que apareceu em uma página do YouTube. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
vai identificar a página.YT_SEARCH
– As exibições de vídeo foram direcionadas a partir dos resultados da pesquisa do YouTube. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
vai especificar o termo de pesquisa.VIDEO_REMIXES
– As visualizações foram direcionadas pelo link do vídeo remixado no player dos Shorts. Se você filtrar com base nesta origem de tráfego, o campoinsightTrafficSourceDetail
especificará o vídeo de origem do espectador.
- insightTrafficSourceDetail
- Os dados do relatório são agregados com base nos referenciadores que geraram o maior número de visualizações para um vídeo e um tipo de origem de tráfego especificados. A lista a seguir identifica as origens de tráfego para as quais esse relatório está disponível. Para cada origem de tráfego, a lista identifica as informações fornecidas pela dimensão
insightTrafficSourceDetail
.ADVERTISING
– O tipo de anúncio que levou às visualizações. Os valores possíveis são:- Anúncio de engajamento reproduzido com um clique
- Anúncio de engajamento
- Anúncios da rede de pesquisa do Google
- Anúncio em vídeo na página inicial
- In-stream pulável reservado
- TrueView na pesquisa e em Display
- TrueView in-stream
- Publicidade no YouTube sem classificação
- Mural de vídeos
CAMPAIGN_CARD
– O vídeo reivindicado que levou os espectadores ao vídeo identificado no relatório.END_SCREEN
– O vídeo que direcionou os espectadores ao vídeo identificado no relatório.EXT_URL
– O site que direcionou os espectadores ao vídeo.HASHTAGS
: a hashtag que levou às visualizações.NOTIFICATION
: o e-mail ou a notificação que deu origem ao tráfego.RELATED_VIDEO
– O vídeo relacionado que levou os espectadores ao vídeo abordado no relatório.SOUND_PAGE
– O vídeo que levou às visualizações.SUBSCRIBER
– O item de feed da página inicial ou o recurso de inscrição do YouTube que levou os espectadores ao vídeo abordado no relatório. Os valores válidos são:activity
– Visualizações de itens nos feeds de inscrição da página inicial que resultaram de atividades não sociais e de não envio do canal, incluindo marcações "gostei", favoritos, postagens de boletins e adições à playlist.blogged
– Visualizações de itens nos feeds de inscrição da página inicial provenientes de links dos principais blogs.mychannel
– Visualizações de itens em outros feeds listados na página inicial, como "Gostei", "Histórico de exibição" e "Assistir mais tarde".podcasts
: visualizações originadas de itens na página de destino do Podcasts.sdig
– Visualizações provenientes de e-mails de atualização de inscrição.uploaded
– Visualizações deuploaded
itens nos feeds de inscrição da página inicial./
– Outras visualizações originadas da página inicial do YouTube./my_subscriptions
– Visualizações originadas das páginas Minhas inscrições de usuários no YouTube.
YT_CHANNEL
– A página do canal em que os espectadores assistiram ao vídeo.YT_OTHER_PAGE
– A página do YouTube a partir da qual os espectadores foram direcionados ao vídeo.YT_SEARCH
– O termo de pesquisa que direcionou os espectadores ao vídeo.VIDEO_REMIXES
– O vídeo que levou às visualizações.
Exemplos
Os seguintes exemplos de solicitação usam dimensões de origem de tráfego:
Exemplos de canal
-
Origem do tráfego
- Contagens de exibições e tempo de exibição de diferentes origens de tráfego em um país
- Contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego
- 10 mais – Termos de pesquisa do YouTube que geram mais tráfego para um vídeo
- 10 mais – Termos de pesquisa do Google que geram mais tráfego para um vídeo
- Contagens de visualizações de playlists e tempo de exibição de diferentes origens de tráfego em um país
- Contagens diárias de visualizações de playlists e tempo de exibição de diferentes origens de tráfego
-
Origem do tráfego
Exemplos de proprietário do conteúdo
-
Origem do tráfego
- Contagens de exibições e tempo de exibição de diferentes origens de tráfego
- Contagens de visualizações diárias e tempo de exibição de diferentes origens de tráfego
- 10 mais – Termos de pesquisa do YouTube que geram mais tráfego para um vídeo
- 10 mais – Termos de pesquisa do Google que geram mais tráfego para um vídeo
- Contagens de visualizações de playlists e tempo de exibição de diferentes origens de tráfego em um país
- Contagens diárias de visualizações de playlists e tempo de exibição de diferentes origens de tráfego
-
Origem do tráfego
Dispositivos
- deviceType
- Essa dimensão identifica o formato físico do dispositivo em que a visualização ocorreu.
A lista a seguir identifica os tipos de dispositivos para os quais a API retorna dados. Também é possível usar a dimensão
deviceType
como filtro para restringir um relatório de sistema operacional para conter apenas dados de um tipo específico de dispositivo.DESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- operatingSystem
- Essa dimensão identifica o sistema de software do dispositivo em que a visualização ocorreu.
A lista abaixo identifica os sistemas operacionais para os quais a API retorna dados. Também é possível usar
operatingSystem
como filtro para restringir um relatório de tipo de dispositivo para conter apenas dados de um sistema operacional específico.ANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
Exemplos
Os seguintes exemplos de solicitação usam dimensões do dispositivo:
Exemplos de canal
-
Dispositivo/SO
- Métricas diárias do tipo de dispositivo para o sistema operacional Android
- Métricas diárias do sistema operacional para dispositivos móveis
- Métricas diárias do sistema operacional e do tipo de dispositivo
- Métricas diárias do tipo de dispositivo para visualizações de playlists no sistema operacional Android
- Métricas diárias do sistema operacional para visualizações de playlists em dispositivos móveis
-
Dispositivo/SO
Exemplos de proprietário do conteúdo
-
Dispositivo/SO
- Métricas diárias do tipo de dispositivo para vídeos reivindicados
- Métricas diárias do sistema operacional para vídeos reivindicados visualizados em dispositivos móveis
- Métricas diárias do sistema operacional e do tipo de dispositivo
- Métricas diárias do tipo de dispositivo para visualizações de playlists no sistema operacional Android
- Métricas diárias do sistema operacional para visualizações de playlists em dispositivos móveis
-
Dispositivo/SO
Informações demográficas
As dimensões demográficas ajudam você a entender a faixa etária e a distribuição por gênero do seu público-alvo. A Central de Ajuda do YouTube contém informações adicionais sobre os dados demográficos em relatórios do YouTube Analytics.
- ageGroup (dimensão principal)
- Esta dimensão identifica a idade dos usuários conectados associados aos dados do relatório. A API usa as seguintes faixas etárias:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- gender (dimensão principal)
- Essa dimensão identifica o gênero dos usuários conectados associados aos dados do relatório.
Os valores válidos são
female
,male
euser_specified
. This is a core dimension and is subject to the Deprecation Policy.
Exemplos
Os seguintes exemplos de solicitação usam dimensões demográficas:
Exemplos de canal
-
Informações demográficas
- Informações demográficas dos espectadores na Califórnia (idade e gênero)
- Informações demográficas dos espectadores da playlist na Califórnia (idade e gênero)
-
Informações demográficas
Exemplos de proprietário do conteúdo
-
Informações demográficas
- Informações demográficas dos espectadores na Califórnia (idade e gênero)
- Informações demográficas dos espectadores da playlist na Califórnia (idade e gênero)
-
Informações demográficas
Engajamento e compartilhamento de conteúdo
- sharingService (dimensão principal)
- Esta dimensão identifica o serviço usado para compartilhar vídeos. Os vídeos podem ser compartilhados no YouTube (ou pelo player do YouTube), utilizando o botão "Compartilhar". This is a core dimension and is subject to the Deprecation Policy.
A tabela a seguir mostra os valores de dimensão válidos:
Serviço de compartilhamento Valor da API Ameba AMEBA
E-mail do Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Mensagens do Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
Copiar para a área de transferência COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
Embed EMBED
E-mail MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Páginas do Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Enviar SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
Mensagem de texto da HTC HTC_MMS
Caixa de entrada do Google INBOX
Caixa de diálogo de atividade do sistema iOS IOS_SYSTEM_ACTIVITY_DIALOG
História do KAKAO KAKAO_STORY
Kakao (Conversa sobre Kakao) KAKAO
Kik KIK
E-mail da LGE LGE_EMAIL
Linha LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Mensagens da Motorola MOTOROLA_MESSAGING
MySpace MYSPACE
Naver NAVER
Compartilhar por proximidade NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Овоклассники) ODNOKLASSNIKI
Outros OTHER
Pinterest PINTEREST
Rakuten (楽天場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Conversas da Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Mensagem de texto TEXT_MESSAGE
Ter TUENTI
tumblr. TUMBLR
Twitter TWITTER
Desconhecido UNKNOWN
Mensagens da Verizon VERIZON_MMS
Viber VIBER
VKontakte (boxКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Campanha do Yahoo! Japão YAHOO
Games no YouTube YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
Consulte os documentos de ajuda para mais informações.
Exemplos
Os seguintes exemplos de solicitação usam dimensões sociais:
Exemplos de canal
- Redes sociais: compartilhamento de métricas, agregadas por serviço onde os vídeos foram compartilhados
Exemplos de proprietário do conteúdo
- Redes sociais: compartilhamento de métricas, agregadas por serviço onde os vídeos foram compartilhados
Retenção de público
- elapsedVideoTimeRatio
- Essa dimensão especifica a proporção entre a parte decorrido do vídeo e a duração do vídeo. As dimensões e métricas de retenção são usadas para medir a retenção de público ao longo do tempo, e a dimensão
elapsedVideoTimeRatio
é a medição de tempo. Por exemplo, um valor de0.4
indica que os dados do relatório correspondente mostram os dados de retenção após 40% do vídeo.
A API retorna 100 pontos de dados para cada vídeo com valores de proporção de0.01
a1.0
. Os tempos em que os dados são medidos durante as reproduções de vídeo são espaçados igualmente para cada vídeo. Isso significa que, em um vídeo de dois minutos, o intervalo entre os pontos de dados é de 1,2 segundo. No entanto, para um vídeo de duas horas, o intervalo entre os pontos de dados é de 72 segundos. O valor da dimensão indica o fim exclusivo do intervalo. - audienceType (somente filtro)
- O valor da dimensão identifica o tipo de tráfego associado aos dados do relatório.
Os valores aceitos são
ORGANIC
,AD_INSTREAM
eAD_INDISPLAY
. Consulte a Central de Ajuda do YouTube para explicações sobre esses tipos de origem de tráfego.
Os dados do filtroaudienceType
estão disponíveis desde 25 de setembro de 2013. A API não retorna 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.
Exemplos
Os seguintes exemplos de solicitação usam dimensões de retenção de público:
Exemplos de canal
- Retenção de público: métricas de retenção de público para um vídeo
Exemplos de proprietário do conteúdo
- Retenção de público: métricas de retenção de público para um vídeo
Performance do anúncio
- adType
- A dimensão
adType
é usada nos relatórios de performance de anúncios e agrega as métricas solicitadas com base nos tipos de anúncios mostrados durante as reproduções de vídeo. A lista a seguir explica os possíveis valores de dimensão. Acesse a Central de Ajuda do YouTube para mais informações sobre os formatos de publicidade do YouTube.
-
auctionBumperInstream
– Anúncios em vídeo não puláveis, veiculados em leilão de até seis segundos. O espectador precisa assistir esse anúncio para que o vídeo seja exibido. -
auctionDisplay
: um anúncio gráfico ou rich media que aparece como sobreposição na parte inferior do player de vídeo, como um bloco de anúncios de 300 x 250 na página de exibição do vídeo ou como uma combinação de ambos. Quando a sobreposição é executada, ela é automaticamente fechada após a exibição por determinado período. O usuário também pode fechá-la. Se uma sobreposição e um banner forem exibidos juntos, cada anúncio é contado como uma impressão separada. -
auctionInstream
: anúncios em vídeo não puláveis exibidos antes, durante ou depois do vídeo principal. -
auctionTrueviewInslate
: o espectador escolhe um dos vários anúncios em vídeo entre uma seleção de opções exibidas antes de um vídeo. See the TrueView documentation for more information. -
auctionTrueviewInstream
: anúncios em vídeo puláveis exibidos antes ou durante o vídeo principal. Consulte a documentação do TrueView para mais informações. -
auctionUnknown
: um anúncio que foi comprado no leilão do Google AdWords, mas que não foi classificado como um dos outros tipos de anúncio. -
reservedBumperInstream
– Anúncios em vídeo não puláveis, vendidos de forma reservada, de até seis segundos. O espectador precisa assistir essa publicidade completamente para que o vídeo seja exibido. -
reservedClickToPlay
– Um anúncio em vídeo em que o usuário precisa clicar para iniciar a reprodução. Uma impressão de anúncio é registrada em qualquer momento em que o bloco de anúncio click-to-play for exibido, independentemente de o usuário iniciar a reprodução. Eles são vendidos de forma reservada. -
reservedDisplay
: um anúncio gráfico ou rich media que aparece como sobreposição na parte inferior do player de vídeo, como um bloco de anúncios de 300 x 250 na página de exibição do vídeo ou como uma combinação de ambos. Quando a sobreposição é executada, ela é automaticamente fechada após a exibição por determinado período. O usuário também pode fechá-la. Se uma sobreposição e um banner forem exibidos juntos, cada anúncio é contado como uma impressão separada. -
reservedInstream
– Anúncios em vídeo não puláveis inseridos antes, durante ou depois do vídeo principal. -
reservedInstreamSelect
-
reservedMasthead
: um anúncio grande exibido na página inicial que pode incluir elementos gráficos e de vídeo. -
reservedUnknown
: um anúncio que foi vendido de forma reservada e não pode ser classificado como um dos outros tipos de anúncio. -
unknown
: não foi possível classificar este tipo de anúncio.
-
Exemplos
Os exemplos de relatório a seguir recuperam métricas de desempenho de anúncios ou receita:
Exemplos de canal
-
Receita/anúncios
- Métricas de receita do canal e performance de anúncios
- Métricas de receita diária e performance de anúncios
- Métricas de receita e performance de anúncios específicas do país
- 10 mais – Vídeos com a maior receita
- Métricas de desempenho de anúncios para diferentes tipos de anúncios
-
Receita/anúncios
Exemplos de proprietário do conteúdo
-
Receita/anúncios
- Métricas de receita e desempenho de anúncios para conteúdo reivindicado
- Métricas de receita diária e performance de anúncios
- Métricas de receita e performance de anúncios específicas do país
- 10 mais – Vídeos com a maior receita
- Métricas de desempenho de anúncios para diferentes tipos de anúncios
-
Receita/anúncios
Playlists
- isCurated (somente filtro)
- Esse filtro indica que a solicitação está recuperando dados sobre exibições de vídeos que ocorreram no contexto de uma playlist.
Exemplos
Todos os exemplos de solicitações que recuperam relatórios de playlists usam o filtro isCurated
.
Dimensões do proprietário do conteúdo
As dimensões a seguir são suportadas somente para relatórios do proprietário do conteúdo.
- reivindicadoStatus (usado apenas em relatórios do proprietário do conteúdo)
- Essa dimensão permite indicar que uma resposta da API precisa conter apenas métricas para o conteúdo reivindicado. O único valor válido para essa dimensão é
claimed
. Se o parâmetrofilters
restringir a consulta aclaimedStatus==claimed
, a API vai recuperar apenas os dados do conteúdo reivindicado. A tabela na definição da dimensãouploaderType
fornece mais detalhes sobre como usar essa dimensão.
- SubmitType (dimensão principal) (usado somente em relatórios do proprietário do conteúdo)
- Essa dimensão permite indicar se uma resposta da API precisa conter métricas para o conteúdo enviado pelo proprietário do conteúdo especificado e/ou por terceiros, como vídeos enviados por usuários. Os valores válidos são
self
ethirdParty
. Essa é uma dimensão principal e está sujeita à política de descontinuação.
A tabela abaixo mostra as combinações aceitas para as dimensõesclaimedStatus
euploaderType
, que são usadas no parâmetrofilters
:
Valor claimedStatus
Valor uploaderType
Descrição [Não definido] self Recupera dados do YouTube Analytics para o conteúdo reivindicado e não reivindicado enviado pelo proprietário do conteúdo. reivindicados [Não definido] Recupera dados para o conteúdo reivindicado enviado pelo proprietário do conteúdo ou por um terceiro. reivindicados self Recupera dados para o conteúdo reivindicado enviado pelo proprietário do conteúdo. reivindicados thirdParty Recupera dados para o conteúdo reivindicado enviado por um terceiro.
Exemplos
Muitos dos exemplos de solicitações de API para relatórios do proprietário do conteúdo usam uma combinação compatível das dimensões claimedStatus
e uploaderType
para filtrar dados.