YouTube

Adicionando o conector

Baseado nas documentações de API do YouTube (Analytics) e (Data)

Requisitos

Possuir um canal no YouTube associado à conta do Google que irá autorizar o conector
Caso sua conta seja do tipo Brand Account, é necessário que o usuário que irá autorizar o conector seja o Owner (dono) da conta

Instruções

1) Faça login na plataforma da Kondado, vá para a página de adicionar conectores e selecione o conector do YouTube

2) Clique em “Sign in with Google“

3) Selecione a conta do google que irá utilizar

4) Selecione o canal (conta do YouTube) que irá utilizar

5) Na próxima tela, marque TODAS as permissões que são requisitadas e clique em Continue

6) Você será redirecionado para a página da Kondado com o acesso já autorizado. Dê um nome ao seu conector

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

Os dados possuem um atraso de até 3 dias para disponibilização via API

Integrações

Índice

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

Gráfico de relacionamento

Clique para ampliar

Visualizações diarias dos vídeos

Campo	Tipo
day	date
video_id	text
channel_id	text	Estatísticas diárias do canal > > channel Visualizações diárias do canal > > channel
channel_title	text
channel_description	text
channel_custom_url	text
channel_thumbnail	text
video_title	text
video_description	text
video_thumbnail_url	text
views	int
estimatedminuteswatched	int

Visualizações diárias do canal

Campo	Tipo
dimension_x	text
day	date
channel	text
channel_title	text
channel_description	text
channel_custom_url	text
channel_thumbnail	text
views	int
estimatedminuteswatched	int

Esta integração traz as métricas de views e estimatedMinutesWatched por dia de acordo com vários detalhamentos possíveis, que são combinações de dimensões juntamente com day e channel

Estatísticas diárias dos vídeos

Campo	Tipo
day	date
video_id	text
channel_id	text	Estatísticas diárias do canal > > channel Visualizações diárias do canal > > channel
channel_title	text
channel_description	text
channel_custom_url	text
channel_thumbnail	text
video_title	text
video_description	text
video_thumbnail_url	text
views	int
comments	int
dislikes	int
likes	int
shares	int
annotationclickthroughrate	float
annotationcloserate	float
averageviewduration	int
estimatedminuteswatched	int
subscribersgained	int
subscriberslost	int
redviews	int
estimatedredminuteswatched	int
averageviewpercentage	float
videosaddedtoplaylists	int
videosremovedfromplaylists	int
annotationimpressions	int
annotationclickableimpressions	int
annotationclicks	int
annotationclosableimpressions	int
annotationcloses	int
cardimpressions	int
cardclicks	int
cardclickrate	float
cardteaserimpressions	int
cardteaserclicks	int
cardteaserclickrate	int

Estatísticas diárias do canal

Campo	Tipo
day	date
channel	text
channel_title	text
channel_description	text
channel_custom_url	text
channel_thumbnail	text
views	int
comments	int
dislikes	int
likes	int
shares	int
annotationclickthroughrate	float
annotationcloserate	float
averageviewduration	int
estimatedminuteswatched	int
subscribersgained	int
subscriberslost	int
redviews	int
estimatedredminuteswatched	int
averageviewpercentage	float
videosaddedtoplaylists	int
videosremovedfromplaylists	int
annotationimpressions	int
annotationclickableimpressions	int
annotationclicks	int
annotationclosableimpressions	int
annotationcloses	int
cardimpressions	int
cardclicks	int
cardclickrate	float
cardteaserimpressions	int
cardteaserclicks	int
cardteaserclickrate	int

Esta integração traz várias métricas, nas dimensões day e channel

Dimensões

insightPlaybackLocationType

Agrega os dados com base no tipo de aplicação onde o vídeo foi tocado. Os valores possíveis são:

