O analisador precisa de uma linha por publicação e de cabeçalhos de coluna claros em inglês. A exportação automática de outro serviço pode ter outra estrutura: primeiro, adeque-a ao modelo. O programa não adivinha o significado de colunas arbitrárias.
Esquema de importação
O campo name é obrigatório e também é necessário pelo menos uma coluna de base: followers, views ou reach. Para o relatório de visualizações, é preciso views com um valor conhecido em pelo menos uma linha. Colunas adicionais — likes, comments, shares, saves. Todos os contadores são inteiros e não negativos.
Um exemplo simples pode ser baixado como CSV. Seu cabeçalho é name,views,likes,comments. As linhas A,100,8,2 e B,120,10,3 significam duas publicações de treino. Um nome com vírgula deve ser colocado entre aspas duplas; uma aspa dentro do campo deve ser duplicada.
Exportação da planilha
Salve o arquivo em UTF-8. São aceitos vírgula, ponto e vírgula e tabulação; todas as linhas devem ter o mesmo número de campos. Não adicione sinal de porcentagem, moeda ou a palavra «visualizações» dentro de uma célula numérica. As unidades são descritas na metodologia do relatório.
Uma célula vazia — valor desconhecido. Zero — ausência conhecida de ações. Não preencha toda a coluna com zeros só porque o serviço não a exportou. Para a análise de CSV aplica-se o limite de 500 KB e 1 000 linhas de dados; divida um relatório grande em períodos significativos, e não em trechos arbitrários.
Verificação após o carregamento
Confira o número de publicações e a quantidade de linhas com visualizações conhecidas. Veja a primeira e a última publicação no CSV de origem, e a média e a mediana — no relatório. Se o indicador parecer inesperado, volte às unidades, ao separador e à idade das publicações. O gráfico mostra as primeiras 30 linhas do período B, se ele tiver sido adicionado, caso contrário, do período A. Os indicadores resumidos são calculados sobre toda a amostra. A exportação contém esses totais; guarde as linhas originais das publicações separadamente.
O arquivo de origem permanece no navegador. Isso não é uma conexão direta com a conta do Telegram nem uma confirmação da autenticidade da planilha. Se os dados forem obtidos de estatísticas administrativas, guarde a data e a fonte de acesso separadamente. Remova dos exemplos públicos informações de clientes e links privados.
Se para este trabalho houver um anúncio público separado no Telegram, é possível verificar as condições vigentes de visualizações. O analisador trabalha com o seu CSV e não confirma a origem da atividade. A atividade comprada não confirma interesse orgânico, recomendações, solicitações ou vendas.