
Um Actor é um programa de coleta de dados executado em uma plataforma de hospedagem. Uma tarefa é uma configuração de entrada salva. Para uma verificação direta inicial de vídeo com a ferramenta YouTube Metrics build 1.1.2, substitua toda a lista padrão de 3 vídeos de exemplo em `startUrls` pela única URL conhecida do vídeo que você pretende verificar e defina `maxItems` como 1. Não use um canal inteiro como entrada, pois isso implica indevidamente que todo o histórico de vídeos publicados está disponível.
Os campos nativos de saída incluem `inputUrl`, `postId`, `postUrl`, `postType`, `isShort`, `publishedAt`, `channelId`, `channelUrl`, `views`, `postMetricStatus`, `status` e `scrapedAt`. O campo `postMetricStatus` é um array nativo de objetos com as propriedades `metric`, `value`, `status` e `precision`, em vez de um mapa de objetos; a disponibilidade continua sendo distinta da precisão, e um valor ausente continua sendo desconhecido, em vez de 0.
Os resumos de coleta de `OUTPUT` incluem `providedUrls`, `videoUrls`, `inputUrls`, `resolvedUrls`, `metricRows`, `datasetRows`, `noPublicMetricRows`, `blockedRows`, `failedRows` e `statusCounts`. A execução de controle efetivamente verificada, com 2 entradas conhecidas, retornou 2 `resolvedUrls`, 2 `metricRows`, 2 `datasetRows` e `statusCounts` como `{"ok": 2}`, com 0 em `blockedRows`, `failedRows` e `noPublicMetricRows`. Isso comprova a extração de metadados públicos e contagens atuais para essas entradas. Não garante que toda verificação retorne 2 linhas, nem comprova acesso a análises privadas do Studio, espectadores únicos, duração de visualização, sobreposição de público ou contagens históricas de vídeos com o mesmo tempo desde a publicação. Além disso, um vídeo mais antigo acessado por uma rota `/shorts/` pode, na verdade, ser um vídeo padrão de formato longo; o nome da rota ou um indicador nativo não revisado não confirma o formato real do conteúdo.
Defina sua população de referência
- Defina a população de referência antes de coletar números: declare o grupo exato de vídeos que pretende comparar antes de reunir métricas de desempenho, para evitar viés de seleção.
- Selecione uma unidade de análise e um resultado claros: mantenha as visualizações acumuladas de cada vídeo separadas dos totais do canal. Registros públicos de um dado momento não mostram impressões privadas, tempo de exibição ou fontes de tráfego. Escolha uma pergunta restrita e observável, como comparar um tipo específico de vídeo dentro de uma faixa definida de tempo desde a publicação.
- Declare os fatores de pareamento e as regras de inclusão com antecedência: registre as regras de gênero, formato de vídeo verificado manualmente, faixa de tempo desde a publicação, limite de observação e estágio declarado do canal antes de examinar as contagens. O número de inscritos e a data de criação do canal não comprovam que os criadores têm experiência comparável.
- Reúna candidatos com evidências públicas verificadas: monte uma lista de candidatos usando URLs diretas conhecidas. Uma declaração pública datada sobre o início de uma série sustenta um fator `claimed_stage`, e não uma experiência verificada. Se faltar evidência de um fator obrigatório, marque o candidato como `unresolved_factor_evidence`, em vez de atribuir uma categoria a ele.
- Colete observações nativas e preserve a precisão: preserve `postId`, `channelId`, data de publicação, horário da observação, contagem de visualizações e status de precisão. Se `publishedAt` contiver apenas uma indicação do dia, não a converta em uma data e hora exatas. Uma contagem acumulada atual não permite recuperar as visualizações históricas do 7º dia.
- Monte uma tabela de pareamento e de evidências de suporte: avalie os candidatos em relação ao seu vídeo em análise. Registre os estados como `eligible`, `excluded_factor_mismatch` ou `unresolved_factor_evidence`, indicando explicitamente qualquer fator não atendido. Não flexibilize as regras de pareamento depois de ver as contagens de visualizações dos candidatos sem registrar um novo desenho de comparação e sua justificativa.
- Decida quando fazer a comparação: determine se a comparação pode ocorrer imediatamente, dentro de uma faixa aproximada de tempo desde a publicação ou após uma coleta futura agendada. Não preencha lacunas nas visualizações históricas do 7º dia dividindo o total de visualizações pelo tempo total desde a publicação. Se não houver uma célula com pareamento, informe um resultado sem comparação.
- Apresente as células de comparação com e sem suporte: apresente a população de referência definida, as regras, as evidências e as células que têm suporte. Alguns vídeos semelhantes selecionados formam uma referência de escopo restrito, e não um parâmetro de desempenho normal do setor. Não aplique fórmulas de mediana ou de valores atípicos, não prepare mídia kits para patrocinadores e não preveja taxas de sucesso de canais.
Os registros de pareamento e as tabelas a seguir são ficção original criada para demonstrar o processo de avaliação. Para os candidatos cujos valores de `publishedAt` contêm apenas a data (Vídeo em análise F1, Candidato B, Candidato C e Candidato D), os tempos exatos desde a publicação vêm de datas e horas fictícias exatas assumidas para este exemplo didático, e não da conversão de indicações nativas que contêm apenas o dia em horas verificadas. Segundo a documentação oficial do YouTube, as regras de contagem de visualizações no início da reprodução para todos os formatos entraram em vigor em 24 de agosto de 2026; leve esse marco de versão em conta ao comparar visualizações.
Tabela de comparação principal (Vídeo em análise F1)
| Candidato | Gênero / Tema | Formato verificado manualmente | Datas e horários de publicação e observação | Tempo assumido desde a publicação | Evidência datada do estágio declarado | Situação segundo as regras | Motivo |
|---|---|---|---|---|---|---|---|
| Vídeo em análise F1 | Jogo de mistério | Formato longo | Pub.: 2026-10-01<br>Obs.: 2026-10-08 | 7 dias | Publicação em 2026-10-01: "Começando minha primeira série de mistério" | Alvo | Unidade em análise na comparação |
| Candidato B | Jogo de mistério | Formato longo | Pub.: 2026-10-02<br>Obs.: 2026-10-09 | 7 dias | Publicação em 2026-10-02: "Episódio 1 do meu novo canal de mistério" | Elegível | Atende a todas as regras declaradas (`claimed_stage`) |
| Candidato C | Jogo de mistério | Formato longo | Pub.: 2024-10-08<br>Obs.: 2026-10-08 | 730 dias | Biografia do perfil: "Fazendo vídeos de jogos desde 2024" | Excluído | Não atende ao pareamento de tempo desde a publicação (730 dias contra 7 dias) |
| Candidato D | Jogo de mistério | Short | Pub.: 2026-10-01<br>Obs.: 2026-10-08 | 7 dias | Publicação em 2026-10-01: "Short de lançamento do novo canal" | Excluído | Não atende ao pareamento de formato (Short contra formato longo) |
| Candidato E | Jogo de mistério | Formato longo | Pub.: 2026-10-08T01:00Z<br>Obs.: 2026-10-08T13:00Z | 12 horas | Introdução do vídeo: "Bem-vindos ao meu canal novinho em folha" | Excluído | Não atende ao pareamento de tempo desde a publicação (12 horas contra 7 dias) |
| Candidato F | Jogo de mistério | Formato longo | Pub.: Apenas indicação da data<br>Obs.: 2026-10-08 | Desconhecido | Nenhuma declaração pública sobre o estágio encontrada | Sem resolução | Faltam o horário preciso de publicação e evidências do estágio |
Registros de comparação secundária
- Formato em análise F2 (Short de jogo de mistério na faixa de 14 dias desde a publicação): avaliado segundo regras próprias e distintas para essa célula, que exigem um vídeo de jogo de mistério no formato Short no marco de 14 dias desde a publicação. O Candidato D atende aos critérios de formato, gênero e estágio, mas não ao marco de tempo de F2 (7 dias contra os 14 dias exigidos). Os Candidatos B, C, E e F não atendem aos parâmetros de formato ou de tempo desde a publicação. Resultado: não existe candidato de referência elegível no conjunto fornecido; a célula é apresentada como sem comparação (sem parâmetro de referência sustentado por evidências).
- Registro de coleta planejada: o Candidato E tem uma observação futura agendada para 2026-10-15T01:00Z, para atender à regra de 7 dias desde a publicação de F1. Status: `planned_capture` (mantido estritamente separado de `observed_reference`; as visualizações passadas do 7º dia não podem ser reconstruídas retroativamente).
Fontes e leituras adicionais
Por Chronometrica · Atualizado
Voltar ao topo ↑