BROWSE: home page do YouTube ou tela inicial, no feed de subscrição do usuário ou em outro componente de navegação do YouTube
CHANNEL: página do canal
EMBEDDED: outro site, onde o vídeo estava embedado com <iframe> ou <object>
EXTERNAL_APP: aplicação terceira, utilizando um método que não seja <iframe> ou <object>. Se encaixam aqui reproduções em aplicativos que utilizam o YouTube Android Player API
MOBILE: site mobile do YouTube ou clientes que utilizam os clientes aprovados da YouTube API, incluindo dispositivos móveis. Desde 10/09/2013, reproduções não são mais categorizadas como MOBILE
SEARCH: reproduções diretas na página de resultados da busca do YouTube
WATCH: reproduções na própria página do vídeo no YouTube ou em um aplicativo oficial do YouTube, como o app do Android
YT_OTHER: outro tipo de reprodução, não classificada anteriormente

insightTrafficSourceType

Agrega os dados com base no forma como os usuários chegaram ao vídeo (referrer). Valores possíveis são:

ADVERTISING: anúncio
ANNOTATION: anotação de outro vídeo
CAMPAIGN_CARD: card em outro vídeo
END_SCREEN: tela final de outro vídeo
EXT_URL: link em outro site (URL externa). Inclui referenciamentos de resultados de busca do Google
NO_LINK_EMBEDDED: o vídeo estava embedado em outro site quando foi reproduzido
NO_LINK_OTHER: o YouTube não identificou a origem. Inclui tráfego direto e tráfego em apps
NOTIFICATION: o vídeo foi referenciado de um email ou notificação do YouTube
PLAYLIST: o vídeo foi reproduzido como parte de uma playlist. É diferente de YT_PLAYLIST_PAGE, que indica que o vídeo foi reproduzido enquanto listado na playlist
PROMOTED: as reproduções vieram de promoção não paga do YouTube, como a página do “Spotlight Videos”
RELATED_VIDEO: as visualizações vieram de uma listagem de vídeos similares da página de outro vídeo
SHORTS: a visualização ocorreu devido a um swipe vertical de um vídeo anterior na experiência de visualização em Shorts
SUBSCRIBER: o vídeo foi encontrado via feed da homepage do YouTube ou funcionalidade de subscrição do YouTube
YT_CHANNEL: visualizações na página do canal
YT_OTHER_PAGE: visualizações a partir de um link que não são os resultados de busca ou vídeos relacionados
YT_PLAYLIST_PAGE: visualizações a partir da listagem de todos os vídeos de uma playlist. É diferente de PLAYLIST, que indica que o vídeo foi reproduzido como parte de uma playlist
YT_SEARCH: visualizações a partir de resultados de busca do YouTube

deviceType

Agrega os resultados com base na forma física do dispositivo que as visualizações ocorreram. Os valores são retornados podem ser os seguintes: DESKTOP, GAME_CONSOLE, MOBILE, TABLET, TV e UNKNOWN_PLATFORM

operatingSystem

Identifica o sistema de software do dispositivo onde a visualização ocorreu. Os valores possíveis são: 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 métrica está relacionada a expectadores que estavam subscritos ao canal do vídeo ou da playlist. Valores possíveis são SUBSCRIBED e UNSUBSCRIBED. Perceba que esta dimensão é dada de acordo com o momento em que a atividade do usuário aconteceu. Por exemplo, um usuário não subscrito assistiu um vídeo e depois se subscreveu ao canal e assistiu a um outro vídeo, no mesmo dia. Neste caso, uma das suas visualizações será contabilizada como SUBSCRIBED e outra como UNSUBSCRIBED.

liveOrOnDemand

Indica se a atividade do usuário ocorreu durante uma transmissão ao vivo ou não. Os dados estarão disponíveis para esta dimensão a partir de 2014-04-01. Valores possíveis são: LIVE e ON_DEMAND

youtubeProduct

Identifica o serviço do YouTube onde a atividade do usuário ocorreu. Dados estão disponíveis a partir de 2015-07-18. Valores possíveis são:

CORE: A atividade não ocorreu em um dos apps especiais (YouTube Gaming, YouTube Kids, or YouTube Music). Exceção: Atividades que ocorreram no YouTube Music antes de 2021-03-01 estão inclusas em CORE.
GAMING: Atividade que ocorreu no YouTube Gaming.
KIDS: Atividade que ocorreu no YouTube Kids.
MUSIC: Atividade que ocorreu no YouTube Music após 2021-03-01. Dados anteriores a 2021-03-01 estão em CORE. Dados em real-time não são guardados
UNKNOWN: Atividade ocorreu antes de 2015-07-18

