YouFlowYouFlowby Y4Y Company
Voltar ao sistema

Dados do Canal (a fonte dos números: CSV do YouTube Studio ou Gestor de Canais)

A aba Dados de Gestão de Canais > Canais > Gerenciar mostra de onde vêm os números do canal, deixa importar o CSV do YouTube Studio (ou completar com receita) e guarda o histórico. Os números em si (views, tempo, inscritos, gráfico, top vídeos, Inteligência do canal) ficam na aba Desempenho, a única tela de números do canal.

Pra que serve

Os números do canal entram no YouFlow por um de dois caminhos:

  1. Gestor de Canais (canal conectado ao Google): todo dia de manhã o agente lê o YouTube e grava views, tempo de exibição, inscritos, impressões e CTR dos últimos 90 dias. Não precisa importar nada.
  2. CSV do YouTube Studio (canal não conectado): você exporta do Studio e importa aqui. É também o único jeito de trazer receita e RPM, porque a API do YouTube só entrega esses números com um escopo que o YouFlow não pede.

O que entra por qualquer um dos caminhos alimenta os Relatórios, o painel do Estrategista e a Inteligência do canal (curva de vida, melhor dia, benchmark de CTR), que aparece em Desempenho sem gastar créditos de IA.

Quem pode acessar

  • Plano necessário: Creator+. Ver planos.
  • Perfis com acesso: Dono, administrador e gerente veem e importam; colaborador vê.

Como chegar

Menu lateral, seção "Gestão de Canais", opção "Canais", "Gerenciar" no card do canal e aba Dados. O onboarding, o aviso do Estrategista e os Relatórios levam direto pra aba. É por canal: o canal é o escolhido no seletor do topo do sistema.

O que a aba Dados mostra

  • Card da fonte: "Alimentado pelo Gestor de Canais" com "Atualizado hoje/ontem/há N dias", ou "Última importação" com a data do CSV; o período coberto; a cobertura (vídeos do conjunto, quantos casaram com cards do sistema, órfãos, dias de série, vídeos com série); a receita guardada, quando há. Botões: Como importar, Gerar relatório (abre Relatórios já no canal) e Completar com receita (CSV) ou Substituir dados.
  • Histórico: as últimas gravações, cada uma com a origem ("Gestor de Canais" ou "CSV"), a data, o período e a quantidade de vídeos e dias.
  • Sem nada ainda: a tela explica os dois caminhos e oferece importar o CSV ou conectar o canal.

Nenhum número aparece aqui. Pra ver os números, aba Desempenho (ao lado).

ℹ️
Vídeos órfãos. Vídeos que estão no conjunto mas não têm card no sistema entram como "órfãos". Servem de contexto histórico pra IA, mas não viram card no Kanban (nada é criado automaticamente).

Como exportar do YouTube Studio

O botão "Como importar" abre o passo a passo com detalhes. Resumo:

  1. Acessa studio.youtube.com. Se você gerencia vários canais, troque pro canal certo antes (avatar no canto superior direito).
  2. Vai em Analytics e depois na aba Conteúdo
  3. Escolhe o período no canto superior direito (28 dias, 90 dias, 6 meses ou 12 meses). Períodos maiores que 12 meses são rejeitados.
  4. Clica no ícone de Exportar (download, à direita da tabela) → Valores separados por vírgula (.csv)
  5. Download. Você ganha um arquivo .zip com 3 .csv dentro

Os 3 CSVs que vêm no ZIP e o que cada um alimenta:

  • Dados da tabela.csv: essencial. Uma linha "Total" (agregado do canal) + uma linha por vídeo com todas as métricas (views, CTR, impressões, inscritos ganhos). Alimenta o Estrategista, o ranking de top vídeos e o match com os cards do sistema.
  • Total.csv: série temporal do canal (1 linha por dia com views totais). Alimenta o gráfico de views por dia e a detecção de picos.
  • Dados do gráfico.csv: série temporal só dos ~5 vídeos campeões do período (limite do próprio YouTube). Alimenta os sparklines e a análise de decaimento.
ℹ️
Só tem o "Dados da tabela.csv" solto? Pode arrastar ele sozinho. O gráfico de views por dia fica vazio, mas o resto (top vídeos, benchmark de CTR, Estrategista) funciona.

