# Exporte comentários de primeiro nível do TikTok para codificação no NVivo

Exporte cada comentário de primeiro nível do TikTok como uma linha da tabela. Importe esse texto no NVivo como conteúdo que você pode codificar. Mantenha cada id de origem ao lado do texto.

Um comentário de primeiro nível é um comentário na publicação. Uma resposta é uma reação a um comentário. Estas etapas usam somente comentários de primeiro nível.

Um id de origem é o nome público de uma publicação, de um comentário ou de um autor. O NVivo é um software que guarda texto para codificação manual. Codificação qualitativa significa marcar o texto com um rótulo nomeado e escrever o motivo.

Um Actor é um programa hospedado que coleta dados. Uma Task é uma predefinição de entrada salva para um Actor. O Actor [TikTok Comments Scraper](https://apify.com/chronometrica/tiktok-comments-scraper) coleta linhas de origem públicas. Você faz a codificação. O Actor não cria códigos, casos nem um arquivo do NVivo.

A Task pública [Export TikTok Comments to CSV or Excel](https://apify.com/chronometrica/tiktok-comments-scraper/examples/export-tiktok-comments-to-csv) foi verificada em 13 de outubro de 2026. Uma Task pública é apenas uma entrada inicial. Isso não significa que a análise ocorre sozinha.

## Colete as linhas públicas corretas

Use o build público 0.1.17. A entrada `startUrls` aceita de 1 a 100 itens. Cada item deve ser uma URL completa conhecida que contenha `/video/` ou `/photo/`, ou um id numérico de publicação. Um link curto não basta. Abra o link curto e copie primeiro a URL completa conhecida.

A Task salva contém um vídeo de exemplo. Substitua esse exemplo por uma publicação pública conhecida que você pretende estudar. A entrada salva é:

```json
{
  "startUrls": ["https://www.tiktok.com/@zachking/video/7631200623693729038"],
  "maxCommentsPerVideo": 250,
  "includeReplies": false,
  "maxRepliesPerComment": 10
}
```

Colete as linhas públicas corretas

`maxCommentsPerVideo` é o limite de linhas de primeiro nível para uma publicação. Os valores permitidos vão de 1 a 1.000. A Task salva usa 250. No primeiro teste, mude 250 para 3.

`includeReplies` false significa que linhas de resposta não são coletadas. Mantenha false neste teste. `maxRepliesPerComment` é o limite de respostas sob um comentário pai salvo. Os valores permitidos vão de 1 a 100. A Task salva usa 10. Esse limite de respostas não coleta nada enquanto `includeReplies` está false.

Um controle atual usou um limite de primeiro nível de 3. Ele salvou 3 comentários distintos. Cada comentário correspondia à publicação pedida. Cada um tinha texto não vazio, um `authorId` e `createdAt`. Em cada linha, `isReply` era false, `replyDepth` era 0 e `status` era ok. O valor ok significa que um comentário real foi salvo. `replyDepth` 0 significa que a linha é de primeiro nível.

Esse controle sustenta somente uma coleta de primeiro nível. Ele não testou a coleta de respostas. Ele não coletou todos os comentários públicos. Um limite de linhas, ou uma amostra do feed público, não é o conjunto completo de comentários.

## Leia a linha e o resumo de OUTPUT

Guarde o arquivo JSON ou JSONL de origem sem alterações. JSON é o arquivo estruturado do Actor. Guarde também OUTPUT. OUTPUT é o resumo da coleta, não uma linha de comentário.

Guarde estes nomes de OUTPUT:

- `inputsReceived`
- `uniquePostsPlanned`
- `postsAttempted`
- `postsWithRows`
- `commentsWritten`
- `repliesWritten`
- `rowsWritten`
- `stopReasonCounts`
- `failedInputDetails`

Guarde também o detalhe de parada, de status e de limite de cada entrada. Esta lição não inventa esses números de OUTPUT para o controle. A contagem conhecida de comentários salvos é 3. Leia os valores nomeados de OUTPUT no seu próprio arquivo. Não preencha uma contagem desconhecida com 0.

`repliesWritten` exige uma leitura cuidadosa. Um valor salvo de 0 significa que nenhuma linha de resposta foi gravada. Isso não significa que as pessoas não escreveram respostas. As respostas ficaram fora do escopo. Texto de resposta ausente não é evidência zero de conversa.

Todo comentário realmente salvo tem `status` ok. Uma entrada indisponível permanece em OUTPUT. Não crie uma linha falsa de comentário vazio para ela.

Um valor público pode ser null. Null significa que o valor não foi fornecido. O valor false é diferente. False significa que a origem disse não. Não trate false como desconhecido.

`commentIndex` é a posição salva de uma linha. Não é uma pontuação de relevância do TikTok. `replyCount` é uma contagem de respostas. Essa contagem não fornece o texto das respostas.

O Actor pode retornar estas colunas de origem:

- `inputIndex`
- `inputUrl`
- `postUrl`
- `postId`
- `commentId`
- `text`
- `language`
- `createdAt`
- `likesCount`
- `parentCommentId`
- `replyToCommentId`
- `isReply`
- `replyDepth`
- `replyCount`
- `authorId`
- `authorHandle`
- `authorDisplayName`
- `authorUrl`
- `authorVerified`
- `isPinned`
- `isHeartedByCreator`
- `commentIndex`
- `replyIndex`
- `status`
- `scrapedAt`

Você cria mais três colunas. Elas não são colunas de origem.

- `local_record_key` é o id que você vai dar ao NVivo.
- `author_key` é o id do autor copiado como texto, para que as linhas possam ser agrupadas.
- `collection_time` é o horário que você registra no arquivo de trabalho.

Se `collection_time` for uma cópia de `scrapedAt`, anote isso. `selection_note` também é a sua nota. Não é uma coluna de origem. Um `local_record_key` inventado não é um id de comentário verificado. Guarde todo id como texto. Uma planilha pode alterar um número longo quando a coluna é numérica.

O Actor fornece somente texto público. Ele não fornece códigos qualitativos, uma importação do NVivo, casos, uma leitura médica nem uma teoria automática.

## Faça estas oito ações

1. Escreva primeiro as regras do estudo.

Nomeie as publicações públicas conhecidas antes de coletar. Escreva a data de início e a data de fim dos comentários que você vai manter. Escreva a regra de idioma. Escolha comentários de primeiro nível para este método. Um estudo de respostas precisa do próprio teste e de uma escolha posterior explícita. Se `createdAt` estiver fora das suas datas, mantenha essa linha fora da codificação e diga o motivo em `selection_note`. As frases sobre o jardim, mais adiante nesta lição, são ficção comum de jardinagem. Uma amostra de comentários públicos não pode sustentar uma afirmação médica.

1. Teste uma publicação pretendida com um limite de 3.

Use uma publicação real que você já conhece. Defina `maxCommentsPerVideo` como 3. Defina `includeReplies` como false. Depois, inspecione os ids de origem, o texto, `status` e OUTPUT. Um limite de 3 é grande o bastante para ver as colunas reais. É pequeno o bastante para verificar antes de um arquivo grande. O controle verificado sustenta somente este caminho de primeiro nível. Mantenha as respostas não salvas como escopo excluído.

1. Preserve a origem e, depois, faça uma tabela de trabalho plana.

Deixe o arquivo JSON ou JSONL de origem sem alterações. Deixe OUTPUT sem alterações. A tabela de trabalho é uma cópia posterior. Use estas colunas: `local_record_key`, `postId`, `postUrl`, `commentId`, `author_key`, `text`, `createdAt`, `language`, `isReply`, `parentCommentId`, `collection_time` e `selection_note`. Mantenha os ids como texto. Use o `commentId` de origem como `local_record_key` quando ele estiver presente. Se o id de origem estiver ausente, crie `local_record_key` e marque a lacuna em `selection_note`. Essa chave local só identifica a sua linha. Ela não é prova de um id de comentário do TikTok. O arquivo de origem intacto permite verificar esta cópia.

1. Escolha o caso antes de importar.

Um caso é uma unidade que você vai codificar. Neste método, um caso é uma observação de comentário. [Não é uma pessoa](/pt-BR/articles/verificar-se-um-t%C3%B3pico-do-reddit-controla-o-resultado/). Use `local_record_key` como o id único do caso. Mantenha `author_key` e `postId` como colunas de agrupamento. Assim, você pode ler juntos os comentários de uma conta. Você ainda não deve chamar essa conta de pessoa confirmada. Esta escolha controla a contagem. Dois comentários de um mesmo `author_key` são dois casos e um grupo de conta. Eles não são duas pessoas.

1. Prepare uma planilha com colunas estáveis.

Use uma linha de cabeçalho. Mantenha um tipo de valor em cada coluna. Copie o `text` de origem para `raw_text` sem alterações. Coloque qualquer cópia editada em `analysis_text`. Se você ocultar uma palavra privada ou corrigir somente a sua cópia, escreva cada mudança em um registro de mudanças. Se você não mudar nada, escreva "none" nesse registro. Salve um arquivo CSV em UTF-8 com campos entre aspas ou um arquivo do Excel. UTF-8 é uma codificação de texto que preserva letras como é. Um campo entre aspas pode conter uma vírgula, uma aspa ou uma quebra de linha. Teste uma linha que tenha todos esses elementos, mais uma letra que não seja ASCII simples. No Excel, importe as colunas de id como texto. Não remova símbolos significativos dos comentários brutos para que um arquivo abra. Um documento do Word é opcional. Você não precisa dele quando a planilha atende ao estudo.

1. Importe a planilha no NVivo 15 para Windows.

A ajuda do NVivo 15 para Windows chama esta importação de survey. O caminho é Import, depois Survey, depois Excel or Text File. A página de ajuda é [Datasets](https://help-nv.qsrinternational.com/15/win/Content/files/datasets.htm). Selecione o arquivo. Confirme a linha de cabeçalho, a codificação e o separador de colunas. Um separador é o caractere que divide as colunas, muitas vezes uma vírgula. Verifique a pré-visualização. Escolha `local_record_key` como o id único do registro. Marque `analysis_text` como texto aberto, que é o texto que você pode codificar. Marque `postId`, `commentId`, `author_key`, `isReply` e as colunas de tempo como fechadas. Fechado significa que a coluna só classifica a linha. Deixe uma coluna fora do NVivo se a planilha já a armazena. O NVivo pode rotular uma linha como respondent. Neste estudo, esse rótulo ainda significa um comentário. Verifique os menus na sua cópia instalada. Estes nomes pertencem à ajuda documentada do NVivo 15 para Windows. Não os force em todas as versões nem no macOS. O caso do comentário, as regras de código e a auditoria são escolhas do estudo. Não são regras tiradas daquela página do fornecedor.

1. Verifique a importação e importe de novo se o mapa estiver errado.

Conte os registros importados. A contagem deve corresponder à planilha que você pretendia importar. Abra alguns registros. Faça a correspondência exata do id de origem e do texto. A ajuda atual do NVivo 15 para Windows diz que você não pode editar o conteúdo de origem do survey depois da importação. Você também não pode mudar o tipo de análise nem o tipo de dados de uma coluna depois da importação. Se o mapa estiver errado, corrija a planilha. Importe esse arquivo corrigido como uma nova cópia verificada. Nenhum teste real do aplicativo NVivo foi feito. Estas etapas são uma verificação documentada para o leitor. Não são um resultado medido do importador.

1. Codifique um conjunto pequeno à mão antes do conjunto maior.

Escreva cada rótulo de código. Escreva o que o código inclui e o que ele exclui. Guarde um memorando e uma versão da codificação. Quando você ler um trecho curto, mantenha a origem e o caso à vista. Um caso automático por comentário não é um participante independente. Exporte o mapa de código para registro. Confira esse mapa com a planilha. Só então codifique o conjunto maior.

As pessoas perguntam como as linhas de comentário podem entrar no NVivo. Uma pergunta pública é este [comentário em r/CompSocial](https://www.reddit.com/r/CompSocial/comments/1fez5z8/comment/m1vd20x/). Essa pergunta mostra uma necessidade. Ela não mostra que este mapa de casos serve a todos os estudos.

## Verifique um mapa fictício de três linhas

As linhas abaixo são ficção original. Elas são um exemplo de ensino, não um resultado do Actor. Nenhuma palavra real de comentário do controle foi mantida. Não leia estas frases sobre o jardim como texto coletado do TikTok.

A ficção usa duas publicações sobre uma bandeja comum de jardim. A publicação P1 tem dois comentários de primeiro nível. A publicação P2 tem um comentário de primeiro nível. A chave de conta A escreveu o comentário C1 em P1. O texto é "A bandeja é difícil de carregar". A chave de conta A também escreveu o comentário C2 em P1. O texto é "Eu acrescentei uma alça". A chave de conta B escreveu o comentário C3 em P2. O texto é "As instruções ajudaram." As três linhas são de primeiro nível e estão ligadas a uma publicação conhecida. O registro de mudanças de R1, R2 e R3 diz none. `analysis_text` corresponde a essas palavras de origem.

R1, R2 e R3 são três casos de comentário. A e B são duas chaves de conta. As chaves são fatos de agrupamento. Elas não são três pessoas.

### O mapa de origem, de caso e de coluna

| local_record_key | caso | postId (fechado) | commentId (fechado) | author_key (fechado) | isReply (fechado) | analysis_text (aberto) |
| --- | --- | --- | --- | --- | --- | --- |
| R1 | um comentário | P1 | C1 | A | false | A bandeja é difícil de carregar |
| R2 | um comentário | P1 | C2 | A | false | Eu acrescentei uma alça |
| R3 | um comentário | P2 | C3 | B | false | As instruções ajudaram. |

Use `local_record_key` como o id de caso do NVivo. `analysis_text` é a única coluna aberta neste mapa. `postId`, `commentId`, `author_key` e `isReply` são fechados. R1 e R2 compartilham a chave de conta A. Eles continuam sendo dois casos porque a unidade é o comentário. A chave compartilhada permite lê-los juntos.

### O resultado da codificação para esses três casos

Use dois códigos. `handling_problem` significa que quem escreveu diz que o objeto é difícil de segurar ou de mover. `workaround` significa que quem escreveu diz o que mudou para tornar a tarefa mais fácil. Um comentário que só diz que as instruções ajudaram não recebe nenhum dos dois códigos.

| local_record_key | author_key | código | motivo |
| --- | --- | --- | --- |
| R1 | A | handling_problem | A bandeja é difícil de carregar. |
| R2 | A | workaround | Quem escreveu acrescentou uma alça. |
| R3 | B | none | Instruções úteis não cabem em nenhum dos dois códigos. |

As contagens são exatas. Há 3 comentários de pesquisa. Há 2 casos de comentário codificados, R1 e R2. Cada caso codificado tem 1 código. R3 não tem código. A chave de conta A tem 2 comentários ligados. Esses comentários ligados não são 2 pessoas independentes. A linha seguinte não faz parte destas contagens.

### Uma linha separada de teste de arquivo

R-TEST é uma quarta linha inventada. Ela testa vírgulas, aspas, uma quebra de linha e a letra é. Ela não é um comentário de pesquisa. Mantenha-a fora dos 3 comentários de pesquisa. Mantenha-a fora dos 2 casos codificados. Não dê um código a ela.

O texto bruto esperado tem duas linhas:

```text
The note says "café, tray"
Carry it flat.
```

Verifique um mapa fictício de três linhas

Este CSV coloca esse texto em uma coluna entre aspas. A vírgula permanece dentro das aspas. As aspas internas são duplicadas. A quebra de linha é uma quebra de linha real, não os dois caracteres barra e n.

```csv
local_record_key,postId,commentId,author_key,isReply,analysis_text,selection_note
R-TEST,P-TEST,C-TEST,T,false,"The note says ""café, tray""
Carry it flat.",import test only
```

Verifique um mapa fictício de três linhas

Depois de abrir a pré-visualização, o texto deve corresponder às duas linhas acima. A vírgula deve permanecer. As aspas em torno de café, tray devem permanecer. A quebra de linha deve permanecer. O é deve permanecer. `isReply` false nesta linha de teste é false conhecido. Não é um valor desconhecido. Nenhum importador foi executado para este arquivo. Não há resultado medido de importação para R-TEST, R1, R2 ou R3.

## Próxima ação

Substitua o vídeo de exemplo por uma publicação pública conhecida na Task [Export TikTok Comments to CSV or Excel](https://apify.com/chronometrica/tiktok-comments-scraper/examples/export-tiktok-comments-to-csv). Colete com o Actor [TikTok Comments Scraper](https://apify.com/chronometrica/tiktok-comments-scraper). Defina o limite de primeiro nível como 3 e mantenha as respostas desligadas. Importe três linhas fictícias verificadas, ou três linhas verificadas dessa publicação. Verifique o id de origem, o caso e o texto. Codifique uma amostra maior só depois dessa verificação.

## Fontes e leituras adicionais

- [Actor TikTok Comments Scraper](https://apify.com/chronometrica/tiktok-comments-scraper)
- [Task Export TikTok Comments to CSV or Excel](https://apify.com/chronometrica/tiktok-comments-scraper/examples/export-tiktok-comments-to-csv)
- [Ajuda de conjuntos de dados do NVivo 15 para Windows](https://help-nv.qsrinternational.com/15/win/Content/files/datasets.htm)
- [Pergunta pública sobre comentários e o NVivo](https://www.reddit.com/r/CompSocial/comments/1fez5z8/comment/m1vd20x/)