Mecanismo de ranqueamento por CTR

A maioria dos tube sites ordena os vídeos por data de envio ou contagem bruta de visualizações. Ambos recompensam a coisa errada: a recência favorece o que foi adicionado por último, e as visualizações favorecem o que está online há mais tempo. O plugin CTR Ranking substitui isso por um verdadeiro motor de engajamento, fazendo com que os vídeos que seus visitantes realmente clicam e assistem subam ao topo.

É um plugin opcional (versão 3) que acompanha o TubePress. Ative-o em /admin/plugins e configure-o em sua própria página em /admin/ctr.

O que é o ranking por CTR

CTR significa taxa de cliques — a parcela de pessoas que, tendo visto uma miniatura, optam por clicar nela. O ranking por CTR mede a atratividade e o engajamento em vez da idade. O plugin registra três sinais reais no cliente:

• Impressões — cada miniatura genuinamente rolada para a área de visualização (via um IntersectionObserver), ponderada por sua posição.
• Cliques — cada clique em um card de vídeo, categoria, performer ou canal.
• Conclusão de assistência — até onde o player chega de fato em um vídeo, nos marcos de 25%, 50%, 75% e 100%.

O motor V3

As pontuações são recalculadas em uma programação e combinam quatro multiplicadores:

ranking_score = quality x retention x freshness x fatigue

• Quality é uma taxa de cliques com correção de posição e superfície (COEC — cliques sobre cliques esperados). Os cliques esperados acumulam no momento da impressão a partir de um prior por contexto e por posição, portanto um card na primeira posição precisa superar a taxa média de cliques da primeira posição para subir. O viés de posição é cancelado matematicamente, em vez de estimado.
• Retention recompensa os vídeos que as pessoas terminam de assistir. Os dados de conclusão em 25/50/75/100% elevam o conteúdo que retém os espectadores e rebaixam o click-bait que abandona cedo.
• Freshness dá um impulso temporário aos uploads recentes (por padrão até aproximadamente 3x nas primeiras horas, retornando ao neutro dentro de duas semanas) para que bons conteúdos novos sejam descobertos.
• Fatigue descansa suavemente os vídeos que já foram exibidos com frequência na página inicial, mantendo a rotação variada.

O multiplicador de qualidade é limitado, e todos esses pesos são ajustáveis nas configurações avançadas, caso você queira enfatizar mais o tempo de assistência, a recência ou a taxa de cliques.

Ranking de entidades

O rastreamento de engajamento não se limita a vídeos. Cards de categoria, performer (pornstar) e canal também são rastreados, e os que os visitantes mais acessam aparecem primeiro nas listagens de Tendências. A pontuação de listagem de cada entidade é derivada do engajamento de seus vídeos publicados, e sua miniatura de exibição se torna o vídeo de melhor desempenho que ela contém — para que sua arte mais clicável faça o trabalho de levar os visitantes mais fundo no site.

Proteção antispam integrada

Como a pontuação decide o ranking, ela é protegida contra manipulação por padrão:

• Bots e navegadores headless são excluídos de todos os sinais.
• Cada clique, conclusão e clique em entidade conta no máximo uma vez por IP, por alvo, por hora (conclusões contam uma vez por quartil), para que um único visitante não possa votar em um vídeo.
• Somente vídeos reais e publicados são rastreados — rascunhos e IDs falsos são rejeitados.
• O multiplicador de qualidade é limitado, restringindo até onde qualquer vídeo pode ser empurrado.
• Cada beacon de rastreamento é assinado com HMAC usando um segredo do servidor e um token renovado diariamente, para que as requisições não possam ser forjadas.

O pool de rotação da página inicial

Para evitar que a página inicial pareça idêntica o dia todo, o plugin constrói um pool de rotação de 24 grupos extraídos dos seus vídeos mais bem classificados e bem testados. A página inicial avança por um grupo a cada 30 minutos, para que o topo do site pareça renovado ao longo do dia, ainda exibindo conteúdo de alto engajamento genuíno. Você pode desativar o pool se preferir um feed classificado estático.

Ativação e ajuste

Após ativar o plugin, abra /admin/ctr. A página exibe estatísticas em tempo real — vídeos classificados, impressões, cliques e conclusão média de assistência — e um botão Recalcular agora.

1. Escolha uma estratégia. Um clique em uma predefinição — Balanced, Fresh & Discovery, Most Watched ou Trending Now — define todos os pesos para você.
2. Ative as funcionalidades. Habilite o rastreamento de engajamento, a conclusão de assistência, o ranking de entidades, o pool de rotação e a filtragem de bots de forma independente.
3. Ajuste se desejar. O painel avançado expõe a frequência de recálculo, o limite de qualidade, o impulso de recência, o limite de retenção, a suavidade de fadiga e muito mais. Editar qualquer valor muda a estratégia para Personalizado.

O interruptor principal é ctr_enabled. Quando está desativado, todo o site volta ao ordenamento por contagem de visualizações e recência, para que você possa desabilitar o ranking instantaneamente sem desinstalar nada.

Projetado para escala

O motor é desenvolvido para catálogos com milhões de vídeos. O rastreamento é escrito como upserts em lote únicos; o recálculo é dividido em partes por intervalo de ID e só grava linhas cuja pontuação realmente mudou; e não há camada de cache para invalidar. As pontuações são reconstruídas em uma programação autônoma (configurável de 5 minutos a 12 horas) usando o pseudo-cron integrado, portanto não é necessário nenhum crontab no servidor. Tudo — o esquema do banco de dados, os endpoints de rastreamento, o job de recálculo, o roteamento de ordenação e a página de administração — é fornecido pelo plugin; nada é adicionado ao CMS base.

Próximos passos