Por que as visualizações do TikTok não podem mostrar uma curva de retenção

Escolha a decisão primeiro

Público significa que alguém pode abrir sem o seu login. Próprio significa que o vídeo está em uma conta que você controla. Nomeie a decisão antes de coletar linhas. As duas decisões abaixo precisam de dados diferentes.

Retenção é a parcela da fonte que ainda assiste em uma posição de tempo. A fonte informa essa parcela. A parcela pode contar espectadores ou sessões de visualização. Uma sessão de visualização é uma reprodução, como essa fonte a define. A base é o total pelo qual a fonte divide. Não use a contagem pública de visualizações como essa base privada.

Se a tela da sua conta não mostra posições de exibição, você não pode responder à segunda decisão. Não preencha a lacuna com visualizações públicas.

Leia só contadores públicos

A versão pública atual é 0.1.36. Ela aceita `mode`, `startUrls` e `maxItems` opcional. Ela também aceita `includeProfileMetrics`, `requestTimeoutSecs`, `maxConcurrency` e `failOnNoMetrics`. `mode` pode ser `auto`, `knownUrls` ou `profileUrls`. Escolha `knownUrls` para este método. `auto` não acrescenta uma curva. `profileUrls` começa pelos perfis. Essa rota não é um histórico completo de cada vídeo. Os ajustes de tempo e de concorrência não acrescentam métricas. `failOnNoMetrics` não cria posições de exibição.

`includeProfileMetrics` definido como true pede fatos públicos atuais do perfil. Esses fatos podem estar ausentes. Eles não são uma lista de seguidores. Eles não são análises privadas.

Uma linha do conjunto de dados é um vídeo tentado ou resolvido. Leia `status` e `statusReason` antes de usar a linha. Uma execução bem-sucedida ainda pode não ter métricas úteis. Não chame esse resultado de um zero útil.

Estes são os campos nativos da linha usados aqui.

Nenhum campo dessa lista é uma curva de retenção. A duração do vídeo não é um histórico de exibição. O contador de seguidores não é o conjunto de espectadores de um vídeo. Uma métrica ausente é null. Null significa ausente. Não é 0.

Um indicador de precisão diz quão firme é um número. `exact` significa um inteiro público exato. Esse inteiro ainda é o total da plataforma. Não é uma contagem de pessoas distintas, com cada pessoa contada uma vez. `display_rounded` significa que a tela mostrou um número arredondado. `likely_rounded` significa que o valor provavelmente está arredondado. `unavailable` significa que o valor não foi lido. Não mude `unavailable` para 0. O Actor não devolve taxas calculadas. Uma taxa que você calcula é a sua conta, não uma curva da fonte.

A verificação atual da fonte vale só para contadores públicos. Um controle de um vídeo com `knownUrls` correspondeu ao ID da publicação e ao ID do perfil. Ele devolveu visualizações, curtidas, comentários, compartilhamentos, salvamentos e republicações públicos. Ele devolveu a contagem pública de seguidores e os indicadores de precisão. Algumas contagens estavam `likely_rounded`. Salvamentos e republicações estavam `exact`. Isso sustenta os contadores públicos atuais e a identidade nessa fonte. A verificação não aceita retenção. Ela não aceita conclusão de visualização, alcance privado, cliques, vendas, verificações de fraude nem espectadores únicos. Ela não aceita todos os perfis. Ela não aceita uma curva privada. Não há curva privada neste Actor para aceitar.

Confira estes totais de saída

Inspecione a saída da execução antes de guardar uma linha. Leia `providedUrls`, `contentUrls`, `inputUrls`, `resolvedUrls`, `metricRows`, `noPublicMetricRows`, `blockedRows`, `failedRows` e `statusCounts`. Compare os totais de URL entre si. Não suponha que cada URL fornecida virou uma linha de métrica útil. Use `metricRows` para linhas que devolveram métricas públicas. Use `noPublicMetricRows` para linhas sem métricas públicas. Essas linhas não são zeros. Use `blockedRows` e `failedRows` antes de confiar no conjunto. Use `statusCounts` para ver as linhas por status. Se um total está ausente, deixe-o desconhecido. Não escreva 0, a menos que a saída mostre 0.

