# Como montar um recibo de evidência de visualizações para um acordo de UGC no TikTok

Documente evidências públicas de visualizações no TikTok ao confrontar uma verificação manual do conteúdo e um instantâneo de visualizações ligado à fonte com o horário de corte acordado. Acordos de conteúdo gerado por usuários (UGC) precisam de dados públicos verificados do post para mostrar a entrega. Você deve capturar juntos o contador público, o carimbo de data e hora da observação e o sinalizador de precisão da métrica. Um Actor é um programa hospedado de coleta de dados. Uma Task é uma predefinição de entrada salva. Este método cria evidência clara para revisão pública. Ele não certifica pagamento, não prova vendas privadas e não mostra localizações de espectadores únicos.

## Contrato de métrica pública e configuração

A build 0.1.36 do scraper TikTok Metrics aceita os modos `auto`, `knownUrls` e `profileUrls`. Ela aceita os parâmetros `startUrls`, `maxItems` opcional, `includeProfileMetrics`, `requestTimeoutSecs`, `maxConcurrency` e `failOnNoMetrics`. Para este método piloto, escolha `knownUrls` com um URL de vídeo público pretendido e defina `maxItems` como 1. Não use a predefinição de descoberta de perfil como promessa de histórico completo. Definir `includeProfileMetrics` como true acrescenta fatos públicos atuais do perfil em regime de melhor esforço, não identidades de seguidores nem análises privadas.

Uma linha do conjunto de dados representa um resultado de vídeo tentado ou resolvido. Sempre inspecione o status da linha e `statusReason` antes de contar as métricas como úteis. Os campos nativos do conjunto de dados usados aqui são: `inputUrl`, `postUrl`, `postId`, `profileId`, `profileHandle`, `profileUrl`, `publishedAt`, `videoDurationSeconds`, `views`, `likes`, `comments`, `shares`, `saves`, `reposts`, `profileFollowersCount`, `postMetricStatus`, `profileMetricStatus` e `scrapedAt`. Métricas ausentes retornam como `null`, não como zero. Os sinalizadores de precisão da métrica incluem `exact`, `display_rounded`, `likely_rounded` e `unavailable`. Um inteiro público exato ainda é a contagem pública da plataforma, não uma medida validada de pessoas distintas. O Actor não emite taxas derivadas.

Verifique as contagens do resumo final da execução para providedUrls, contentUrls, inputUrls, resolvedUrls, metricRows, noPublicMetricRows, blockedRows, failedRows e statusCounts para confirmar os resultados do processamento antes de avaliar as linhas do conjunto de dados. Um resumo de execução bem-sucedida com metricRows que mostra dados resolvidos confirma a extração do contador, enquanto alvos que aparecem em noPublicMetricRows, blockedRows ou failedRows indicam falhas da fonte ou métricas indisponíveis que devem ser mantidas como valores ausentes ou desconhecidos, nunca contadas como zero visualizações.

Um teste de controle de um único vídeo verificou IDs correspondentes de post e de perfil, contadores públicos, contagem de seguidores do perfil e sinalizadores de precisão. Várias contagens eram `likely_rounded`, enquanto saves e reposts eram `exact`. Isso confirma o suporte a contador público e identidade. Isso não prova retenção, conclusão, alcance privado, cliques, vendas, fraude de anúncio nem espectadores únicos.

Substitua todos os URLs de alvo de exemplo na predefinição da Task pelo seu único link de vídeo público conhecido.

## Método passo a passo do recibo de entrega

