
Un Actor es un programa alojado que recoge filas de origen. Una Task es un ajuste de entrada guardado para un Actor. El TikTok Metrics Actor recoge filas públicas. Usted hace la comprobación de este artículo. El Actor no construye una curva.
Hay personas que preguntan qué herramientas de analítica de TikTok usar en esta conversación. Esa pregunta muestra la necesidad de elegir una fuente de datos. No muestra que las vistas públicas contengan posiciones de visionado. No mide cuántas personas necesitan esto.
Elija primero la decisión
Público significa que alguien puede abrirlo sin su inicio de sesión. Propio significa que el video está en una cuenta que usted controla. Nombre la decisión antes de recoger filas. Las dos decisiones de abajo necesitan datos distintos.
| Decisión | Datos que pueden responderla | Conteo público de vistas |
|---|---|---|
| Qué video público tiene más vistas observadas | Conteo de vistas, ID del video, hora de lectura e indicador de precisión | Úselo cuando la fila sea útil |
| En qué momento su video pierde espectadores | Proporciones de posición de visionado que la pantalla de su cuenta muestra de verdad | No puede responderla |
La retención es la proporción de la fuente que sigue mirando en una posición de tiempo. La fuente indica esa proporción. La proporción puede contar espectadores o sesiones de visionado. Una sesión de visionado es una reproducción, según la define esa fuente. La base es el total por el que divide la fuente. No use el conteo público de vistas como esa base privada.
Si la pantalla de su cuenta no muestra posiciones de visionado, usted no puede responder la segunda decisión. No cubra ese vacío con vistas públicas.
Lea solo contadores públicos
La compilación pública actual es 0.1.36. Acepta `mode`, `startUrls` y `maxItems` opcional. También acepta `includeProfileMetrics`, `requestTimeoutSecs`, `maxConcurrency` y `failOnNoMetrics`. `mode` puede ser `auto`, `knownUrls` o `profileUrls`. Elija `knownUrls` para este método. `auto` no agrega una curva. `profileUrls` parte de perfiles. Esa ruta no es un historial completo de cada video. Los ajustes de tiempo y de concurrencia no agregan métricas. `failOnNoMetrics` no crea posiciones de visionado.
`includeProfileMetrics` en true pide datos públicos actuales del perfil. Esos datos pueden faltar. No son una lista de seguidores. No son analítica privada.
Cada fila del conjunto de datos es un video que la ejecución intentó recuperar o que ya resolvió. Lea `status` y `statusReason` antes de usar la fila. Una ejecución correcta puede igual no traer métricas útiles. No llame a ese resultado un cero útil.
Estos son los campos nativos de la fila que se usan aquí.
| Campo | Significado simple |
|---|---|
| `inputUrl` | URL que usted envió |
| `postUrl` | URL pública del video con la que coincidió la ejecución |
| `postId` | ID público del video |
| `profileId` | ID público del perfil |
| `profileHandle` | Nombre público del perfil |
| `profileUrl` | URL pública del perfil |
| `publishedAt` | Hora pública de publicación |
| `videoDurationSeconds` | Duración del video en segundos |
| `views` | Contador público de vistas |
| `likes` | Contador público de me gusta |
| `comments` | Contador público de comentarios |
| `shares` | Contador público de compartidos |
| `saves` | Contador público de guardados |
| `reposts` | Contador público de republicaciones |
| `profileFollowersCount` | Contador público de seguidores |
| `postMetricStatus` | Resultado de la lectura de métricas de la publicación |
| `profileMetricStatus` | Resultado de la lectura de métricas del perfil |
| `scrapedAt` | Hora de esta lectura |
Ningún campo de esa lista es una curva de retención. La duración del video no es un historial de visionado. El contador de seguidores no son los espectadores de un video. Una métrica ausente es null. Null significa ausente. No es 0.
Un indicador de precisión dice qué tan firme es un número. `exact` significa un entero público exacto. Ese entero sigue siendo el total de la plataforma. No es un conteo de personas distintas. `display_rounded` significa que la pantalla mostró un número redondeado. `likely_rounded` significa que el valor probablemente está redondeado. `unavailable` significa que el valor no se leyó. No cambie `unavailable` a 0. El Actor no devuelve tasas calculadas. Una tasa que usted calcula es su matemática, no una curva de la fuente.
La comprobación actual de la fuente es solo para contadores públicos. Un control de un video con `knownUrls` coincidió con el ID de la publicación y el ID del perfil. Devolvió vistas, me gusta, comentarios, compartidos, guardados y republicaciones públicos. Devolvió el conteo público de seguidores y los indicadores de precisión. Algunos conteos fueron `likely_rounded`. Los guardados y las republicaciones fueron `exact`. Eso respalda los contadores públicos actuales y la identidad en esa fuente. Esa comprobación no acepta la retención. No acepta la finalización, el alcance privado, los clics, las ventas, las comprobaciones de fraude ni los espectadores distintos. No acepta todos los perfiles. No acepta una curva privada. En este Actor no hay una curva privada que aceptar.
Compruebe estos totales de salida
Revise la salida de la ejecución antes de conservar una fila. Lea `providedUrls`, `contentUrls`, `inputUrls`, `resolvedUrls`, `metricRows`, `noPublicMetricRows`, `blockedRows`, `failedRows` y `statusCounts`. Compare los totales de URL entre sí. No suponga que cada URL enviada se volvió una fila de métricas útil. Use `metricRows` para las filas que devolvieron métricas públicas. Use `noPublicMetricRows` para las filas sin métricas públicas. Esas filas no son ceros. Use `blockedRows` y `failedRows` antes de confiar en el conjunto. Use `statusCounts` para ver las filas por estado. Si un total está ausente, déjelo como desconocido. No escriba 0 salvo que la salida muestre 0.
Este artículo no inventa esos totales para el control. El control solo respalda los contadores públicos nombrados arriba. Lea los totales en su propia ejecución.
Cambie la Task a un video
La Task pública es TikTok Profile Analytics. Se comprobó el 13 de octubre de 2026. El nombre significa métricas públicas de video. No significa una curva de retención. La entrada guardada es un punto de partida. No es prueba de que el análisis ocurra solo.
La entrada guardada está abajo. Los tres perfiles son muestras. No son su informe.
{
"mode": "profileUrls",
"startUrls": ["@mrbeast", "@nike", "@playstation"],
"maxItems": 60,
"includeProfileMetrics": true
}Cámbiela para este método. Use una URL de video público que ya conozca. Ponga `maxItems` en 1.
{
"mode": "knownUrls",
"startUrls": ["YOUR_ONE_PUBLIC_VIDEO_URL"],
"maxItems": 1
}Reemplace `YOUR_ONE_PUBLIC_VIDEO_URL` por la URL de ese único video. No deje una URL de perfil en `startUrls`. No deje `maxItems` en 60 para esta comprobación. Puede poner `includeProfileMetrics` en true para datos públicos del perfil. Ese indicador igual no agrega una curva.
Siete acciones
- Diga la decisión en una oración. O necesita el momento en que un video propio pierde espectadores, o necesita saber qué video público tiene más vistas. No recoja datos antes de elegir. La retención usa la proporción de la fuente en cada posición de tiempo. La base es el total de la fuente, no el contador público de vistas. La tabla de arriba es la división. Un total de vistas responde solo una comparación pública.
- Haga el inventario de un video público conocido. Compruebe la identidad de la publicación, la duración, las vistas, el estado, la hora de lectura y la precisión. Use `knownUrls`, un video y `maxItems` 1. Esa es la ruta de contadores públicos. En este Actor no existe un campo de curva privada. Si falta una métrica, déjela como ausente. No guarde 0 en su lugar. Si el estado dice que la fila no es útil, deje las métricas fuera del informe.
- Pregunte si la fuente muestra una serie de retención por tiempo. Un conteo de vistas no puede restaurar esa serie. Los me gusta, los comentarios, los compartidos, los guardados y las republicaciones no pueden restaurarla. La duración del video no puede restaurarla. Un tiempo medio de visionado no puede restaurarla. Muchas curvas pueden compartir un mismo promedio. Una lectura pública posterior puede mostrar un conteo de vistas más alto. La diferencia es actividad nueva del contador. No es un mapa de los segundos mirados. No divida las vistas por los segundos para trazar una línea.
- Si el video es suyo, use las herramientas de su cuenta de TikTok. TikTok Studio documenta esas herramientas. Herramientas para creadores documenta las herramientas para creadores y el rendimiento de la publicación. Las páginas respaldan la analítica de una publicación individual. No prometen una curva de retención en cada cuenta. No prometen un archivo de exportación en cada cuenta. Abra su publicación y lea las etiquetas que están de verdad. Si falta una etiqueta, escriba que no está disponible. Nunca dé a este Actor público su contraseña ni la sesión en la que usted ya inició sesión.
- Conserve la definición de la fuente junto a cada número. Conserve también el ID del video, la ventana de fechas, la cohorte y las posiciones de tiempo cuando se muestren. Una cohorte es el grupo que está detrás de la proporción. Compare la misma ventana y la misma definición. Si solo tiene un promedio, informe el promedio bajo esa definición. No convierta el promedio en una curva. Si solo tiene una captura de pantalla, marque los valores leídos como aproximados. Las etiquetas redondeadas pueden ocultar el valor exacto.
- Use este paso solo cuando haya una curva real de posiciones en su pantalla. Mire el video original alrededor de la caída. Escriba una posible razón de contenido. Escriba un cambio para probar en un video posterior. La nota es una posibilidad, no una prueba de que las personas se fueron por esa razón. Los espectadores que repiten pueden cambiar los números. Un bucle es una reproducción extra del mismo video. Los bucles pueden cambiar los números. Las reglas de la fuente pueden incluir o excluir esas reproducciones. Si la etiqueta no lo dice, esa regla es desconocida. No ponga un total público de vistas debajo de una proporción privada de retención.
- Si los datos de posición de visionado todavía no están disponibles, dígalo en el informe. Después responda solo la comparación pública que puede respaldar. Reduzca la decisión a las vistas públicas observadas. Conserve un plan de recogida antes de cambiar el video. No cambie el inicio solo porque adivinó una curva. El plan nombra la pantalla, el campo, el video y la fecha en que los va a leer. La matemática propia solo se permite cuando esas posiciones de visionado se muestran de verdad.
Una curva real necesita cinco partes. Necesita el ID del video. Necesita la ventana de fechas. Necesita la cohorte. Necesita cada posición de tiempo. Necesita la proporción de la fuente que sigue mirando en esa posición. Si falta una parte, usted no tiene una curva.
Vistas iguales pueden ocultar dos curvas
Las historias que siguen son ficción. No son un resultado del Actor. No son una medición de TikTok. No son un valor de referencia.
Dos videos de ficción duran 30 segundos cada uno. Cada uno muestra 1.000 vistas públicas. Los totales coinciden. Los historiales de visionado que no se ven no tienen que coincidir. Cada escenario usa una cohorte inventada de 100 sesiones. El encabezado del escenario A es 100 en total. El encabezado del escenario B es 100 en total. El escenario A no es 90 en total. El escenario B no es 50 en total.
| Escenario | Total de la cohorte | Sigue mirando a los 5 segundos | Sigue mirando a los 15 segundos | Sigue mirando a los 30 segundos |
|---|---|---|---|---|
| A | 100 | 90 sesiones, 90 por ciento | 80 sesiones, 80 por ciento | 70 sesiones, 70 por ciento |
| B | 100 | 50 sesiones, 50 por ciento | 20 sesiones, 20 por ciento | 10 sesiones, 10 por ciento |
El por ciento es las sesiones que siguen mirando divididas por el total de la cohorte de 100. Para el escenario A a los 5 segundos, 90 dividido por 100 es igual a 90 por ciento. A los 15 segundos, 80 dividido por 100 es igual a 80 por ciento. A los 30 segundos, 70 dividido por 100 es igual a 70 por ciento. Para el escenario B a los 5 segundos, 50 dividido por 100 es igual a 50 por ciento. A los 15 segundos, 20 dividido por 100 es igual a 20 por ciento. A los 30 segundos, 10 dividido por 100 es igual a 10 por ciento.
Ninguna fila se calcula a partir de las 1.000 vistas públicas. Las mismas 1.000 vistas pueden estar en la curva alta o en la curva baja. Dividir las vistas por 30 segundos no construye ninguna de las dos tablas. No informe esa división como retención. Estos porcentajes usan la base inventada de 100. No son una definición de TikTok. No son una curva medida. Los totales públicos idénticos no muestran las posiciones miradas.
Los porcentajes propios necesitan su propia base
Este segundo ejemplo también es ficción. Es una captura de pantalla inventada. No es un resultado del producto. No es prueba de que su cuenta tenga una exportación. Use la matemática solo si su propia pantalla muestra posiciones de visionado.
| Lectura | Tiempo en el video | Sigue mirando | Base |
|---|---|---|---|
| Captura de pantalla de ficción, aproximada | 10 segundos | 62 por ciento | La definición que indica esa pantalla |
| Captura de pantalla de ficción, aproximada | 15 segundos | 48 por ciento | La misma definición y el mismo grupo |
Los valores son aproximados porque una captura de pantalla puede mostrar etiquetas redondeadas. 48 menos 62 es igual a -14. El cambio es -14 puntos porcentuales. Un punto porcentual es un paso en una escala de por ciento. La proporción baja 14 puntos porcentuales. Eso no es una disminución relativa del 14 por ciento.
Una disminución relativa compara la caída con la proporción inicial. La caída es de 14 puntos porcentuales. El inicio es 62 por ciento. 14 dividido por 62 es igual a cerca de 0,226. Eso es el 22,6 por ciento de la proporción inicial. Informe -14 puntos porcentuales, o una disminución relativa del 22,6 por ciento. Diga qué cifra quiere decir.
Esto no significa que el 14 por ciento de todos los espectadores públicos se fue. No nombra una causa. La base es la cohorte de ficción de la fuente. No son las 1.000 vistas públicas. No es la cohorte inventada de 100 sesiones. No mezcle estas bases. Si su pantalla no tiene valores de posición de visionado, no use esta matemática.
Fuentes y lecturas adicionales
Por Chronometrica · Actualizado
Volver arriba ↑