Como importar

  1. Abra a aba Dados de Gerenciar, com o canal certo escolhido no topo.
  2. Clique em Importar CSV (ou "Completar com receita", se o canal é conectado) e arraste o ZIP (ou um CSV solto) na área de upload. O sistema detecta o encoding (UTF-8 / UTF-16 com BOM) automaticamente.
  3. Confira o preview. Um modal abre mostrando o que foi detectado (arquivos, tipo de cada um, período coberto, quantidade de vídeos e dias, e quais métricas vieram).
  4. Confirme. O sistema processa e salva. O card da fonte e o histórico atualizam, e a aba Desempenho passa a mostrar os números novos (com a receita, se veio) e a Inteligência recalculada, sem recarregar a página.
⚠️
Substituição total. Toda importação apaga os dados anteriores daquele canal e insere os novos (evita duplicação). Por isso, exporte sempre a janela mais completa possível (até 12 meses) pra não perder histórico. A receita do CSV fica guardada mesmo quando o Gestor de Canais reescreve o resto todo dia.

Canal conectado ao Gestor de Canais: sem CSV

Se o canal está conectado ao Google (Gestão de Canais > Canais, "Conectar com Google", ou a aba Geral de Gerenciar), o conjunto se preenche sozinho todo dia de manhã. O card mostra "Alimentado pelo Gestor de Canais" e "Atualizado hoje".

  • O que não vem: receita e RPM. Se quiser, importe o CSV pelo botão "Completar com receita (CSV)": a receita fica guardada com o período do CSV e aparece no card Receita de Desempenho; o resto dos números volta a vir do YouTube na rodada seguinte.
  • Canal conectado, sem dados ainda: a tela avisa que os números chegam na próxima rodada.
  • Canal sem conexão: tudo pelo CSV, e Desempenho mostra o que o CSV tem (totais do período e views por dia).
  • Desconectou o canal: os dados lidos pela API são apagados (exigência do YouTube). O CSV, se houver, continua.

O que o sistema usa esses dados pra fazer

1. Desempenho do canal

A aba Desempenho de Gerenciar (e o Painel do Gestor de Canais) mostra os números, o gráfico de views por dia com picos, mediana e tendência, os top vídeos e a Inteligência do canal. Veja Canal e Gestor de Canais.

2. Relatórios mensais

Em Relatórios, modo "Usar base importada", gera relatório do mês escolhido sem precisar fazer upload de novo.

3. IA Estrategista (Painel)

A aba Painel do Estrategista usa esses dados pra calcular performance por objetivo, cruzando o objetivo de cada vídeo com as views da janela.

4. Banner "Dados desatualizados"

No Estrategista aparece um aviso se a última gravação tem mais de 30 dias. O clique leva pra aba Dados.

Dicas e atalhos

  • Canal seu ou de cliente que autoriza: conecte ao Google e esqueça o CSV (só pra receita).
  • Importa todo mês (ex: dia 5) quando o canal não é conectado; vira rotina e mantém a base fresca.
  • Sobe o ZIP inteiro, não CSVs avulsos. O Studio já gera o ZIP e o sistema identifica cada CSV de uma vez.
  • Exporte a janela completa (12 meses). Como cada import substitui o anterior, subir um período curto "encolhe" o histórico do canal.
  • Encoding errado? Se vier caractere tipo "é" no preview, é UTF-8 lido como Latin-1. O parser tenta corrigir, mas se persistir, abra o CSV no Excel/Sheets e re-salve como UTF-8.

Limitações conhecidas

  • Um canal por vez. Os dados são por canal; o canal é o do seletor do topo.
  • Substituição total. Cada import apaga o anterior daquele canal. Não dá pra "somar" duas exportações; suba sempre a janela completa.
  • Receita só aparece se você é monetizado e exportou os dados de receita do Studio.
  • O CSV só tem views por dia. Tempo de exibição, inscritos, impressões e receita vêm como total do período; por isso, no canal só com CSV, Desempenho não compara com o período anterior nem desenha horas e inscritos por dia. Conectar o canal resolve.
  • Série por vídeo é limitada aos campeões. O "Dados do gráfico.csv" só traz os ~5 vídeos mais vistos do período (limite do próprio YouTube).