1. Registre todas as regras de entrega acordadas antes de verificar o post. Anote o nome de usuário esperado do criador, o conteúdo de vídeo exigido, a identidade do post, o horário de corte e o fuso horário. Liste a métrica exata prometida no seu contrato de UGC. Não estime taxas de remuneração do criador nem preveja ganhos futuros.
2. Execute o coletor de dados para o URL do seu vídeo. Defina o modo como `knownUrls` e defina `maxItems` como 1. Defina `includeProfileMetrics` como true se você precisar de fatos de identidade do perfil. Substitua os URLs de exemplo pelo seu URL alvo. Verifique se `postId` e `profileHandle` correspondem aos seus registros.
3. Assista ao vídeo publicado manualmente. Confirme que o vídeo mostra o produto, o criador, a cena e a mensagem corretos. Registre uma nota breve de aprovação ou reprovação com o carimbo de data e hora da sua revisão manual. Contadores públicos de visualizações não podem verificar cenas do vídeo, direitos de licenciamento nem se a divulgação identifica corretamente o conteúdo como publicidade.
4. Salve as métricas brutas de visualizações e os sinalizadores de status. Verifique a contagem de `views` junto com `postMetricStatus`, `profileMetricStatus` e `scrapedAt`. O contrato atual da plataforma informa a precisão como `exact`, `display_rounded`, `likely_rounded` ou `unavailable`. Não transforme números arredondados em contagens exatas. Não some curtidas, compartilhamentos nem salvamentos à contagem de visualizações.
5. Compare o horário real da observação com o horário de corte acordado. Um instantâneo de visualizações feito depois do horário de corte não mostra qual era a contagem no corte. Mantenha leituras tardias separadas. Não calcule visualizações ausentes com taxas diárias inventadas.
6. Atribua um status de revisão claro à linha de evidência. Use `checked_public_count_for_review` somente quando a identidade, a verificação manual, o horário de corte e a precisão da métrica atenderem a todos os termos do contrato. Use `delivery_gap`, `timing_gap`, `precision_gap`, `source_unavailable` ou `private_metric_required` quando as verificações falharem.
7. Monte o recibo final de visualizações. Combine a referência do contrato, o URL alvo, o resultado da verificação manual, o carimbo de data e hora da observação, a contagem pública de visualizações, o sinalizador de precisão e o status de revisão. [Mantenha instantâneos de visualizações anteriores e posteriores separados](/pt-BR/articles/historico-de-metricas-de-posts-do-facebook/).
8. Envie o recibo de evidência ao seu parceiro de marca ou ao processo de revisão. Este recibo registra métricas públicas da plataforma. Ele não emite faturas, não processa pagamentos e não garante resultados de campanha.

## Exemplos fictícios de recibo

Os exemplos a seguir usam dados fictícios originais para mostrar como diferentes resultados de post se mapeiam para estados de revisão. A regra alvo exige visualizações públicas exatas para um post acordado em 10 de outubro às 12:00 UTC, com verificação manual da cena aprovada.

- Candidato V1 (Fictício): O nome de usuário do criador e o produto correspondem. A verificação manual da cena é aprovada. O instantâneo capturado às 12:00 UTC mostra 40.000 visualizações com precisão exata. Status: `checked_public_count_for_review`.
- Candidato V2 (Fictício): O conteúdo e o horário de corte correspondem. O contador mostra 1.2M visualizações com precisão `likely_rounded`. A contagem exata de visualizações permanece desconhecida. Qualquer número 1.200.000 é uma estimativa derivada da exibição, não uma contagem exata certificada. Status: `precision_gap`.
- Candidato V3 (Fictício): A verificação da cena é aprovada e a precisão é exata em 50.000 visualizações. O instantâneo foi feito às 12:07 UTC, o que significa 7 minutos de atraso. Status: `timing_gap`.
- Candidato V4 (Fictício): O instantâneo foi feito às 12:00 UTC com uma contagem exata de 20.000 visualizações. A verificação manual revela que o vídeo exibe o produto errado. Status: `delivery_gap`.
- Candidato V5 (Fictício): O scraper não retorna métricas públicas por causa de erros da fonte. A contagem de visualizações está ausente (null), e não é zero. Status: `source_unavailable`.
- Candidato V6 (Fictício): O contrato exige visualizações verificadas dos EUA. Os contadores públicos não detalham a localização do espectador. Status: `private_metric_required`.

| ID do post | Horário da observação | Visualizações | Sinalizador de precisão | Verificação manual | Status de revisão |
| --- | --- | --- | --- | --- | --- |
| V1 (Fictício) | 2026-10-10 12:00 UTC | 40.000 | exact | Aprovado | checked_public_count_for_review |
| V2 (Fictício) | 2026-10-10 12:00 UTC | 1.2M | likely_rounded | Aprovado | precision_gap |
| V3 (Fictício) | 2026-10-10 12:07 UTC | 50.000 | exact | Aprovado | timing_gap |
| V4 (Fictício) | 2026-10-10 12:00 UTC | 20.000 | exact | Reprovado (produto errado) | delivery_gap |
| V5 (Fictício) | 2026-10-10 12:00 UTC | null | unavailable | Aprovado | source_unavailable |
| V6 (Fictício) | 2026-10-10 12:00 UTC | 100.000 | exact | Aprovado | private_metric_required |

Uma linha entre seis produziu um registro público válido de visualizações para revisão. As cinco linhas restantes sinalizaram lacunas específicas que precisam de resolução manual.

## Próxima ação

Salve um recibo completo e datado de entrega manual e de visualizações, com estados não resolvidos de tempo ou de precisão, usando o [TikTok Metrics Scraper Actor](https://apify.com/chronometrica/tiktok-metrics-scraper) e configure seus URLs alvo com a [TikTok Campaign Performance Report Task](https://apify.com/chronometrica/tiktok-metrics-scraper/examples/tiktok-campaign-performance-report).

## Fontes e leituras adicionais

- [Discussão sobre o fluxo de trabalho de conteúdo UGC pago:](https://www.reddit.com/r/techugc/comments/1ufvq36/looking_for_ugc_creators_tech_app_paid_remote/)