YouTube

Baseado nas documentacoes de API do YouTube (Analytics) e (Data)

Requisitos

• Caso sua conta seja do tipo Brand Account, e necessario que o usuario que ira autorizar o conector seja o Owner (dono) da conta
• Possuir um canal no YouTube associado a conta do Google que ira autorizar o conector

Instrucoes

1. Faca login na plataforma da Kondado, va para a pagina de adicionar conectores e selecione o conector do YouTube
2. Clique em "Sign in with Google"
3. Selecione a conta do Google que ira utilizar
4. Selecione o canal (conta do YouTube) que ira utilizar
5. Na proxima tela, marque TODAS as permissoes que sao requisitadas e clique em Continue
6. Voce sera redirecionado para a pagina da Kondado com o acesso ja autorizado. De um nome ao seu conector

Agora basta clicar em SALVAR e para comecar a receber dados do YouTube no Data Warehouse ou Data Lake

Os dados possuem um atraso de ate 3 dias para disponibilizacao via API

• Estatísticas diárias do canal
• Estatísticas diárias dos vídeos
• Itens de Playlists
• Playlists
• Visualizações diarias dos vídeos
• Visualizações diárias do canal

Dimensoes

insightPlaybackLocationType

Agrega os dados com base no tipo de aplicacao onde o video foi tocado. Os valores possiveis sao:

• YT_OTHER: outro tipo de reproducao, nao classificada anteriormente
• WATCH: reproducoes na propria pagina do video no YouTube ou em um aplicativo oficial do YouTube, como o app do Android
• SEARCH: reproducoes diretas na pagina de resultados da busca do YouTube
• MOBILE: site mobile do YouTube ou clientes que utilizam os clientes aprovados da YouTube API, incluindo dispositivos moveis. Desde 10/09/2013, reproducoes nao sao mais categorizadas como MOBILE
• EXTERNAL_APP: aplicacao terceira, utilizando um metodo que nao seja embed. Se encaixam aqui reproducoes em aplicativos que utilizam o YouTube Android Player API
• EMBEDDED: outro site, onde o video estava embedado
• CHANNEL: pagina do canal
• BROWSE: home page do YouTube ou tela inicial, no feed de subscricao do usuario ou em outro componente de navegacao do YouTube

insightTrafficSourceType

Agrega os dados com base na forma como os usuarios chegaram ao video (referrer). Valores possiveis sao:

• YT_SEARCH: visualizacoes a partir de resultados de busca do YouTube
• YT_PLAYLIST_PAGE: visualizacoes a partir da listagem de todos os videos de uma playlist. E diferente de PLAYLIST, que indica que o video foi reproduzido como parte de uma playlist
• YT_OTHER_PAGE: visualizacoes a partir de um link que nao sao os resultados de busca ou videos relacionados
• YT_CHANNEL: visualizacoes na pagina do canal
• SUBSCRIBER: o video foi encontrado via feed da homepage do YouTube ou funcionalidade de subscricao do YouTube
• SHORTS: a visualizacao ocorreu devido a um swipe vertical de um video anterior na experiencia de visualizacao em Shorts
• RELATED_VIDEO: as visualizacoes vieram de uma listagem de videos similares da pagina de outro video
• PROMOTED: as reproducoes vieram de promocao nao paga do YouTube, como a pagina do "Spotlight Videos"
• PLAYLIST: o video foi reproduzido como parte de uma playlist. E diferente de YT_PLAYLIST_PAGE, que indica que o video foi reproduzido enquanto listado na playlist
• NOTIFICATION: o video foi referenciado de um email ou notificacao do YouTube
• NO_LINK_OTHER: o YouTube nao identificou a origem. Inclui trafego direto e trafego em apps
• NO_LINK_EMBEDDED: o video estava embedado em outro site quando foi reproduzido
• EXT_URL: link em outro site (URL externa). Inclui referenciamentos de resultados de busca do Google
• END_SCREEN: tela final de outro video
• CAMPAIGN_CARD: card em outro video
• ANNOTATION: anotacao de outro video
• ADVERTISING: anuncio

deviceType

Agrega os resultados com base na forma fisica do dispositivo que as visualizacoes ocorreram. Os valores retornados podem ser os seguintes: DESKTOP, GAME_CONSOLE, MOBILE, TABLET, TV e UNKNOWN_PLATFORM

operatingSystem

Identifica o sistema de software do dispositivo onde a visualizacao ocorreu. Os valores possiveis sao: 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 e XBOX

subscribedStatus

Indica se a metrica esta relacionada a expectadores que estavam subscritos ao canal do video ou da playlist. Valores possiveis sao SUBSCRIBED e UNSUBSCRIBED. Perceba que esta dimensao e dada de acordo com o momento em que a atividade do usuario aconteceu. Por exemplo, um usuario nao subscrito assistiu um video e depois se subscreveu ao canal e assistiu a um outro video, no mesmo dia. Neste caso, uma das suas visualizacoes sera contabilizada como SUBSCRIBED e outra como UNSUBSCRIBED.