Métricas

views

Número de vezes que um vídeo foi visualizado. O help center do YouTube traz informações adicionais sobre como views são reportadas

estimatedMinutesWatched

Número de minutos que os usuários assistiram vídeos

comments

O número de vezes que usuários comentaram em um vídeo

likes

O número de vezes que usuários indicaram que eles gostaram de um vídeo dando a ele uma avaliação positiva

dislikes

O número de vezes que usuários indicaram que eles não gostaram de um vídeo dando a ele uma avaliação negativa

shares

O número de vezes que usuários compartilharam um vídeo utilizando o botão Share

annotationClickThroughRate

A proporção de anotações que expectadores clicaram comparado com o número total de impressões de anotações que podiam ser clicadas

annotationCloseRate

A proporção de anotações que expectadores fecharam em relação ao número total de impressões de anotações

averageViewDuration

O tamanho médio, em segundos, de reproduções de vídeo

subscribersGained

O número de vezes que usuários se subscreveram a um canal

subscribersLost

O número de vezes que usuários cancelaram sua subscrição a um canal

redViews

O número de vezes que um vídeo foi visualizado por membros do YouTube Premium (antigo YouTube Red)

estimatedRedMinutesWatched

O número de minutos que membros do YouTube Premium (antigo YouTube Red) assistiram a um vídeo

averageViewPercentage

O percentual médio assistido de um vídeo durante reproduções

videosAddedToPlaylists

O número de vezes que vídeos foram adicionados a qualquer playlist do YouTube. Estes vídeos podem ter sido adicionados à playlist do dono do vídeo ou a playlists de outros canais. Esse valor também considera quando vídeos são incluídos a playlists padrões como “Assistir mais tarde”, mas não considera quando os vídeos são automaticamente adicionados a playlists como os uploads de um canal ou o histórico de vídeos assistidos do usuário. Apenas valores absolutos são retornados. Então, se um usuário adiciona o vídeo a uma playlist, o remove e depois o adiciona outra vez, o valor será contabilizado dobrado. Essa métrica não retorna valores antes de 2014-10-01

videosRemovedFromPlaylists

O número de vezes que vídeos foram removidos de qualquer playlist do YouTube. Estes vídeos podem ter sido removidos de playlists do dono ou de playlists de outros canais. Esta métrica inclui o número de vezes que vídeos foram removidos de playlists do dono ou de playlists de outros canais. Essa Métrica inclui o número de vezes que vídeos foram removidos de playlists padrões como “Assistir mais tarde”. O valor retornado é absoluto, ou seja, se um usuário remove o vídeo de uma playlist, o adiciona de novo e depois o remove novamente, a métrica irá refletir o valor dobrado. Dados disponíveis a partir de 2014-10-01

annotationImpressions

O número de impressões de anotações

annotationClickableImpressions

O número de anotações que apareceram e poderiam ser clicadas

annotationClicks

O número de anotações clicadas

annotationClosableImpressions

O número de anotações que apareceram e poderiam ser fechadas

annotationCloses

O número de anotações fechadas

cardImpressions

O número de vezes que cards foram exibidos. Quando o painel de cards é aberto, uma impressão de card é contabilizada para cada um dos cards do vídeo

cardClicks

O número de vezes que os cards foram clicados

cardClickRate

A taxa de cliques dos cards, calculada como a divisão entre o número de cliques em cards e o número de impressões dos cards

cardTeaserImpressions

O número de vezes que prévias dos cards foram exibidas. Uma visualização de vídeo pode gerar múltiplas impressões para prévias

cardTeaserClicks

O número de cliques em prévias dos cards. Cliques em ícones dos cards são atribuídos para a última prévia exibida para o usuário

cardTeaserClickRate

A taxa de cliques nas prévias dos cards, calculada como a razão entre o número de cliques em prévias dos cards sobre o número de impressões de prévias de cards