Este artigo não inventa esses totais para o controle. O controle só sustenta os contadores públicos nomeados acima. Leia os totais na sua própria execução.

Mude a Task para um vídeo

A Task pública é TikTok Profile Analytics. Ela foi verificada em 13 de outubro de 2026. O nome significa métricas públicas de vídeo. Ele não significa uma curva de retenção. A entrada salva é um começo. Ela não é prova de que a análise ocorre sozinha.

A entrada salva está abaixo. Os três perfis são amostras. Eles não são o seu relatório.

{
  "mode": "profileUrls",
  "startUrls": ["@mrbeast", "@nike", "@playstation"],
  "maxItems": 60,
  "includeProfileMetrics": true
}

Mude para este método. Use uma URL pública de vídeo que você já conhece. Defina `maxItems` como 1.

{
  "mode": "knownUrls",
  "startUrls": ["YOUR_ONE_PUBLIC_VIDEO_URL"],
  "maxItems": 1
}

Substitua `YOUR_ONE_PUBLIC_VIDEO_URL` por essa URL de um vídeo. Não deixe uma URL de perfil em `startUrls`. Não mantenha `maxItems` em 60 nesta verificação. Você pode definir `includeProfileMetrics` como true para fatos públicos do perfil. Esse indicador ainda não acrescenta uma curva.

Sete ações

1. Declare a decisão em uma frase. Ou você precisa do momento em que um vídeo próprio perde espectadores, ou você precisa saber qual vídeo público tem mais visualizações. Não colete dados antes de escolher. A retenção usa a parcela da fonte em cada posição de tempo. A base é o total da fonte, não o contador público de visualizações. A tabela acima é a divisão. Um total de visualizações responde só a uma comparação pública.
2. Faça o inventário de um vídeo público conhecido. Confira a identidade da publicação, a duração, as visualizações, o status, o momento da leitura e a precisão. Use `knownUrls`, um vídeo e `maxItems` 1. Essa é a rota dos contadores públicos. Não existe campo de curva privada neste Actor. Se uma métrica está ausente, mantenha-a ausente. Não grave 0 no lugar dela. Se o status diz que a linha não é útil, deixe as métricas fora do relatório.
3. Pergunte se a fonte mostra uma série de retenção por tempo. Uma contagem de visualizações não pode restaurar essa série. Curtidas, comentários, compartilhamentos, salvamentos e republicações não podem restaurá-la. A duração do vídeo não pode restaurá-la. Um tempo médio de exibição não pode restaurá-la. Muitas curvas podem compartilhar uma mesma média. Uma leitura pública posterior pode mostrar uma contagem de visualizações maior. A diferença é atividade nova do contador. Ela não é um mapa dos segundos assistidos. Não divida visualizações por segundos para desenhar uma linha.
4. Se o vídeo é seu, use as ferramentas da sua conta do TikTok. O TikTok Studio documenta essas ferramentas. Ferramentas de criador documenta as ferramentas de criador e o desempenho da publicação. As páginas sustentam análises de uma publicação individual. Elas não prometem uma curva de retenção em toda conta. Elas não prometem um arquivo de exportação em toda conta. Abra a sua publicação e leia os rótulos que realmente estão lá. Se um rótulo está ausente, escreva unavailable. Nunca dê a este Actor público a sua senha nem uma sessão com login.
5. Mantenha a definição da fonte ao lado de cada número. Mantenha também o ID do vídeo, a janela de datas, a coorte e as posições de tempo quando elas aparecem. Uma coorte é o grupo por trás da parcela. Compare a mesma janela e a mesma definição. Se você só tem uma média, informe a média sob essa definição. Não transforme a média em uma curva. Se você só tem uma captura de tela, marque os valores lidos como aproximados. Rótulos arredondados podem ocultar o valor exato.
6. Use este passo só quando uma curva real de posição estiver na sua tela. Assista ao vídeo original em torno da queda. Escreva um possível motivo de conteúdo. Escreva uma mudança para testar em um vídeo posterior. A nota é uma possibilidade, não prova de que as pessoas saíram por esse motivo. Espectadores que repetem podem mudar os números. Um loop é uma reprodução extra do mesmo vídeo. Loops podem mudar os números. As regras da fonte podem incluir ou excluir essas reproduções. Se o rótulo não diz, essa regra é desconhecida. Não coloque um total público de visualizações sob uma parcela privada de retenção.
7. Se os dados de posição de exibição ainda estão indisponíveis, diga isso no relatório. Depois responda só a comparação pública que você pode sustentar. Reduza a decisão às visualizações públicas observadas. Mantenha um plano de coleta antes de mudar o vídeo. Não mude a abertura só porque você adivinhou uma curva. O plano nomeia a tela, o campo, o vídeo e a data em que você vai lê-los. O cálculo com dados da conta própria só é permitido quando essas posições de exibição estão de fato mostradas.

