YouFlowYouFlowby Y4Y Company
Voltar ao sistema

Dados do Canal (importar CSV do YouTube Studio)

Importa os relatórios do YouTube Studio (CSV ou ZIP) pra dentro do sistema, com gráficos prontos. Os dados alimentam relatórios mensais, painel de IA e análises de performance.

Pra que serve

A YouTube API tem limites pra quem não tem acesso enterprise. Pra você ter dados ricos do seu canal dentro do YouFlow (visões mensais, retenção média, top vídeos, decaimento), o caminho é exportar do YouTube Studio e importar aqui.

A função dessa tela é transformar export bruto em dado estruturado com gráficos, sem você precisar abrir Excel ou montar dashboard externo.

Ela te ajuda de três formas:

  1. Relatórios mensais sem reupload. Importa uma vez, gera quantos relatórios pro cliente quiser daquela base.
  2. Painel do Estrategista funciona. Sem dados importados, o painel de mix de objetivos não consegue calcular performance.
  3. Inteligência do canal. Curva de vida dos vídeos, melhor dia pra publicar e benchmark de CTR saem prontos dos dados, sem gastar créditos de IA.
  4. Banner de "dados desatualizados" aparece em outras telas se passar 30 dias sem importar, te lembra de manter a base fresca.

Quem pode acessar

  • Plano necessário: Creator+. Ver planos.
  • Perfis com acesso: Dono, administrador, gestor.

Como chegar

Menu lateral, seção "Produção", opção "Dados do Canal". Os dados são por canal, então selecione o canal certo antes de importar.

Como exportar do YouTube Studio

A tela tem um botão "Como importar" (canto superior direito) que 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 evolução 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 evolução do canal fica vazio, mas o resto (top vídeos, benchmark de CTR, Estrategista) funciona.

Como importar

  1. Abra a tela. Menu "Produção" → "Dados do Canal", com o canal certo selecionado.
  2. Arraste o ZIP (ou um CSV solto) na área de upload, ou clique pra selecionar. 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. A tela recarrega com o card de estado atual, os gráficos e a Inteligência do canal.
⚠️
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.

Depois de confirmar, a tela mostra:

  • Card de estado atual: período coberto e quatro métricas grandes: Views totais, Inscritos ganhos, Tempo de exibição e Receita (na moeda detectada no CSV, só se você exportou dados de receita). Abaixo, chips com contagem de vídeos, matched, órfãos, dias de série e top com série.
  • Evolução do canal: gráfico de views diárias no período.
  • Inteligência do canal: curva de vida, melhor dia e benchmark de CTR (detalhado abaixo).
  • Top vídeos · curva de decaimento: sparklines dos vídeos campeões.
  • Top 10 vídeos do período: ranking com views, CTR e data de publicação de cada um.
ℹ️
Vídeos órfãos. Vídeos que estão no CSV 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).

Inteligência do canal (sem créditos de IA)

Logo abaixo do gráfico de evolução, o sistema calcula três análises de matemática pura sobre os dados importados. Recalcula sozinho a cada import, e tem botão "Recalcular" manual.

Curva de vida dos vídeos
Classifica cada vídeo com 30+ dias de série em Evergreen, Pico e morte, Crescimento lento ou Revivido. Clique numa classe pra ver os vídeos dela.
Melhor dia pra publicar
Ranking real dos dias da semana, normalizado pelo tamanho do canal na época. Precisa de no mínimo 8 vídeos por dia pra dar confiança.
Benchmark de CTR
Percentis de CTR (p20 a p80) por faixa de impressões, mais os "candidatos a otimização": vídeos com impressões altas e CTR abaixo do p40 da faixa.

O que o sistema usa esses dados pra fazer

1. Relatórios mensais

Em Relatórios, modo "Usar base importada", gera relatório do mês escolhido sem precisar fazer upload de novo. Sistema filtra dados_canal_videos pelo período do relatório e monta as seções automaticamente.

2. IA Estrategista (Painel)

A aba Painel do Estrategista usa esses dados pra calcular performance por objetivo, cruza videos.objetivo_tipo (que você setou ao criar o vídeo) com dados_canal_videos.visualizacoes da janela importada.

3. Banner "Dados desatualizados"

Em vários lugares (estrategista, relatórios) aparece banner amarelo se a última importação tem mais de 30 dias. O clique leva direto pra essa tela.

Histórico de importações

Embaixo da tela tem uma lista das importações anteriores, cada uma com data da importação, período coberto e quantidade de vídeos e dias de série. Serve de registro do que já entrou naquele canal.

Dicas e atalhos

  • Importa todo mês (ex: dia 5), vira rotina e mantém a base fresca pra sumir o banner de "dados desatualizados"
  • 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

  • Sem importação automática. Não puxamos da YouTube API direto, você exporta do Studio manualmente (razão: limites da API e custo).
  • Um canal por vez. Os dados são por canal, importe no canal certo.
  • 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.
  • 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), então a curva de decaimento cobre só o topo.
  • Sem alerta de queda. Ainda não avisamos quedas abruptas de métrica, você acompanha pelos gráficos.