Cómo armar un comprobante de evidencia de vistas para un acuerdo de UGC en TikTok

Contrato de métricas públicas y configuración

El TikTok Metrics scraper, compilación 0.1.36, acepta los modos `auto`, `knownUrls` y `profileUrls`. Acepta los parámetros `startUrls`, `maxItems` opcional, `includeProfileMetrics`, `requestTimeoutSecs`, `maxConcurrency` y `failOnNoMetrics`. Para este método piloto, elija `knownUrls` con una URL de video público prevista y fije `maxItems` en 1. No use el preajuste de descubrimiento de perfil como una promesa de historial completo. Fijar `includeProfileMetrics` en true agrega datos públicos actuales del perfil con el mejor esfuerzo, no identidades de seguidores ni analítica privada.

Una fila del conjunto de datos representa un resultado de video intentado o resuelto. Revise siempre el estado de la fila y `statusReason` antes de contar las métricas como útiles. Los campos nativos del conjunto de datos que se usan aquí son: `inputUrl`, `postUrl`, `postId`, `profileId`, `profileHandle`, `profileUrl`, `publishedAt`, `videoDurationSeconds`, `views`, `likes`, `comments`, `shares`, `saves`, `reposts`, `profileFollowersCount`, `postMetricStatus`, `profileMetricStatus` y `scrapedAt`. Las métricas faltantes se devuelven como `null`, no como cero. Las marcas de precisión de las métricas incluyen `exact`, `display_rounded`, `likely_rounded` y `unavailable`. Un entero público exacto sigue siendo el recuento público de la plataforma, no una medida validada de personas distintas. El Actor no emite tasas derivadas.

Revise los recuentos del resumen final de la ejecución para providedUrls, contentUrls, inputUrls, resolvedUrls, metricRows, noPublicMetricRows, blockedRows, failedRows y statusCounts, a fin de confirmar los resultados del procesamiento antes de evaluar las filas del conjunto de datos. Un resumen de ejecución correcto, con metricRows que muestran datos resueltos, confirma la extracción del contador. En cambio, los destinos que aparecen en noPublicMetricRows, blockedRows o failedRows indican fallas de la fuente o métricas no disponibles. Esos valores deben conservarse como faltantes o desconocidos, y nunca contarse como cero vistas.

Una prueba de control de un solo video verificó la coincidencia de los ID de la publicación y del perfil, los contadores públicos, el recuento de seguidores del perfil y las marcas de precisión. Varias métricas fueron `likely_rounded`, mientras que saves y reposts fueron `exact`. Esto confirma el soporte del contador público y de la identidad. No prueba la retención, la finalización, el alcance privado, los clics de acceso, las ventas, el fraude publicitario ni los espectadores distintos.

Reemplace todas las URL de destino de ejemplo del preajuste de la Task por su único enlace de video público conocido.

Método paso a paso del comprobante de entrega

1. Anote todas las reglas de entrega acordadas antes de revisar la publicación. Escriba el nombre de usuario esperado del creador, el contenido de video requerido, la identidad de la publicación, la hora de corte y la zona horaria. Indique la métrica exacta prometida en su contrato de UGC. No estime tarifas de pago ni prediga ganancias futuras.
2. Ejecute el recolector de datos para la URL de su video. Fije el modo en `knownUrls` y fije `maxItems` en 1. Fije `includeProfileMetrics` en true si necesita datos de identidad del perfil. Reemplace las URL de ejemplo por su URL de destino. Compruebe que `postId` y `profileHandle` coincidan con sus registros.
3. Mire el video publicado de forma manual. Confirme que el video muestra el producto, el creador, la escena y el mensaje correctos. Anote un breve resultado de aprobado o no aprobado con la marca de tiempo de su revisión manual. Los contadores públicos de vistas no pueden verificar las escenas del video, los derechos de licencia ni la identificación correcta del contenido como publicidad o como contenido patrocinado.
4. Guarde las métricas de vistas en bruto y las marcas de estado. Revise el recuento de `views` junto con `postMetricStatus`, `profileMetricStatus` y `scrapedAt`. El contrato actual de la plataforma informa la precisión como `exact`, `display_rounded`, `likely_rounded` o `unavailable`. No convierta números redondeados en recuentos exactos. No sume likes, shares ni saves al recuento de vistas.
5. Compare la hora real de observación con la hora de corte acordada. Una instantánea de vistas tomada después de la hora de corte no muestra cuál era el recuento en el corte. Mantenga separadas las lecturas tardías. No calcule las vistas faltantes con tasas diarias inventadas.
6. Asigne un estado de revisión claro a la fila de evidencia. Use `checked_public_count_for_review` solo cuando la identidad, la revisión manual, la hora de corte y la precisión de la métrica cumplan todos los términos del contrato. Use `delivery_gap`, `timing_gap`, `precision_gap`, `source_unavailable` o `private_metric_required` cuando las revisiones fallen.
7. Arme el comprobante final de vistas. Combine la referencia del contrato, la URL de destino, el resultado de la revisión manual, la marca de tiempo de observación, el recuento público de vistas, la marca de precisión y el estado de revisión. Mantenga separadas las instantáneas de vistas anteriores y posteriores.
8. Entregue el comprobante de evidencia a su socio de marca o al proceso de revisión. Este comprobante registra métricas públicas de la plataforma. No emite facturas, no procesa pagos ni garantiza resultados de la campaña.

Ejemplos ficticios de comprobantes

Los ejemplos siguientes usan datos ficticios originales para mostrar cómo distintos resultados de publicaciones se corresponden con estados de revisión. La regla de destino exige vistas públicas exactas para una publicación acordada el 10 de octubre a las 12:00 UTC, con una revisión manual de la escena aprobada.

• Candidato V1 (ficticio): El nombre de usuario del creador y el producto coinciden. La revisión manual de la escena se aprueba. La instantánea capturada a las 12:00 UTC muestra 40.000 vistas con precisión exacta. Estado: `checked_public_count_for_review`.
• Candidato V2 (ficticio): El contenido y la hora de corte coinciden. El contador muestra 1.2M vistas con precisión `likely_rounded`. El recuento exacto de vistas sigue siendo desconocido. Cualquier cifra numérica de 1.200.000 es una estimación derivada de lo que se muestra, no un recuento exacto certificado. Estado: `precision_gap`.
• Candidato V3 (ficticio): La revisión de la escena se aprueba y la precisión es exacta en 50.000 vistas. La instantánea se tomó a las 12:07 UTC, es decir, 7 minutos tarde. Estado: `timing_gap`.
• Candidato V4 (ficticio): La instantánea se tomó a las 12:00 UTC con un recuento exacto de 20.000 vistas. La revisión manual revela que el video muestra el producto incorrecto. Estado: `delivery_gap`.
• Candidato V5 (ficticio): El scraper no devuelve métricas públicas por errores de la fuente. El recuento de vistas falta (null) y no es cero. Estado: `source_unavailable`.
• Candidato V6 (ficticio): El contrato exige vistas verificadas de Estados Unidos. Los contadores públicos no desglosan la ubicación del espectador. Estado: `private_metric_required`.

Una fila de seis produjo un registro válido de vistas públicas para revisión. Las cinco filas restantes marcaron brechas específicas que necesitan una resolución manual.