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

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