liveOrOnDemand

Indica se a atividade do usuario ocorreu durante uma transmissao ao vivo ou nao. Os dados estarao disponiveis para esta dimensao a partir de 2014-04-01. Valores possiveis sao: LIVE e ON_DEMAND

youtubeProduct

Identifica o servico do YouTube onde a atividade do usuario ocorreu. Dados estao disponiveis a partir de 2015-07-18. Valores possiveis sao:

• UNKNOWN: Atividade ocorreu antes de 2015-07-18
• MUSIC: Atividade que ocorreu no YouTube Music apos 2021-03-01. Dados anteriores a 2021-03-01 estao em CORE. Dados em real-time nao sao guardados
• KIDS: Atividade que ocorreu no YouTube Kids
• GAMING: Atividade que ocorreu no YouTube Gaming
• CORE: A atividade nao ocorreu em um dos apps especiais (YouTube Gaming, YouTube Kids, or YouTube Music). Excecao: Atividades que ocorreram no YouTube Music antes de 2021-03-01 estao inclusas em CORE

Metricas

views

Numero de vezes que um video foi visualizado. O help center do YouTube traz informacoes adicionais sobre como views sao reportadas

estimatedMinutesWatched

Numero de minutos que os usuarios assistiram videos

comments

O numero de vezes que usuarios comentaram em um video

likes

O numero de vezes que usuarios indicaram que eles gostaram de um video dando a ele uma avaliacao positiva

dislikes

O numero de vezes que usuarios indicaram que eles nao gostaram de um video dando a ele uma avaliacao negativa

shares

O numero de vezes que usuarios compartilharam um video utilizando o botao Share

annotationClickThroughRate

A proporcao de anotacoes que expectadores clicaram comparado com o numero total de impressoes de anotacoes que podiam ser clicadas

annotationCloseRate

A proporcao de anotacoes que expectadores fecharam em relacao ao numero total de impressoes de anotacoes

averageViewDuration

O tamanho medio, em segundos, de reproducoes de video

subscribersGained

O numero de vezes que usuarios se subscreveram a um canal

subscribersLost

O numero de vezes que usuarios cancelaram sua subscricao a um canal

redViews

O numero de vezes que um video foi visualizado por membros do YouTube Premium (antigo YouTube Red)

estimatedRedMinutesWatched

O numero de minutos que membros do YouTube Premium (antigo YouTube Red) assistiram a um video

averageViewPercentage

O percentual medio assistido de um video durante reproducoes

videosAddedToPlaylists

O numero de vezes que videos foram adicionados a qualquer playlist do YouTube. Estes videos podem ter sido adicionados a playlist do dono do video ou a playlists de outros canais. Esse valor tambem considera quando videos sao incluidos a playlists padrao como "Assistir mais tarde", mas nao considera quando os videos sao automaticamente adicionados a playlists como os uploads de um canal ou o historico de videos assistidos do usuario. Apenas valores absolutos sao retornados. Entao, se um usuario adiciona o video a uma playlist, o remove e depois o adiciona outra vez, o valor sera contabilizado dobrado. Essa metrica nao retorna valores antes de 2014-10-01

videosRemovedFromPlaylists

O numero de vezes que videos foram removidos de qualquer playlist do YouTube. Estes videos podem ter sido removidos de playlists do dono ou de playlists de outros canais. Esta metrica inclui o numero de vezes que videos foram removidos de playlists padrao como "Assistir mais tarde". O valor retornado e absoluto, ou seja, se um usuario remove o video de uma playlist, o adiciona de novo e depois o remove novamente, a metrica ira refletir o valor dobrado. Dados disponiveis a partir de 2014-10-01

annotationImpressions

O numero de impressoes de anotacoes

annotationClickableImpressions

O numero de anotacoes que apareceram e poderiam ser clicadas

annotationClicks

O numero de anotacoes clicadas

annotationClosableImpressions

O numero de anotacoes que apareceram e poderiam ser fechadas

annotationCloses

O numero de anotacoes fechadas

cardImpressions

O numero de vezes que cards foram exibidos. Quando o painel de cards e aberto, uma impressao de card e contabilizada para cada um dos cards do video

cardClicks

O numero de vezes que os cards foram clicados

cardClickRate

A taxa de cliques dos cards, calculada como a divisao entre o numero de cliques em cards e o numero de impressoes dos cards

cardTeaserImpressions

O numero de vezes que previas dos cards foram exibidas. Uma visualizacao de video pode gerar multiplas impressoes para previas

cardTeaserClicks

O numero de cliques em previas dos cards. Cliques em icones dos cards sao atribuidos para a ultima previa exibida para o usuario

cardTeaserClickRate

A taxa de cliques nas previas dos cards, calculada como a razao entre o numero de cliques em previas dos cards sobre o numero de impressoes de previas de cards