Como conciliar registros do TikTok Creator Rewards com visualizações públicas dos vídeos

1. Defina a pergunta e o período do relatório

Escreva uma frase que indique o que você precisa verificar. Por exemplo: “Preciso listar as recompensas estimadas exibidas para setembro e adicionar a contagem pública de visualizações mais recente disponível para cada vídeo correspondente.”

Essa pergunta tem duas referências de data. Setembro se refere aos registros de recompensas do titular. A observação pública tem data e hora próprias. Uma contagem pública consultada em outubro não passa a ser uma contagem de setembro quando você a coloca ao lado das recompensas de setembro.

Escolha os dados de que seu relatório precisa:

Visualizações qualificadas são as visualizações que a fonte do Rewards do titular identifica como qualificadas. Este guia não fornece uma regra de qualificação separada. Preserve o rótulo exato da conta. Não trate visualizações públicas comuns como visualizações qualificadas.

Registre o período do relatório, a moeda e a data em que você verificou a fonte do titular. Mantenha qualquer fuso horário informado. Se a fonte não mostrar um fuso horário ou um horário preciso, registre essa lacuna. Não adicione uma precisão que a fonte não fornece.

Informe também a abrangência do relatório. “Três registros selecionados do titular referentes a setembro” é diferente de “todos os registros do Rewards de setembro”. Use a segunda descrição apenas quando as evidências sustentarem essa abrangência.

2. Colete os registros do titular que você consegue acessar

Abra o painel do Rewards ou os arquivos disponíveis na sua conta. Guarde uma referência à tela ou ao arquivo que deu origem a cada registro copiado. Preserve os rótulos, as datas, as referências dos vídeos e os status dos valores originais.

Se você não encontrar uma exportação, registre manualmente um pequeno conjunto que possa verificar. Este método não depende de uma exportação em CSV. CSV é um arquivo de texto que armazena valores de uma tabela separados por vírgulas. As evidências fixadas para este guia não confirmam a disponibilidade de uma exportação completa do Rewards em CSV.

Siga estas etapas para cada registro do titular:

1. Registre onde você o encontrou e quando o verificou.
2. Copie o período e a referência do vídeo.
3. Copie o valor da recompensa, a moeda e o rótulo exato do valor.
4. Copie as visualizações qualificadas e a elegibilidade apenas quando a fonte as mostrar.
5. Marque cada valor ausente como desconhecido.
6. Confira novamente os valores copiados com a fonte.

Mantenha as recompensas estimadas e os comprovantes de pagamento em colunas ou tabelas separadas. Uma estimativa exibida não prova que o dinheiro foi pago. Se um registro de pagamento não tiver uma referência de vídeo, preserve o escopo informado. Não atribua esse pagamento a um vídeo sem evidências.

Preserve a unidade da fonte. Um valor em moeda e uma contagem de visualizações são unidades diferentes. Não os reúna em um único total. Mantenha moedas diferentes em totais separados, a menos que você tenha um método de conversão separado e fundamentado.

Um valor ausente não é zero. Zero significa que a fonte informa uma quantidade nula para aquele campo. Desconhecido significa que o registro não permite determinar o valor. Essa distinção se aplica a recompensas, pagamentos, visualizações qualificadas, elegibilidade e visualizações públicas.

3. Salve três tabelas relacionadas

Mantenha os registros do titular, as verificações de identificação dos vídeos e as observações públicas em tabelas separadas. Isso facilita as verificações posteriores. Também impede que observações públicas repetidas dupliquem os valores das recompensas.

Os campos abaixo são sugestões para o relatório. São campos da sua própria tabela, e não campos adicionais retornados pelo coletor de dados públicos.

Registros do titular

Use uma linha para cada registro da fonte do titular. Um vídeo pode ter vários registros de períodos ou tipos diferentes.

Mapa de identificação dos vídeos

Um mapa de identificação relaciona a referência do vídeo no registro do titular ao vídeo público verificado. Salve a referência do titular, o ID exato do vídeo público, a URL pública, a data de verificação e a conclusão sobre a identificação.

