Adicionando a fonte de dados
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
- Faca login na plataforma da Kondado, va para a pagina de adicionar conectores e selecione o conector do YouTube
- Clique em "Sign in with Google"
- Selecione a conta do Google que ira utilizar
- Selecione o canal (conta do YouTube) que ira utilizar
- Na proxima tela, marque TODAS as permissoes que sao requisitadas e clique em Continue
- 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
Pipelines
Resumo
Diagrama de relacionamento
Clique para expandir
Estatísticas diárias do canal
Esta integracao traz varias metricas, nas dimensoes day e channel
Tipo de replicacao: Incremental
Métricas diárias do canal no YouTube: uma linha por dia por canal, com indicadores agregados de desempenho como visualizações, minutos estimados assistidos, duração média e percentual médio de visualização, curtidas, descurtidas, comentários, compartilhamentos, inscritos ganhos e perdidos, além de métricas de cards e anotações (impressões, cliques e taxas). Inclui título, descrição, URL personalizada e miniatura do canal.
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data (dia) a que as métricas se referem; uma linha por dia. Formato ISO-8601 (AAAA-MM-DD). |
|
|
text |
[pt] Identificador do canal no YouTube ao qual a linha se refere. |
|
|
text |
[pt] Nome (título) do canal no YouTube. |
|
|
text |
[pt] Descrição do canal no YouTube. |
|
|
text |
[pt] URL personalizada (vanity) do canal no YouTube. |
|
|
text |
[pt] URL da imagem de miniatura do canal. |
|
|
int |
[pt] Número de visualizações registradas no período. A partir de 24/08/2026 o YouTube passou a contar uma visualização assim que o vídeo começa a tocar, sem exigir tempo mínimo de assistência — a metodologia foi alinhada à que já era usada para Shorts, e vale também para vídeos longos e transmissões ao vivo. A contagem anterior (com tempo mínimo) continua disponível na API do YouTube como métrica engagedViews, que a Kondado não coleta. |
|
|
int |
[pt] Número de comentários publicados no período. |
|
|
int |
[pt] Número de descurtidas (dislikes) registradas no período. |
|
|
int |
[pt] Número de curtidas (likes) registradas no período. |
|
|
int |
[pt] Número de vezes que o conteúdo foi compartilhado no período. |
|
|
float |
[pt] Taxa de cliques nas anotações: razão entre cliques e impressões de anotações clicáveis (valor entre 0 e 1). |
|
|
float |
[pt] Taxa de fechamento de anotações: razão entre anotações fechadas e impressões de anotações que podem ser fechadas (valor entre 0 e 1). |
|
|
int |
[pt] Duração média das reproduções, em segundos. |
|
|
int |
[pt] Estimativa do total de minutos assistidos no período. |
|
|
int |
[pt] Número de novos inscritos ganhos no período. |
|
|
int |
[pt] Número de inscritos perdidos no período. |
|
|
int |
[pt] Número de visualizações feitas por assinantes do YouTube Premium. |
|
|
int |
[pt] Estimativa de minutos assistidos por assinantes do YouTube Premium. |
|
|
float |
[pt] Percentual médio de cada vídeo que foi assistido (valor entre 0 e 100). |
|
|
int |
[pt] Número de vezes que vídeos foram adicionados a playlists. |
|
|
int |
[pt] Número de vezes que vídeos foram removidos de playlists. |
|
|
int |
[pt] Número total de impressões de anotações. |
|
|
int |
[pt] Número de impressões de anotações que podiam ser clicadas. |
|
|
int |
[pt] Número de anotações clicadas. |
|
|
int |
[pt] Número de impressões de anotações que podiam ser fechadas. |
|
|
int |
[pt] Número de anotações fechadas pelos espectadores. |
|
|
int |
[pt] Número de vezes que os cards foram exibidos. |
|
|
int |
[pt] Número de cliques nos cards. |
|
|
float |
[pt] Taxa de cliques nos cards: razão entre cliques e impressões de cards (valor entre 0 e 1). |
|
|
int |
[pt] Número de vezes que os teasers de cards foram exibidos. |
|
|
int |
[pt] Número de cliques nos teasers de cards. |
|
|
int |
[pt] Taxa de cliques nos teasers de cards: razão entre cliques e impressões de teasers (valor entre 0 e 1). |
Estatísticas diárias dos vídeos
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A data inicial para leitura de dados
Relacionamentos:
Métricas diárias por vídeo no YouTube: uma linha por dia por vídeo, com indicadores de desempenho como visualizações, minutos estimados assistidos, duração média e percentual médio de visualização, curtidas, descurtidas, comentários, compartilhamentos, inscritos ganhos e perdidos, além de métricas de cards e anotações. Inclui dados do canal (id, título, descrição, URL personalizada e miniatura) e do vídeo (título, descrição e miniatura).
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data (dia) a que as métricas se referem; uma linha por dia. Formato ISO-8601 (AAAA-MM-DD). |
|
|
text |
[pt] Identificador do vídeo no YouTube ao qual a linha se refere. |
|
|
text |
[pt] Identificador do canal no YouTube. |
|
|
text |
[pt] Nome (título) do canal no YouTube. |
|
|
text |
[pt] Descrição do canal no YouTube. |
|
|
text |
[pt] URL personalizada (vanity) do canal no YouTube. |
|
|
text |
[pt] URL da imagem de miniatura do canal. |
|
|
text |
[pt] Título do vídeo. |
|
|
text |
[pt] Descrição do vídeo. |
|
|
text |
[pt] URL da imagem de miniatura do vídeo. |
|
|
int |
[pt] Número de visualizações registradas no período. A partir de 24/08/2026 o YouTube passou a contar uma visualização assim que o vídeo começa a tocar, sem exigir tempo mínimo de assistência — a metodologia foi alinhada à que já era usada para Shorts, e vale também para vídeos longos e transmissões ao vivo. A contagem anterior (com tempo mínimo) continua disponível na API do YouTube como métrica engagedViews, que a Kondado não coleta. |
|
|
int |
[pt] Número de comentários publicados no período. |
|
|
int |
[pt] Número de descurtidas (dislikes) registradas no período. |
|
|
int |
[pt] Número de curtidas (likes) registradas no período. |
|
|
int |
[pt] Número de vezes que o conteúdo foi compartilhado no período. |
|
|
float |
[pt] Taxa de cliques nas anotações: razão entre cliques e impressões de anotações clicáveis (valor entre 0 e 1). |
|
|
float |
[pt] Taxa de fechamento de anotações: razão entre anotações fechadas e impressões de anotações que podem ser fechadas (valor entre 0 e 1). |
|
|
int |
[pt] Duração média das reproduções, em segundos. |
|
|
int |
[pt] Estimativa do total de minutos assistidos no período. |
|
|
int |
[pt] Número de novos inscritos ganhos no período. |
|
|
int |
[pt] Número de inscritos perdidos no período. |
|
|
int |
[pt] Número de visualizações feitas por assinantes do YouTube Premium. |
|
|
int |
[pt] Estimativa de minutos assistidos por assinantes do YouTube Premium. |
|
|
float |
[pt] Percentual médio de cada vídeo que foi assistido (valor entre 0 e 100). |
|
|
int |
[pt] Número de vezes que vídeos foram adicionados a playlists. |
|
|
int |
[pt] Número de vezes que vídeos foram removidos de playlists. |
|
|
int |
[pt] Número total de impressões de anotações. |
|
|
int |
[pt] Número de impressões de anotações que podiam ser clicadas. |
|
|
int |
[pt] Número de anotações clicadas. |
|
|
int |
[pt] Número de impressões de anotações que podiam ser fechadas. |
|
|
int |
[pt] Número de anotações fechadas pelos espectadores. |
|
|
int |
[pt] Número de vezes que os cards foram exibidos. |
|
|
int |
[pt] Número de cliques nos cards. |
|
|
float |
[pt] Taxa de cliques nos cards: razão entre cliques e impressões de cards (valor entre 0 e 1). |
|
|
int |
[pt] Número de vezes que os teasers de cards foram exibidos. |
|
|
int |
[pt] Número de cliques nos teasers de cards. |
|
|
int |
[pt] Taxa de cliques nos teasers de cards: razão entre cliques e impressões de teasers (valor entre 0 e 1). |
Itens de Playlists
Tipo de replicacao: Integral
Relacionamentos:
Videos de cada playlist do canal. Lista todos os videos que fazem parte de cada playlist, com posicao, titulo e datas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID da playlist |
|
|
text |
[pt] ID do video |
|
|
text |
[pt] Titulo da playlist |
|
|
text |
[pt] Titulo do video |
|
|
text |
[pt] Descricao do video |
|
|
text |
[pt] URL da thumbnail do video |
|
|
int |
[pt] Posicao do video na playlist |
|
|
text |
[pt] Titulo do canal dono do video |
|
|
text |
[pt] ID do canal dono do video |
|
|
text |
[pt] ID do canal da playlist |
|
|
timestamp |
[pt] Data de publicacao do video |
|
|
timestamp |
[pt] Data em que o video foi adicionado a playlist |
|
|
timestamp |
[pt] Data/hora da extracao |
Playlists
Playlists do canal do YouTube. Inclui titulo, descricao, status de privacidade e quantidade de videos.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] ID da playlist no YouTube |
|
|
timestamp |
[pt] Data de criacao da playlist |
|
|
text |
[pt] ID do canal |
|
|
text |
[pt] Titulo da playlist |
|
|
text |
[pt] Descricao da playlist |
|
|
text |
[pt] Titulo do canal |
|
|
text |
[pt] URL da thumbnail da playlist |
|
|
text |
[pt] Status de privacidade (public, private, unlisted) |
|
|
int |
[pt] Quantidade de videos na playlist |
|
|
timestamp |
[pt] Data/hora da extracao |
Visualizações diarias dos vídeos
Tipo de replicacao: Incremental
Parametros:
- Data inicial de leitura (Savepoint): A data inicial para leitura de dados
- Detalhamento: Selecione dimensões adicionais a day+channel para agegação dos dados
Relacionamentos:
Visualizações diárias por vídeo no YouTube segmentadas por uma dimensão de detalhamento (breakdown): uma linha por dia, por vídeo e por valor da dimensão escolhida (por exemplo tipo de dispositivo, sistema operacional, status de inscrição ou fonte de tráfego), com o número de visualizações e os minutos estimados assistidos. Inclui dados do canal e do vídeo (título, descrição e miniatura).
| Campo | Tipo | |
|---|---|---|
|
date |
[pt] Data (dia) a que as métricas se referem; uma linha por dia. Formato ISO-8601 (AAAA-MM-DD). |
|
|
text |
[pt] Identificador do vídeo no YouTube ao qual a linha se refere. |
|
|
text |
[pt] Identificador do canal no YouTube. |
|
|
text |
[pt] Nome (título) do canal no YouTube. |
|
|
text |
[pt] Descrição do canal no YouTube. |
|
|
text |
[pt] URL personalizada (vanity) do canal no YouTube. |
|
|
text |
[pt] URL da imagem de miniatura do canal. |
|
|
text |
[pt] Título do vídeo. |
|
|
text |
[pt] Descrição do vídeo. |
|
|
text |
[pt] URL da imagem de miniatura do vídeo. |
|
|
int |
[pt] Número de visualizações registradas no período. A partir de 24/08/2026 o YouTube passou a contar uma visualização assim que o vídeo começa a tocar, sem exigir tempo mínimo de assistência — a metodologia foi alinhada à que já era usada para Shorts, e vale também para vídeos longos e transmissões ao vivo. A contagem anterior (com tempo mínimo) continua disponível na API do YouTube como métrica engagedViews, que a Kondado não coleta. |
|
|
int |
[pt] Estimativa do total de minutos assistidos no período. |
Visualizações diárias do canal
Esta integracao traz as metricas de views e estimatedMinutesWatched por dia de acordo com varios detalhamentos possiveis, que sao combinacoes de dimensoes juntamente com day e channel
Tipo de replicacao: Integral
Parametros:
- Detalhamento: Selecione dimensões adicionais a day+channel para agegação dos dados
Visualizações diárias do canal no YouTube segmentadas por uma dimensão de detalhamento (breakdown): uma linha por dia, por canal e por valor da dimensão escolhida (por exemplo tipo de dispositivo, sistema operacional, status de inscrição ou fonte de tráfego), com o número de visualizações e os minutos estimados assistidos, além de título, descrição, URL personalizada e miniatura do canal.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Valor da dimensão de detalhamento (breakdown) escolhida para o relatório — por exemplo o tipo de dispositivo, sistema operacional, status de inscrição ou fonte de tráfego correspondente a esta linha. |
|
|
date |
[pt] Data (dia) a que as métricas se referem; uma linha por dia. Formato ISO-8601 (AAAA-MM-DD). |
|
|
text |
[pt] Identificador do canal no YouTube ao qual a linha se refere. |
|
|
text |
[pt] Nome (título) do canal no YouTube. |
|
|
text |
[pt] Descrição do canal no YouTube. |
|
|
text |
[pt] URL personalizada (vanity) do canal no YouTube. |
|
|
text |
[pt] URL da imagem de miniatura do canal. |
|
|
int |
[pt] Número de visualizações registradas no período. A partir de 24/08/2026 o YouTube passou a contar uma visualização assim que o vídeo começa a tocar, sem exigir tempo mínimo de assistência — a metodologia foi alinhada à que já era usada para Shorts, e vale também para vídeos longos e transmissões ao vivo. A contagem anterior (com tempo mínimo) continua disponível na API do YouTube como métrica engagedViews, que a Kondado não coleta. |
|
|
int |
[pt] Estimativa do total de minutos assistidos no período. |
Notas
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 anteriormenteWATCH: reproducoes na propria pagina do video no YouTube ou em um aplicativo oficial do YouTube, como o app do AndroidSEARCH: reproducoes diretas na pagina de resultados da busca do YouTubeMOBILE: 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 MOBILEEXTERNAL_APP: aplicacao terceira, utilizando um metodo que nao seja embed. Se encaixam aqui reproducoes em aplicativos que utilizam o YouTube Android Player APIEMBEDDED: outro site, onde o video estava embedadoCHANNEL: pagina do canalBROWSE: 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 YouTubeYT_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 playlistYT_OTHER_PAGE: visualizacoes a partir de um link que nao sao os resultados de busca ou videos relacionadosYT_CHANNEL: visualizacoes na pagina do canalSUBSCRIBER: o video foi encontrado via feed da homepage do YouTube ou funcionalidade de subscricao do YouTubeSHORTS: a visualizacao ocorreu devido a um swipe vertical de um video anterior na experiencia de visualizacao em ShortsRELATED_VIDEO: as visualizacoes vieram de uma listagem de videos similares da pagina de outro videoPROMOTED: 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 playlistNOTIFICATION: o video foi referenciado de um email ou notificacao do YouTubeNO_LINK_OTHER: o YouTube nao identificou a origem. Inclui trafego direto e trafego em appsNO_LINK_EMBEDDED: o video estava embedado em outro site quando foi reproduzidoEXT_URL: link em outro site (URL externa). Inclui referenciamentos de resultados de busca do GoogleEND_SCREEN: tela final de outro videoCAMPAIGN_CARD: card em outro videoANNOTATION: anotacao de outro videoADVERTISING: 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-18MUSIC: 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 guardadosKIDS: Atividade que ocorreu no YouTube KidsGAMING: Atividade que ocorreu no YouTube GamingCORE: 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
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas
Adicionar o conector do YouTube na Kondado
Configure a replicacao de metricas organicas de canais e videos do YouTube para o destino escolhido.
Adicione a fonte YouTube
Na Kondado, acesse 'Fontes' e adicione uma nova fonte do tipo YouTube.
Autentique com sua conta Google
Faca login via OAuth com a conta Google que tem acesso ao canal e autorize a leitura dos dados do YouTube.
Selecione o canal a replicar
Escolha o canal (ou brand account) cujos dados voce deseja extrair. Voce pode criar fontes separadas para cada canal.
Crie a integracao escolhendo o pipeline
Selecione entre os pipelines listados nesta pagina (estatisticas de canal, videos, demograficos, etc.) e defina o savepoint inicial.
Ative e monitore
Ative a integracao e acompanhe a execucao para garantir que as metricas estao chegando ao destino.