Uma curva real precisa de cinco partes. Você precisa do ID do vídeo. Você precisa da janela de datas. Você precisa da coorte. Você precisa de cada posição de tempo. Você precisa da parcela da fonte que ainda assiste nessa posição. Se uma parte falta, você não tem uma curva.

Visualizações iguais podem esconder duas curvas

Os históricos a seguir são ficção. Eles não são um resultado do Actor. Eles não são uma medição do TikTok. Eles não são uma referência de comparação.

Dois vídeos fictícios têm 30 segundos cada um. Cada um mostra 1.000 visualizações públicas. Os totais coincidem. Os históricos de exibição não vistos não precisam coincidir. Cada cenário usa uma coorte inventada de 100 sessões. O cabeçalho do Cenário A é 100 no total. O cabeçalho do Cenário B é 100 no total. O Cenário A não é 90 no total. O Cenário B não é 50 no total.

A porcentagem é o número de sessões que ainda assistem dividido pelo total da coorte de 100. No Cenário A, aos 5 segundos, 90 dividido por 100 é igual a 90 por cento. Aos 15 segundos, 80 dividido por 100 é igual a 80 por cento. Aos 30 segundos, 70 dividido por 100 é igual a 70 por cento. No Cenário B, aos 5 segundos, 50 dividido por 100 é igual a 50 por cento. Aos 15 segundos, 20 dividido por 100 é igual a 20 por cento. Aos 30 segundos, 10 dividido por 100 é igual a 10 por cento.

Nenhuma linha é calculada a partir das 1.000 visualizações públicas. As mesmas 1.000 visualizações podem estar na curva alta ou na curva baixa. Dividir visualizações por 30 segundos não constrói nenhuma das tabelas. Não informe essa divisão como retenção. Estas porcentagens usam a base inventada de 100. Elas não são uma definição do TikTok. Elas não são uma curva medida. Totais públicos iguais não mostram posições assistidas.

Porcentagens da conta própria precisam da própria base

Este segundo exemplo também é ficção. É uma captura de tela inventada. Não é um resultado de produto. Não é prova de que a sua conta tem uma exportação. Use a conta só se a sua própria tela mostrar posições de exibição.

Os valores são aproximados porque uma captura de tela pode mostrar rótulos arredondados. 48 menos 62 é igual a -14. A mudança é de -14 pontos percentuais. Um ponto percentual é um passo em uma escala de porcentagem. A parcela cai 14 pontos percentuais. Isso não é uma queda relativa de 14 por cento.

Uma queda relativa compara a queda com a parcela inicial. A queda é de 14 pontos percentuais. O início é 62 por cento. 14 dividido por 62 é igual a cerca de 0,226. Isso é 22,6 por cento da parcela inicial. Informe -14 pontos percentuais, ou uma queda relativa de 22,6 por cento. Diga qual número você quer dizer.

Isso não significa que 14 por cento de todos os espectadores públicos saíram. Não nomeia uma causa. A base é a coorte fictícia da fonte. Não são as 1.000 visualizações públicas. Não é a coorte inventada de 100 sessões. Não misture essas bases. Se a sua tela não tem valores de posição de exibição, não use esta conta.