Confira os IDs exatos sempre que estiverem disponíveis. Uma legenda, um título ou uma data semelhante não basta. Se você não conseguir confirmar que os dois registros se referem ao mesmo vídeo, deixe a identificação pendente.

Mantenha a chave do registro do titular ao estabelecer essa correspondência. O ID do vídeo, sozinho, não distingue dois períodos de recompensa do mesmo vídeo.

Observações públicas

Um registro pontual é uma observação salva em um momento específico. Mantenha cada registro pontual público em uma linha separada. Salve os seguintes campos documentados quando forem retornados:

A saída documentada também inclui `publishedAt`. Esse campo indica a data e a hora de publicação do vídeo. Mantenha-o separado de `scrapedAt` e do período do Rewards do titular.

4. Adicione uma observação pública quando for útil

Um Actor é um programa hospedado de coleta de dados. O Actor TikTok Metrics Scraper documenta contadores públicos de vídeos e campos de identificação. Sua saída documentada não tem campos de ganhos ou de visualizações qualificadas. Ele não cria sua tabela de conciliação.

O contrato verificado aceita URLs conhecidas de vídeos públicos por meio de `startUrls`, com `mode` definido como `knownUrls`. Use esta pequena entrada como estrutura inicial:

{
  "maxItems": 1,
  "mode": "knownUrls",
  "startUrls": ["https://www.tiktok.com/@mrbeast/video/7654638524729216287"]
}

Substitua a URL de exemplo por uma URL verificada de vídeo público do seu mapa de identificação. O endereço fornecido é um exemplo. Ele não é uma evidência sobre sua conta ou seus registros do Rewards. `maxItems` limita o total de linhas da saída. Um limite de 1 mantém pequena esta verificação proposta; ele não comprova uma abrangência completa da conta.

Essa entrada é válida de acordo com o esquema fornecido. Nenhuma execução foi feita para este artigo. Os campos de saída descrevem o contrato público, e não um resultado observado aqui. Contrato público do Actor, verificado em 25 de outubro de 2026; entrada e saída documentadas, sem resultado de execução.

Uma Task é uma configuração de entrada salva para um Actor. A página pública da Task TikTok Creator Analytics estava disponível quando a fonte foi verificada. Suas configurações salvas não foram consultadas por meio de uma conta autenticada, e a Task não foi executada. Confira a entrada antes de usar. Task TikTok Creator Analytics, verificada em 25 de outubro de 2026; apenas presença pública.

Após sua própria verificação, examine `status`, `statusReason` e a entrada de `views` em `postMetricStatus`. Mantenha tanto o status da métrica quanto seu valor de precisão. Os valores de precisão documentados incluem `exact`, `display_rounded`, `likely_rounded`, `unavailable` e `unknown`.

Não apresente uma contagem arredondada como exata. Não transforme um valor ausente de `views` em zero. Mesmo um contador público exato não comprova que esse número corresponde a pessoas distintas.

Este relatório trata dos registros do Rewards do titular. Se sua tarefa separada for documentar a entrega prevista em um acordo com uma marca, use o método de comprovação de visualizações de UGC no TikTok. Esse método tem verificações diferentes para o acordo e seu horário de corte.

5. Relacione os registros sem alterar os totais de recompensas

Uma junção é uma etapa que combina registros por meio de um campo em comum. Aqui, faça a junção apenas pela identificação verificada do vídeo. Mantenha a chave do registro do titular, o período e o tipo de registro no resultado.

Siga esta sequência:

1. Some os valores conhecidos das recompensas do titular antes de adicionar dados públicos.
2. Conte os registros da fonte do titular e os registros com valores ausentes.
3. Selecione no máximo um registro pontual público para cada registro do titular neste relatório.
4. Relacione o registro pontual selecionado pelo ID verificado do vídeo.
5. Mantenha o período do titular e a data e hora da observação pública em colunas separadas.
6. Some novamente os valores do titular e compare o resultado com o total original.

Se você guardar vários registros pontuais públicos, mantenha-os na tabela de observações públicas. Selecione um para o relatório de acordo com uma regra explícita, como a observação utilizável mais recente disponível para este relatório. Registre qual registro pontual você selecionou.

