
Este guia se destina a criadores ou analistas que já têm uma lista pequena de vídeos públicos semelhantes. O objetivo é criar uma tabela que vincule cada contagem à sua fonte e mostre quais registros atendem a uma regra de comparação definida.
Este é um guia da Chronometrica. Ele usa contratos públicos dos produtos verificados em 20 de outubro de 2026. O exemplo de entrada abaixo passou por uma validação de esquema, que verifica a estrutura da entrada. Ele não foi executado. Os números usados nos cálculos são fictícios.
Escolha o contrato de coleta de que seu relatório precisa
Um Actor é um programa de coleta de dados hospedado. Seu contrato de saída descreve os dados que ele retorna e como interpretá-los. Em um relatório de comparação, esse contrato importa porque um número sozinho pode não indicar se você pode usá-lo.
Suponha que seu relatório aceite apenas contagens públicas integrais para calcular a proporção entre curtidas e visualizações. Você precisa saber se cada contagem necessária estava disponível. Também precisa saber se a fonte mostrou um número integral ou um valor arredondado. Um valor de 100.000 e uma exibição de 100K podem exigir tratamentos diferentes segundo essa regra. A contagem de visualizações também deve ser maior que 0 para que você possa usá-la em uma proporção.
| Critério de decisão | Chronometrica YouTube Metrics Scraper | Streamers YouTube Scraper |
|---|---|---|
| Principal aplicação indicada pela documentação verificada | Relatórios que exigem informações explícitas sobre a disponibilidade das métricas e a precisão das contagens | Coleta mais ampla com filtros de busca, playlists, legendas ou ferramentas opcionais de IA |
| Saída documentada relevante | Contagens públicas com estruturas de status das métricas | Contagens públicas de vídeos e canais |
| Responsabilidade do leitor | Aplicar a regra de elegibilidade do relatório a cada métrica | Definir verificações equivalentes de disponibilidade para o relatório |
Esses são usos adequados com base na documentação, não resultados de uma execução comparativa. Consulte a documentação da Chronometrica e a documentação da Streamers.
A Chronometrica documenta uma estrutura de saída com 1 registro por linha e campos para a publicação, suas contagens e o horário da coleta. Os campos relevantes incluem `inputUrl`, `postUrl`, `postId`, `title`, `publishedAt`, `views`, `likes`, `comments`, `channelSubscribersCount` e `scrapedAt`. As estruturas `postMetricStatus` e `channelMetricStatus` descrevem a disponibilidade e a precisão das métricas. Contagens ausentes permanecem ausentes. Esse contrato explícito é o motivo para escolhê-la em um relatório com regras rigorosas para contagens. Contrato de saída da Chronometrica
A Streamers documenta URLs diretas, busca por palavras-chave e limites de resultados separados para vídeos comuns, Shorts e transmissões. Esses controles podem atender a um trabalho de coleta mais amplo. Esquema de entrada da Streamers
Portanto, a principal condição para mudar de opção é prática: escolha o coletor cuja saída e cujos modos de coleta documentados atendam ao trabalho completo. Este guia não demonstra que uma contagem do concorrente esteja errada ou que ele não forneça nenhuma informação sobre a qualidade dos dados.
Verifique a disponibilidade e a precisão antes de calcular
A disponibilidade informa se uma métrica está presente. A Chronometrica documenta estados como `present`, `unavailable` e `not_attempted`. Uma contagem indisponível e uma contagem cuja coleta não foi tentada são casos diferentes. Preserve essa diferença ao revisar os resultados. Contrato de status das métricas da Chronometrica
A precisão descreve o nível de detalhe com que a fonte pública apresentou a contagem. Os indicadores documentados incluem `exact`, `display_rounded` e `likely_rounded`. Uma exibição arredondada fornece menos detalhes que uma contagem integral. Preserve esse indicador ao lado do valor para que um cálculo posterior não oculte o limite da fonte. Contrato de precisão da Chronometrica
Aqui, “exata” se refere à contagem pública conforme exibida. Isso não certifica os registros internos da plataforma. Também não transforma visualizações públicas em pessoas únicas, tempo de exibição, retenção ou vendas.
Seu relatório precisa de uma regra antes de precisar de uma fórmula. Por exemplo: “Inclua um vídeo no cálculo da proporção com contagens exatas somente quando as curtidas públicas estiverem presentes e forem exatas, e as visualizações públicas estiverem presentes, forem exatas e forem maiores que 0.” Presente significa que o valor não está ausente nem é `null`. Um registro que atende a essa regra é elegível. Um registro que não atende a ela ainda pode permanecer na tabela de origem com um motivo claro.
0 é um valor conhecido, mas a divisão por 0 é indefinida. Mantenha um registro com 0 visualizações na tabela de origem e exclua-o da cobertura do cálculo da proporção. Não informe sua proporção como 0.
Mantenha juntos o valor da fonte, a disponibilidade e a precisão. Se você copiar apenas o número para outra planilha, o próximo leitor poderá usá-lo sem saber que a fonte apresentou um valor arredondado.
Um exemplo fictício: 3 vídeos, 1 proporção elegível
Os 3 registros desta seção são dados fictícios de um leitor. Eles não são saídas de uma execução atual, de um teste de produto ou de um relatório de cliente.
O leitor quer uma proporção entre curtidas e visualizações públicas com contagens exatas. Essa proporção expressa as curtidas a cada 100 visualizações públicas. As curtidas são o numerador, o número acima da linha de divisão. As visualizações são o denominador, o número abaixo dela. A multiplicação por 100 produz uma porcentagem:
`public like-to-view ratio = public likes / public views × 100`
Para que a proporção seja elegível, as curtidas devem estar presentes e ser exatas. As visualizações devem estar presentes, ser exatas e ser maiores que 0.
O Vídeo A tem 100.000 visualizações públicas exatas e 2.000 curtidas públicas exatas. As 2 contagens atendem à regra, e a contagem de visualizações é maior que 0:
`2,000 / 100,000 × 100 = 2.00%`
O Vídeo A é elegível para a comparação com contagens exatas. Seu resultado descreve a relação entre 2 contagens públicas. Ele não mostra qual parcela dos espectadores únicos curtiu o vídeo.
O Vídeo B exibe o valor de visualizações como 100K e tem 2.100 curtidas públicas exatas. Usar 100.000 no cálculo daria cerca de 2,10%. Mas o valor de entrada das visualizações é arredondado. Segundo a regra declarada, o Vídeo B é excluído do conjunto de contagens exatas e da cobertura do cálculo da proporção. O leitor poderia manter a estimativa em um grupo separado, com o valor de entrada arredondado claramente identificado. Essa estimativa não atende à regra de elegibilidade da proporção.
O Vídeo C tem 300 curtidas públicas e nenhuma contagem pública de visualizações disponível. Sua proporção é desconhecida. O leitor não deve substituir a contagem ausente de visualizações por 0. 0 é um valor; a ausência significa que o valor necessário é desconhecido. Uma contagem conhecida de 0 visualizações também impediria a divisão, mas por outro motivo: a divisão por 0 é indefinida.
1 dos 3 vídeos fornecidos atende à regra de contagens exatas, incluindo a exigência de visualizações maiores que 0:
`1 / 3 × 100 = 33.33% eligible coverage`
A cobertura elegível é a parcela dos registros fornecidos que atende à regra do relatório. Ela não é uma taxa de sucesso do coletor. O Vídeo B é excluído porque suas visualizações são arredondadas. O Vídeo C é excluído porque suas visualizações estão ausentes. Esses motivos devem ficar ao lado dos registros. Qualquer linha com 0 visualizações também seria excluída da cobertura do cálculo da proporção, com seu próprio motivo.
Este exemplo permite calcular 1 proporção exata. Ele não permite criar uma classificação precisa de desempenho entre A e B. Para ampliar a comparação elegível, o leitor precisa de contagens exatas adequadas, incluindo uma contagem de visualizações maior que 0. Estimativas claramente identificadas podem permanecer separadas. A mesma regra de elegibilidade deve ser aplicada a todos os registros.
Use um método de comparação de escopo limitado que possa ser repetido
1. Defina a pergunta e a lista fornecida
Anote o que você quer comparar antes da coleta. “Quais vídeos fornecidos têm a maior proporção entre curtidas e visualizações públicas?” é uma pergunta que esse método pode responder. “Qual miniatura fez mais pessoas assistirem?” exige outras evidências.
Mantenha o tema, o formato, o tempo desde a publicação do vídeo e o horário de observação tão semelhantes quanto a pergunta exigir. Não adicione nem remova vídeos depois de ver as proporções sem explicar a mudança. Para ajudar a escolher a lista, use o guia de definição de um painel de referência do YouTube. Esta comparação começa depois da escolha dessa lista.
2. Identifique as contagens necessárias e a regra
Liste cada contagem necessária para o cálculo. Uma proporção entre curtidas e visualizações públicas precisa de curtidas e visualizações. Uma comparação dos totais de visualizações públicas precisa de visualizações. As contagens de inscritos do canal podem fornecer contexto, mas não entram automaticamente em nenhuma das fórmulas.
Defina o numerador, o denominador e a unidade antes de calcular. Depois, descreva a regra de elegibilidade em linguagem simples. Para a proporção com contagens exatas, exija curtidas presentes e exatas e uma contagem de visualizações presente, exata e maior que 0. Exclua da cobertura do cálculo da proporção os registros com valores ausentes, arredondados ou com 0 visualizações.
Se as estimativas forem úteis, mantenha-as separadas dos resultados elegíveis de proporção. Um total conhecido de 0 visualizações pode permanecer em uma comparação de contagens, mas não pode servir como denominador de uma proporção. Defina essas regras antes de ver quais registros se qualificam.
3. Colete uma lista pequena e conhecida
Comece com URLs de vídeos fornecidas para poder comparar a lista solicitada com os registros retornados. Preserve a identificação da publicação e o horário da coleta. Na saída da Chronometrica, `postId` e `postUrl` ajudam a identificar o vídeo, enquanto `scrapedAt` registra o horário da coleta. Campos de saída da Chronometrica
Uma lista conhecida também fornece um total inicial claro para calcular a cobertura. Mantenha essa lista original disponível durante a revisão. Não deixe que o conjunto de linhas retornadas passe a definir, sem explicação, o que você pretendia coletar.
4. Consulte os 3 locais de resultados
A Chronometrica envia apenas linhas `ok` para o conjunto de dados pago padrão. Um conjunto de dados é uma coleção armazenada de registros. Os outros resultados vão para o conjunto separado Unbilled results, com os mesmos campos de linha. `OUTPUT` informa `datasetRows`, `unbilledRows`, contagens por status e cobertura das métricas. Contrato de resultados da Chronometrica
Consulte os 3 locais. Mantenha as entradas não resolvidas separadas dos registros resolvidos que não têm uma métrica necessária. Uma execução de processamento bem-sucedida não significa que cada entrada produziu um registro elegível. Uma linha `ok` também não significa que todas as métricas solicitadas estejam presentes ou sejam exatas. Confira os campos de status das métricas e os valores necessários de acordo com a regra do seu relatório.
5. Aplique a regra a cada métrica necessária
Para cada registro resolvido, verifique cada contagem usada pela fórmula. Confirme primeiro a disponibilidade. Depois, verifique a precisão. Para uma proporção, confirme também que a contagem exata de visualizações é maior que 0. Uma contagem integral de curtidas não torna elegível uma contagem de visualizações arredondada, ausente ou igual a 0.
Mantenha separados os resultados elegíveis com contagens exatas, as estimativas arredondadas e os resultados desconhecidos. Marque uma proporção com 0 visualizações como indefinida e exclua-a da cobertura do cálculo da proporção. Não a coloque no grupo de visualizações desconhecidas, pois sua contagem de visualizações é conhecida.
Adicione um motivo breve quando excluir um registro. “Visualizações arredondadas”, “visualizações indisponíveis” e “0 visualizações; proporção indefinida” descrevem limites diferentes. Preserve as informações originais de status para que um revisor possa verificar sua decisão mais tarde sem repetir a coleta.
6. Informe a cobertura em relação à lista fornecida
Conte os registros que atendem à regra completa. Para essa proporção, isso significa curtidas exatas e presentes e visualizações exatas, presentes e maiores que 0. Divida a quantidade de registros elegíveis pela quantidade de registros da lista original fornecida e depois multiplique por 100. Informe a fração e a porcentagem.
As linhas com 0 visualizações permanecem no total da lista original fornecida, mas não entram na contagem de registros elegíveis. Trate da mesma forma as linhas com visualizações ausentes e arredondadas no cálculo da cobertura, mas mantenha separados os motivos de exclusão.
Esta etapa mostra quanto da comparação pretendida permanece. Um relatório baseado em 1 vídeo elegível de uma lista maior tem um escopo diferente de um relatório em que todos os vídeos fornecidos se qualificam. Explique as exclusões ao lado do resultado. Não classifique essa cobertura como exatidão da coleta, confiabilidade do produto ou taxa de sucesso.
7. Calcule e descreva apenas a medida declarada
Use a mesma fórmula e a mesma regra de elegibilidade para todos os registros incluídos. Calcule as proporções elegíveis somente depois de confirmar que a contagem de visualizações é exata, está presente e é maior que 0. Preserve os links das fontes ao lado dos resultados. Mantenha cada estimativa visivelmente separada para que a ordenação de uma tabela não a coloque entre os resultados elegíveis com contagens exatas sem explicação.
Uma diferença ou proporção entre contagens públicas pode descrever os registros observados. Sozinha, ela não pode explicar por que um vídeo recebeu mais atenção. Títulos, miniaturas, momento da publicação, tamanho do canal e outras diferenças ainda podem importar. Um tema semelhante não elimina todas essas diferenças nem cria um experimento de causa e efeito.
8. Verifique os resultados importantes na fonte
Abra a página pública da fonte quando um resultado for influenciar uma decisão. Verifique a identidade do vídeo, a exibição da contagem e o horário da observação. As contagens públicas podem mudar, por isso uma consulta posterior à página pode mostrar valores diferentes dos registrados.
Use seus próprios dados do YouTube Studio quando a pergunta exigir medidas privadas, como retenção ou tempo de exibição. Identifique essas medidas com clareza se você as usar ao lado de contagens públicas de canais semelhantes. Não apresente uma proporção pública como substituta de uma medida privada que você não consegue observar no outro canal.
Facilite a inspeção da primeira coleta
A Task pública YouTube Video Performance Tracker oferece um ponto de partida. Uma Task é uma configuração predefinida de entrada salva.
A entrada a seguir foi verificada de acordo com o esquema público atual. Ela não foi executada. A URL é um exemplo do esquema, não um resultado real de métrica que tenha sido verificado. Substitua-a por 1 vídeo público relevante para a comparação:
{
"startUrls": [
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
],
"maxItems": 1
}Os campos acima correspondem ao esquema de entrada da Chronometrica. `maxItems` é um limite geral para as linhas salvas. Ele não comprova a cobertura completa da fonte. Uma única entrada com URL direta de vídeo mantém essa primeira verificação concentrada no registro que você forneceu.
Antes de ampliar a lista, confirme que você consegue encontrar a identidade do vídeo, o horário da coleta, a contagem necessária e suas informações de status. Depois, verifique onde o registro aparece e leia o resumo da execução. Para uma proporção, confirme que a contagem exata de visualizações está presente e é maior que 0. Essa pequena verificação mostra como criar sua tabela de comparação sem presumir que uma linha retornada esteja pronta para qualquer cálculo.
Fontes e leituras adicionais
- Chronometrica YouTube Metrics Scraper: campos de saída, status das métricas e tratamento dos resultados
- Esquema de entrada da Chronometrica
- Task YouTube Video Performance Tracker
- Streamers YouTube Scraper: recursos de coleta e saída documentados
- Esquema de entrada da Streamers
- Pergunta de um leitor sobre a comparação de criadores semelhantes no YouTube
Por Chronometrica · Atualizado
Voltar ao topo ↑