Neste documento, definimos as dimensões compatíveis com a API YouTube Reporting. Esta API recupera relatórios em massa que contêm dados do YouTube Analytics para um proprietário de conteúdo ou canal.
As dimensões são critérios comuns usados para agregar dados, como a data em que ocorreu a atividade do usuário ou o país em que eles estavam localizados.
Cada relatório em massa é compatível com uma lista predefinida de dimensões e, em qualquer relatório, cada linha de dados tem uma combinação exclusiva de valores de dimensão. Assim, a combinação de valores de dimensão de cada linha funciona como a chave primária para a linha. Não é preciso especificar ou ter a opção de especificar quais dimensões serão incluídas no relatório.
Dimensões principais
Embora a API YouTube Reporting esteja sujeita à política de descontinuação definida nos Termos de Serviço, as dimensões não essenciais (e métricas não essenciais) não estão sujeitas à política. Nas definições desta página, todas as dimensões que são principais são explicitamente identificadas como tal.
A lista a seguir identifica as dimensões principais da API. Todas elas também são dimensões principais na API YouTube Analytics.
Consulte a lista de APIs do YouTube sujeitas à política de descontinuação para mais informações.
Dimensões
As seções a seguir definem as dimensões usadas nos relatórios em massa da API YouTube Reporting. Salvo indicação em contrário, essas dimensões são usadas nos relatórios de canal e de proprietário do conteúdo.
Recursos
Estas dimensões correspondem aos recursos que os canais e os proprietários de conteúdo gerenciam no YouTube:
- video_id (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_id
- O ID de uma playlist do YouTube. Na API YouTube Data, esse é o valor da propriedade
id
de um recursoplaylist
. - channel_id (dimensão principal)
- 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. - asset_id (usado apenas nos relatórios do proprietário do conteúdo)
- O ID de um recurso gerenciado no sistema Content ID do YouTube. Um recurso é a representação da sua propriedade intelectual no sistema. No site do YouTube, você pode localizar os IDs dos recursos no Gerenciador de conteúdo do YouTube. Você também pode recuperá-los usando a API Content ID do YouTube.
Á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_code (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_code
- 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.Observação:esta dimensão não é compatível com valores ISO 3166-2 que identificam regiões nos 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 aceita subdivisões de outros países além dos Estados Unidos.
Períodos
- data (dimensão principal)
- Essa dimensão identifica a data associada às métricas em cada linha do relatório. Nos relatórios em massa, a data se refere ao período que começa à 0h (horário do Pacífico) e termina às 23h59 (horário do Pacífico) do dia, mês e ano especificados. Dependendo da época do ano, o horário do Pacífico é UTC-7 ou UTC-8.
Embora as datas geralmente representem um período de 24 horas, 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. This is a core dimension and is subject to the Deprecation Policy.
Locais de reprodução
Essas dimensões fornecem insights sobre a página ou o aplicativo em que a atividade do usuário ocorreu.
- playback_location_type
-
Essa dimensão identifica o tipo de página ou aplicativo em que a atividade do usuário ocorreu. A tabela a seguir mostra os valores de dimensão:
Valores 0
Os dados referem-se a atividades que ocorreram na página de exibição do vídeo no YouTube ou em um aplicativo oficial do YouTube, como o aplicativo do YouTube para Android. 1
Os dados são relacionados a atividades que ocorreram em outro site ou aplicativo em que o vídeo foi incorporado usando <iframe>
ou<object>
.2
Os dados são referentes a atividades que ocorreram em uma página do canal do YouTube. 5
Os dados são referentes a métricas que não podem ser classificadas em um dos outros tipos de local listados acima. 7
Os dados referem-se a visualizações que ocorreram na página inicial ou tela inicial do YouTube, no feed de inscrições do usuário ou em outro recurso de navegação do YouTube. 8
Os dados referem-se a visualizações que ocorreram diretamente na página de resultados de pesquisa do YouTube. 10
Os dados são referentes a visualizações que ocorreram no Feed do YouTube Shorts. - playback_location_detail
- Essa dimensão especifica o URL ou aplicativo em que a reprodução ocorreu. Essa dimensão só é compatível com visualizações que ocorreram em players incorporados. Isso significa que o valor da dimensão só é preenchido nas linhas em que o valor é
1
. Em outras linhas, o valor dessa dimensão fica vazio.
Detalhes da reprodução
- live_or_on_demand
- Essa dimensão indica se as métricas de atividade do usuário na linha de dados estão associadas às visualizações de uma transmissão ao vivo. Os dados dessa dimensão estão disponíveis para as 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. onDemand
Os dados da linha descrevem a atividade do usuário que não ocorreu durante uma transmissão ao vivo. - subscribed_status
- Esta dimensão indica se as métricas de atividade do usuário na linha de dados estão associadas aos espectadores inscritos no canal do vídeo ou da playlist.
Os valores possíveis são
subscribed
eunsubscribed
.
O valor da dimensão é preciso no 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 valorsubscribed_status
desubscribed
e a outra tem o valorunsubscribed
desubscribed_status
.
Origens de tráfego
- traffic_source_type
- Essa dimensão identifica o tipo de referenciador associado às métricas de atividade do usuário. O tipo de referenciador descreve a maneira como os usuários acessaram o vídeo ou canal associado à linha de dados no relatório. A tabela a seguir mostra os valores de dimensão:
Valores 0
Direto ou desconhecido
Esse valor abrange o tráfego direto para uma página, bem como páginas que têm o referenciador desconhecido. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoNO_LINK_OTHER
ouUNKNOWN_MOBILE_OR_DIRECT
.1
Publicidade no YouTube
O espectador foi direcionado ao vídeo por uma publicidade. Em um relatório de origem de tráfego, se o valor dessa dimensão for1
, a dimensão traffic_source_detail identificará o tipo de anúncio mostrado ao usuário. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoADVERTISING
. Os valores possíveis são:Valores ctp_engagement_ad
Anúncio de engajamento clique para ver engagement_ad
Anúncio de engajamento googlemediaads
Anúncios da rede de pesquisa do Google insearch_display
TrueView na pesquisa e em Display instream
TrueView in-stream instream-select
In-stream pulável reservado unknown
Publicidade no YouTube sem classificação video_wall
Mural de vídeos yva
Anúncio em vídeo na página inicial 3
Recursos de navegação
O espectador foi direcionado de uma página do YouTube que leva a vídeos ou canais. Em um relatório de origem de tráfego, se o valor dessa dimensão for3
, a dimensão traffic_source_detail identificará o recurso que deu origem ao tráfego. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoSUBSCRIBER
. Os valores possíveis são:Valores explore
Crianças: conhecer learning
YouTube Kids: aprendizado music
Feed de música my-history
Histórico de exibição my-subscriptions
Minhas assinaturas my-uploads
Meus uploads podcasts
Página de destino de podcasts shows
Infantil: programas watch-later
Assistir mais tarde what-to-watch
O que assistir 4
Canais do YouTube
Os espectadores foram direcionados de uma página do canal do YouTube. Em um relatório de origem de tráfego, se o valor dessa dimensão for4
, a dimensão traffic_source_detail especificará o ID do canal. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoYT_CHANNEL
.5
Pesquisa do YouTube
Os espectadores foram direcionados pelos resultados da pesquisa do YouTube. Em um relatório de origem de tráfego, se o valor dessa dimensão for5
, a dimensão traffic_source_detail especificará o termo de pesquisa associado. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoYT_SEARCH
.7
Vídeos sugeridos
Os espectadores foram direcionados de uma página de detalhes de vídeos relacionados em outra página de exibição de vídeo. Em um relatório de origem de tráfego, se o valor dessa dimensão for7
, a dimensão traffic_source_detail identificará o ID do vídeo em questão. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoRELATED_VIDEO
ouYT_RELATED
.8
Outros recursos do YouTube
Os espectadores foram direcionados de uma página do YouTube que não se enquadra em um dos outros tipos de origem de tráfego listados. Em um relatório de origem de tráfego, se o valor dessa dimensão for8
, a dimensão traffic_source_detail identificará o URL da página. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoYT_OTHER_PAGE
. Os valores possíveis são:Valores g-crec
Canais recomendados offline
Off-line promotion
Promoção de parceiros unknown
Desconhecido widget
Widget da tela inicial do Android youtu.be
youtu.be ytremote
YouTube Remoto 9
Externo
Os espectadores foram direcionados de um link em outro site. Esta origem de tráfego inclui referências dos resultados da Pesquisa Google. Em um relatório de origem de tráfego, se o valor dessa dimensão for9
, a dimensão traffic_source_detail identificará a página da Web externa. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoEXT_URL
.11
Anotações e cards de vídeo
Os espectadores eram direcionados clicando em uma anotação ou card em outro vídeo. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoANNOTATION
.14
Playlists
As visualizações ocorreram enquanto o vídeo estava sendo reproduzido como parte de uma playlist. Nos relatórios de consulta, esse tipo de origem de tráfego é identificado comoPLAYLIST
.
Essa origem de tráfego é diferente do tipo de origem18
, o que indica que as visualizações são provenientes da página que lista todos os vídeos da playlist.17
Notificações
Os espectadores foram direcionados por e-mail ou notificação do YouTube. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoNOTIFICATION
. Os valores possíveis são:Valores inbox
push
sdig
Visualizações originadas de notificações que faziam parte do resumo por e-mail dos inscritos uploaded_other
Visualizações originadas de notificações não push, como notificações por e-mail ou caixa de entrada, enviadas aos inscritos quando um vídeo foi enviado uploaded_push
Visualizações originadas de notificações push enviadas aos inscritos quando um vídeo foi enviado 18
Páginas de playlists
Visualizações originadas de uma página que lista todos os vídeos em uma playlist. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoYT_PLAYLIST_PAGE
.
Essa origem de tráfego é diferente do tipo de origem14
, o que indica que as visualizações ocorreram enquanto o vídeo estava sendo reproduzido como parte de uma playlist.19
Programação a partir de conteúdo reivindicado
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. Nos relatórios de consulta, essa origem de tráfego é identificada comoCAMPAIGN_CARD
. Esta origem de tráfego é compatível apenas com relatórios do proprietário do conteúdo.20
Tela final do vídeo interativo
Visualizações originadas da tela final de outro vídeo. Nos relatórios de consulta, esse tipo de origem do tráfego é identificado comoEND_SCREEN
.23
Histórias
O espectador foi direcionado ao deslizar verticalmente do vídeo anterior na experiência de visualização das Histórias.24
Shorts
O espectador foi direcionado ao deslizar verticalmente do vídeo anterior na experiência de visualização dos Shorts.25
Páginas de produtos
Vídeos em uma página de produto atraíram espectadores para outro canal.26
Páginas de hashtags
Visualizações originadas de páginas de hashtags de vídeos sob demanda ou de páginas dinâmicas de hashtags de Shorts.27
Páginas da música
Visualizações originadas das páginas dinâmicas de sons dos Shorts.28
Redirecionamento em tempo real
Visualizações originadas de Redirecionamentos em tempo real.30
Vídeo remixado
Visualizações originadas de um link de vídeo remixado no player dos Shorts.31
Feed vertical ao vivo
Visualizações originadas do feed vertical ao vivo.32
Vídeo relacionado
Visualizações originadas de um link de vídeo relacionado no player dos Shorts. - traffic_source_detail
- Essa dimensão oferece detalhes adicionais sobre a origem do tráfego que o valor da dimensão traffic_source_type da linha. Esse valor de dimensão é preenchido para os seguintes valores de dimensão traffic_source_type:
1
– O valor da dimensão identifica o tipo de anúncio mostrado ao espectador. Consulte a definição traffic_source_type para uma lista de valores possíveis.3
– O valor da dimensão identifica o recurso do YouTube que direcionou o tráfego direcionado. Consulte a definição traffic_source_type para uma lista de valores possíveis.4
– O valor da dimensão especifica o ID do canal de origem do espectador.5
: o valor da dimensão especifica o termo de pesquisa que levou ao tráfego direcionado.7
– O valor da dimensão identifica o vídeo a partir do qual o espectador foi direcionado.8
– O valor da dimensão identifica o tipo de página do YouTube que direcionou o tráfego direcionado. Consulte a definição traffic_source_type para uma lista de valores possíveis.9
– O valor da dimensão identifica a página externa de origem do tráfego.17
: o valor da dimensão identifica o tipo de notificação que levou ao tráfego direcionado. Consulte a definição traffic_source_type para uma lista de valores possíveis.19
– O valor da dimensão identifica o vídeo a partir do qual o espectador foi direcionado.20
– O valor da dimensão identifica o vídeo a partir do qual o espectador foi direcionado.25
: o valor da dimensão identifica o ID do produto, que é um ID do Mapa de informações do Google.26
: o valor da dimensão identifica a hashtag que levou ao tráfego direcionado.27
– O valor da dimensão identifica o vídeo a partir do qual o espectador foi direcionado.28
: o valor da dimensão especifica o ID do canal de onde o espectador foi direcionado por meio de Redirecionamentos em tempo real.30
– O valor da dimensão especifica o vídeo a que o espectador foi direcionado.
Dispositivo
- device_type
- Essa dimensão identifica o formato físico do dispositivo em que a visualização ocorreu.
A tabela a seguir mostra os valores de dimensão válidos:
Valores 100
Desconhecido 101
Computador 102
TV 103
Console de jogos 104
Dispositivo móvel 105
Tablet - operating_system
- Esta dimensão identifica o sistema de software do dispositivo em que a visualização ocorreu.
A tabela a seguir mostra os valores de dimensão válidos:
Valores 1
Outros 2
Windows 3
Windows Mobile 4
Android 5
iOS 6
Symbian 7
BlackBerry 9
Macintosh 10
PlayStation 11
Bada 12
WebOS 13
Linux 14
Hiptop 15
MeeGo 16
Wii 17
Xbox 18
PlayStation Vita 19
Smart TV 20
Nintendo 3DS 21
Chromecast 22
Tizen 23
Firefox 24
RealMedia 25
KaiOS 26
Roku 27
Nintendo Switch 28
Apple tvOS 29
Fire OS 30
ChromeOS 31
Vidaa
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.
- age_group (dimensão principal)
- Essa dimensão identifica a faixa etária dos usuários conectados associados aos dados do relatório. A API usa as seguintes faixas etárias:
AGE_13_17
AGE_18_24
AGE_25_34
AGE_35_44
AGE_45_54
AGE_55_64
AGE_65_
- gender (dimensão principal)
- Essa dimensão identifica o gênero dos usuários conectados que estão associados aos dados do relatório.
Os valores válidos são
FEMALE
,MALE
eGENDER_OTHER
. This is a core dimension and is subject to the Deprecation Policy.
Engajamento e compartilhamento de conteúdo
- sharing_service (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:
Valores 0
Desconhecido 1
Digg 4
reddit 5
StumbleUpon 6
mixi 7
A autenticação sem senha do Yahoo! Japão 8
goo 9
Ameba 10
Facebook 11
MySpace 12
NUjij 18
Terapia 20
Menéame 21
Wykop 22
De foguete 25
Fotka 28
hi5 31
Twitter 32
Cyworld 34
Blogger 36
VKontakte (Контакте) 37
Rakuten (楽天高場) 38
LiveJournal 39
Odnoklassniki (О confundirоклассники) 40
tumblr. 42
LinkedIn 43
Google+ 44
Weibo 45
Pinterest 46
E-mail 47
Facebook Messenger 49
WhatsApp 50
Hangouts 51
Gmail 52
Kakao (Conversa sobre kakao) 53
Outros 55
Copiar para a área de transferência 59
Embed 60
Mensagem de texto 61
Mensagens do Android 62
Mensagens da Verizon 63
Mensagem de texto HTC 64
Conversas da Sony 65
Enviar SMS 66
E-mail da LGE 67
Linhas 68
Viber 69
Kik 70
Skype 71
BlackBerry Messenger 72
WeChat 73
História do KAKAO 74
Dropbox 75
Telegram 76
Páginas do Facebook 77
GroupMe 78
E-mail do Android 79
Motorola Messaging 80
Compartilhar por proximidade 81
Naver 82
Caixa de diálogo da atividade do sistema iOS 83
Caixa de entrada do Google 84
Android Messenger 85
YouTube Music 86
Games no YouTube 87
YouTube Kids 88
YouTube TV
Consulte os documentos de ajuda para mais informações.
Anotações
- annotation_type
- Esta dimensão identifica a maneira como a anotação aparece durante o vídeo. A tabela a seguir lista os possíveis valores de dimensão:
Valores 0
Desconhecido 1
Observação 3
Destaque 4
Título 8
Balão de diálogo 9
Rótulo 10
Marca-d'água de branding 11
Vídeo em destaque 12
Playlist em destaque 30
o que fazer agora - annotation_id
- O ID que o YouTube usa para identificar de forma exclusiva uma anotação.
Cards
- card_type
- Essa dimensão identifica o tipo de card que foi exibido ao usuário. A tabela a seguir lista os possíveis valores de dimensão:
Valores 0
Desconhecido 60
Link 61
Arrecadação de fundos 62
Video 63
Playlists 65
Financiamento por fãs 66
Produtos 68
Site associado 69
Canal - card_id
- O ID que o YouTube usa para identificar exclusivamente um cartão.
Telas finais
- end_screen_element_type
- Essa dimensão identifica o tipo de elemento da tela final que foi exibido ao usuário. A tabela a seguir lista os tipos de elementos da tela final e os valores deles:
Valores 501
Vídeo - O elemento promove outro vídeo do YouTube. 502
Playlist: o elemento promove a playlist do YouTube. 503
Site: o elemento é vinculado ao site associado. 504
Canal: o elemento é vinculado a outro canal. 505
Inscrição: o elemento incentiva inscrições no canal. 506
Associado 507
Financiamento coletivo: o elemento direciona a um site de financiamento coletivo aprovado. 508
Produtos: o elemento direciona para um site aprovado de mercado. 509
Envio recente - O elemento é vinculado ao vídeo enviado mais recentemente no seu canal. 510
o melhor para o espectador - end_screen_element_id
- O ID que o YouTube usa para identificar de forma exclusiva um elemento da tela final.
Legendas
- subtitle_language
- Esta dimensão identifica o idioma das legendas usado por mais tempo durante a visualização. As exibições para as quais as legendas foram desativadas na maioria das vezes não são contadas. Consulte a documentação de relatórios de canal ou relatórios do proprietário do conteúdo para mais informações sobre os relatórios que contêm essa dimensão.
- subtitle_language_autotranslated
- Esta dimensão identifica o idioma de closed caption traduzido automaticamente usado por mais tempo durante a visualização. As exibições para as quais as legendas foram desativadas na maioria das vezes não são contadas. Consulte a documentação de relatórios de canal ou relatórios do proprietário do conteúdo para mais informações sobre os relatórios que contêm essa dimensão.
Performance do anúncio
- ad_type
- A dimensão
ad_type
é usada nos relatórios de performance de anúncios e agrega as métricas solicitadas com base nos tipos de anúncios veiculados durante as reproduções de vídeo. A tabela a seguir lista os possíveis valores de dimensão. Consulte a Central de Ajuda do YouTube para mais informações sobre os formatos de publicidade no YouTube.
Valor Descrição Valor em relatórios de consulta 1
Anúncios em vídeo puláveis (leilão) auctionTrueviewInstream
2
Anúncios de display (leilão) auctionDisplay
3
Anúncios em vídeo não puláveis (leilão) auctionInstream
5
Anúncios de display (reservados) reservedDisplay
6
Anúncios em vídeo não puláveis (reservado) reservedInstream
13
Desconhecido unknown
15
Anúncios em vídeo puláveis (reservados) reservedInstreamSelect
19
Anúncios bumper (leilão) auctionBumperInstream
20
Anúncios bumper (reservados) reservedBumperInstream
Observação:os relatórios de consulta podem retornar alguns tipos de anúncios adicionais que eram usados anteriormente no YouTube.
Dimensões do proprietário do conteúdo
As dimensões a seguir são usadas apenas nos relatórios do proprietário do conteúdo.
- claim_status (usado apenas em relatórios do proprietário do conteúdo)
- Esta dimensão indica que uma linha de dados contém somente métricas do conteúdo reivindicado. O único valor válido para esta dimensão é
claimed
. A tabela na definição da dimensãouploader_type
fornece mais detalhes sobre como usar essa dimensão.
- Submitr_type (dimensão principal) (usado somente em relatórios do proprietário do conteúdo)
- Esta dimensão indica se uma linha de dados contém métricas de 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õesclaimed_status
euploader_type
:
Valor claimed_status
Valor uploader_type
Descrição [Não definido] self A linha contém dados do YouTube Analytics para conteúdo reivindicado e não reivindicado enviado pelo proprietário. reivindicados self A linha contém dados do conteúdo reivindicado enviado pelo proprietário. reivindicados thirdParty A linha contém dados do conteúdo reivindicado enviado por um terceiro.