Um registro do titular não deve se transformar em vários valores a pagar por ter várias leituras públicas. Da mesma forma, dois registros do titular para um vídeo continuam sendo dois registros da fonte quando seus períodos ou tipos de registro são diferentes.

Descreva diretamente a relação entre as datas. “Estimativa de setembro com visualizações públicas observadas em 25 de outubro” é claro. “Visualizações de setembro” não teria fundamento se você só tivesse coletado a contagem pública em outubro.

As contagens públicas também não mostram quais trechos os espectadores assistiram. Se essa for sua próxima pergunta, use o guia de escolha de dados de retenção do TikTok para selecionar dados do titular adequados a essa pergunta.

6. Exemplo explicado: três vídeos selecionados

Ficção original. Todos os valores abaixo foram inventados para explicar o método. Eles não são ganhos reais, um resultado da plataforma, uma execução de Actor ou uma expectativa de pagamento. V1, V2 e V3 são rótulos fictícios de vídeos.

Os registros disponíveis do titular se referem a setembro. As observações públicas separadas têm a data de 25 de outubro. O exemplo não fornece indicadores de precisão das contagens públicas, horários exatos das observações, registros de pagamento ou status de elegibilidade. Mantenha esses detalhes como desconhecidos.

O total conhecido de recompensas estimadas é:

12 USD + 8 USD = 20 USD.

São 20 USD em dois registros do titular com estimativas conhecidas. A tabela mostra três vídeos selecionados, mas a terceira estimativa é desconhecida. Portanto, 20 USD não é o total completo de recompensas dos três vídeos. Também não é dinheiro com pagamento confirmado.

A contagem conhecida de visualizações qualificadas é de 6.000 para V1. Não foram fornecidos valores de visualizações qualificadas para V2 e V3. Não descreva 6.000 como o total completo dos três vídeos.

As 9.000 visualizações públicas de V2 não preenchem seu campo ausente de visualizações qualificadas. Não use a relação entre as visualizações públicas e qualificadas de V1 para estimar as de V2. A fonte não estabelece uma regra de conversão. O período de setembro do titular e a observação pública de outubro também continuam sendo referências de data diferentes.

Agora, suponha que você adicione depois outro registro pontual público para V1. Trata-se de um registro adicional proposto neste exemplo fictício. Mantenha a estimativa do titular para V1 em 12 USD. O total conhecido do titular continua sendo:

12 USD + 8 USD = 20 USD.

Se a tabela resultante da junção contar os 12 USD de V1 duas vezes, o resultado será:

12 USD + 12 USD + 8 USD = 32 USD.

Os 12 USD adicionais vêm de um registro repetido do titular. Não são outra recompensa. Corrija a junção antes de usar o relatório.

Para V3, mantenha desconhecido tanto na estimativa quanto nas visualizações públicas. O exemplo não informa o motivo da ausência do valor público. Não o classifique como falha na consulta, vídeo removido ou zero visualizações sem evidências.

7. Registre as lacunas e confira a tabela pronta

Dê uma explicação clara para cada pendência. Lacunas diferentes exigem próximas etapas diferentes.

Aceite o relatório somente após estas verificações:

1. Cada valor do titular tem uma referência da fonte, um período, uma moeda e um status do valor.
2. Cada correspondência usa uma identificação verificada do vídeo.
3. A contagem de registros do titular e os totais conhecidos permanecem iguais após a junção.
4. Os valores ausentes continuam distintos de zero.
5. Cada contagem pública mantém a data e a hora da observação e as informações de precisão disponíveis.
6. As estimativas continuam separadas dos pagamentos confirmados.
7. Nenhum cálculo converte visualizações públicas em ganhos ou visualizações qualificadas.
8. A declaração de abrangência identifica quaisquer registros ausentes do titular ou lacunas na exportação.

As evidências das fontes sustentam este método proposto, e não um resultado de conciliação medido. Uma pergunta pública trata de como exportar dados do Creator Rewards pelo TikTok Studio. Isso sustenta a formulação do problema do leitor. Não comprova a existência de um recurso de exportação nem mostra quantos criadores têm esse problema. Pergunta pública sobre exportação, consultada em 11 de agosto de 2026; apenas um registro de pergunta.