

# Exportar comentarios de primer nivel de TikTok para codificar en NVivo

Exporte cada comentario de primer nivel de TikTok como una fila de la tabla. Importe ese texto en NVivo como contenido que puede codificar. Conserve cada identificador de origen junto al texto.

Un comentario de primer nivel es un comentario en la publicación. Una respuesta es un texto publicado para contestar un comentario. Estos pasos usan solo comentarios de primer nivel.

Un identificador de origen es el nombre público de una publicación, un comentario o un autor. NVivo es un programa que guarda texto para la codificación manual. La codificación cualitativa significa que usted marca el texto con una etiqueta con nombre y escribe el motivo.

Un Actor es un programa alojado que recopila datos. Una Task es un ajuste de entrada guardado para un Actor. El Actor [TikTok Comments Scraper](https://apify.com/chronometrica/tiktok-comments-scraper) recopila filas de origen públicas. Usted hace la codificación. El Actor no crea códigos, casos ni un archivo de NVivo.

La Task pública [Export TikTok Comments to CSV or Excel](https://apify.com/chronometrica/tiktok-comments-scraper/examples/export-tiktok-comments-to-csv) se comprobó el 13 de octubre de 2026. Una Task pública es solo una entrada inicial. No significa que el análisis se haga solo.

## Recopile las filas públicas correctas

Use la compilación pública 0.1.17. La entrada `startUrls` acepta de 1 a 100 elementos. Cada elemento debe ser una URL completa conocida que contenga `/video/` o `/photo/`, o un identificador numérico de publicación. Un enlace corto no basta. Abra el enlace corto y copie primero la URL completa conocida.

La Task guardada contiene un video de ejemplo. Reemplace ese ejemplo por una publicación pública conocida que quiera estudiar. La entrada guardada es:

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

Recopile las filas públicas correctas

`maxCommentsPerVideo` es el límite de filas de primer nivel para una publicación. Los valores permitidos van de 1 a 1.000. La Task guardada usa 250. Para la primera prueba, cambie 250 por 3.

`includeReplies` en false significa que no se recopilan filas de respuesta. Déjelo en false para esta prueba. `maxRepliesPerComment` es el límite de respuestas bajo un comentario padre guardado. Los valores permitidos van de 1 a 100. La Task guardada usa 10. Ese límite de respuestas no recopila nada mientras `includeReplies` está en false.

Un control actual usó un límite de primer nivel de 3. Guardó 3 comentarios distintos. Cada comentario coincidió con la publicación pedida. Cada uno tenía texto no vacío, un `authorId` y `createdAt`. En cada fila, `isReply` era false, `replyDepth` era 0 y `status` era ok. El valor ok significa que se guardó un comentario real. `replyDepth` 0 significa que la fila es de primer nivel.

Ese control solo respalda una recopilación de primer nivel. No probó la recopilación de respuestas. No recopiló todos los comentarios públicos. Un límite de filas, o una muestra del feed público, no es el conjunto completo de comentarios.

## Lea la fila y el resumen de OUTPUT

Conserve sin cambios el archivo JSON o JSONL de origen. JSON es el archivo estructurado que proviene del Actor. Conserve también OUTPUT. OUTPUT es el resumen de la recopilación, no una fila de comentario.

Conserve estos nombres de OUTPUT:

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

Conserve también el detalle de parada, estado y límite de cada entrada. Esta lección no inventa esos números de OUTPUT para el control. El recuento conocido de comentarios guardados es 3. Lea los valores de OUTPUT con nombre en su propio archivo. No rellene un recuento desconocido con 0.

`repliesWritten` exige una lectura cuidadosa. Un valor guardado de 0 significa que no se escribieron filas de respuesta. No significa que las personas no hayan escrito respuestas. Las respuestas quedaron fuera del alcance. La falta del texto de las respuestas no es evidencia de que la conversación sea cero.

Todo comentario realmente guardado tiene `status` ok. Una entrada no disponible permanece en OUTPUT. No cree para ella una fila de comentario vacía y falsa.

Un valor público puede ser null. Null significa que el valor no se suministró. El valor false es distinto. False significa que el origen dijo que no. No trate false como un valor desconocido.

`commentIndex` es la posición guardada de una fila. No es una puntuación de relevancia de TikTok. `replyCount` es un recuento de respuestas. Ese recuento no aporta el texto de las respuestas.

El Actor puede devolver estas columnas de origen:

- `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`

Usted crea tres columnas más. No son columnas de origen.

- `local_record_key` es el identificador que le dará a NVivo.
- `author_key` es el identificador del autor copiado como texto, para poder agrupar las filas.
- `collection_time` es la hora que usted registra en el archivo de trabajo.

Si `collection_time` es una copia de `scrapedAt`, anótelo. `selection_note` también es su nota. No es una columna de origen. Un `local_record_key` inventado no es un identificador de comentario verificado. Guarde cada identificador como texto. Una hoja de cálculo puede cambiar un número largo cuando una columna es numérica.

El Actor solo aporta texto público. No aporta códigos cualitativos, una importación de NVivo, casos, una lectura médica ni una teoría automática.

## Haga estas ocho acciones

1. Escriba primero las reglas del estudio.

Nombre las publicaciones públicas conocidas antes de recopilar. Escriba la fecha de inicio y la fecha de fin de los comentarios que va a conservar. Escriba la regla de idioma. Elija comentarios de primer nivel para este método. Un estudio de respuestas necesita su propia prueba y una elección explícita posterior. Si `createdAt` queda fuera de sus fechas, deje esa fila fuera de la codificación y diga por qué en `selection_note`. Las oraciones sobre el jardín, más adelante en esta lección, son ficción ordinaria de jardinería. Una muestra de comentarios públicos no puede sostener una afirmación médica.

1. Pruebe una publicación prevista con un límite de 3.

Use una publicación real que ya conozca. Ponga `maxCommentsPerVideo` en 3. Ponga `includeReplies` en false. Después revise los identificadores de origen, el texto, `status` y OUTPUT. Un límite de 3 es lo bastante grande para ver las columnas reales. Es lo bastante pequeño para comprobarlo antes de un archivo grande. El control comprobado solo respalda esta vía de primer nivel. Mantenga las respuestas no guardadas como alcance excluido.

1. Conserve el origen y después haga una tabla de trabajo plana.

Deje sin cambios el archivo JSON o JSONL de origen. Deje OUTPUT sin cambios. La tabla de trabajo es una copia posterior. Use estas columnas: `local_record_key`, `postId`, `postUrl`, `commentId`, `author_key`, `text`, `createdAt`, `language`, `isReply`, `parentCommentId`, `collection_time` y `selection_note`. Conserve los identificadores como texto. Use el `commentId` de origen como `local_record_key` cuando esté presente. Si falta el identificador de origen, cree `local_record_key` y marque esa falta en `selection_note`. Esa clave local solo identifica su fila. No es prueba de un identificador de comentario de TikTok. El archivo de origen intacto le permite comprobar esta copia.

1. Elija el caso antes de importar.

Un caso es una unidad que va a codificar. En este método, un caso es una observación de un comentario. [No es una persona](/es/articles/comprobar-si-un-hilo-de-reddit-controla-el-resultado/). Use `local_record_key` como identificador único del caso. Conserve `author_key` y `postId` como columnas de agrupación. Así puede leer juntos los comentarios de una cuenta. Igual no debe llamar a esa cuenta una persona confirmada. Esta elección controla el recuento. Dos comentarios de una misma `author_key` son dos casos y un grupo de cuenta. No son dos personas.

1. Prepare una hoja de cálculo con columnas estables.

Use una fila de encabezados. Conserve un solo tipo de valor en cada columna. Copie el `text` de origen en `raw_text` sin cambios. Ponga cualquier copia editada en `analysis_text`. Si oculta una palabra privada o corrige solo su copia, escriba cada cambio en un registro de cambios. Si no cambia nada, escriba "none" en ese registro. Guarde un archivo CSV en UTF-8 con campos entre comillas, o un archivo de Excel. UTF-8 es una codificación de texto que conserva letras como é. Un campo entre comillas puede contener una coma, unas comillas o un salto de línea. Pruebe una fila que tenga todo eso, más una letra que no sea ASCII simple. En Excel, importe las columnas de identificadores como texto. No quite símbolos significativos de los comentarios sin procesar para que un archivo se abra. Un documento de Word es opcional. No lo necesita cuando la hoja de cálculo se ajusta al estudio.

1. Importe la hoja de cálculo en NVivo 15 para Windows.

La ayuda de NVivo 15 para Windows llama encuesta a esta importación. La ruta es Import, después Survey y después Excel or Text File. La página de ayuda es [Datasets](https://help-nv.qsrinternational.com/15/win/Content/files/datasets.htm). Seleccione el archivo. Confirme la fila de encabezados, la codificación y el separador de columnas. Un separador es el carácter que divide las columnas, a menudo una coma. Revise la vista previa. Elija `local_record_key` como identificador único de registro. Marque `analysis_text` como texto abierto, que es texto que puede codificar. Marque `postId`, `commentId`, `author_key`, `isReply` y las columnas de tiempo como cerradas. Cerrada significa que la columna solo clasifica la fila. Deje una columna fuera de NVivo si la hoja de cálculo ya la almacena. NVivo puede etiquetar una fila como encuestado. En este estudio, esa etiqueta sigue significando un comentario. Revise los menús de su copia instalada. Estos nombres pertenecen a la ayuda documentada de NVivo 15 para Windows. No los fuerce en todas las versiones ni en macOS. El caso del comentario, las reglas de los códigos y la auditoría son elecciones del estudio. No son reglas tomadas de esa página del proveedor.

1. Compruebe la importación y vuelva a importar si el mapa es incorrecto.

Cuente los registros importados. El recuento debe coincidir con la hoja de cálculo que quería importar. Abra algunos registros. Haga coincidir exactamente el identificador de origen y el texto. La ayuda actual de NVivo 15 para Windows dice que no se puede editar el contenido de origen de la encuesta después de importar. Tampoco se puede cambiar el tipo de análisis ni el tipo de datos de una columna después de importar. Si el mapa es incorrecto, corrija la hoja de cálculo. Importe ese archivo corregido como una nueva copia comprobada. No se hizo ninguna prueba real de la aplicación NVivo. Estos pasos son una comprobación documentada para quien lee. No son un resultado medido del importador.

1. Codifique a mano un conjunto pequeño antes del conjunto más grande.

Escriba cada etiqueta de código. Escriba qué incluye el código y qué excluye. Conserve un memorando y una versión de la codificación. Cuando lea un fragmento breve, tenga a la vista su origen y su caso. Un caso automático por comentario no es un participante independiente. Exporte el mapa de código a registro. Compruébelo contra la hoja de cálculo. Solo entonces codifique el conjunto más grande.

La gente pregunta cómo pueden entrar en NVivo las filas de comentarios. Una pregunta pública es este [comentario de r/CompSocial](https://www.reddit.com/r/CompSocial/comments/1fez5z8/comment/m1vd20x/). Esa pregunta muestra una necesidad. No muestra que este mapa de casos sirva para todos los estudios.

## Compruebe un mapa ficticio de tres filas

Las filas de abajo son ficción original. Son un ejemplo para enseñar, no un resultado del Actor. No se conservó ninguna palabra real de comentario del control. No lea estas oraciones sobre el jardín como texto recopilado de TikTok.

La ficción usa dos publicaciones sobre una bandeja de jardín común. La publicación P1 tiene dos comentarios de primer nivel. La publicación P2 tiene un comentario de primer nivel. La clave de cuenta A escribió el comentario C1 en P1. El texto es "La bandeja es difícil de llevar". La clave de cuenta A también escribió el comentario C2 en P1. El texto es "Agregué un asa". La clave de cuenta B escribió el comentario C3 en P2. El texto es "Las instrucciones ayudaron." Las tres filas son de primer nivel y están vinculadas a una publicación conocida. El registro de cambios de R1, R2 y R3 dice none. `analysis_text` coincide con esas palabras de origen.

R1, R2 y R3 son tres casos de comentario. A y B son dos claves de cuenta. Las claves son datos de agrupación. No son tres personas.

### El mapa de origen, caso y columnas

| local_record_key | caso | postId (cerrada) | commentId (cerrada) | author_key (cerrada) | isReply (cerrada) | analysis_text (abierta) |
| --- | --- | --- | --- | --- | --- | --- |
| R1 | un comentario | P1 | C1 | A | false | La bandeja es difícil de llevar |
| R2 | un comentario | P1 | C2 | A | false | Agregué un asa |
| R3 | un comentario | P2 | C3 | B | false | Las instrucciones ayudaron. |

Use `local_record_key` como identificador de caso de NVivo. `analysis_text` es la única columna abierta de este mapa. `postId`, `commentId`, `author_key` e `isReply` son cerradas. R1 y R2 comparten la clave de cuenta A. Siguen siendo dos casos porque la unidad es el comentario. La clave compartida permite leerlos juntos.

### El resultado de codificación de esos tres casos

Use dos códigos. `handling_problem` significa que quien escribe dice que el objeto es difícil de sostener o de mover. `workaround` significa que quien escribe dice qué cambió para hacer la tarea más fácil. Un comentario que solo dice que las instrucciones ayudaron no recibe ninguno de los dos códigos.

| local_record_key | author_key | código | motivo |
| --- | --- | --- | --- |
| R1 | A | handling_problem | La bandeja es difícil de llevar. |
| R2 | A | workaround | Quien escribe agregó un asa. |
| R3 | B | none | Las instrucciones útiles no entran en ninguno de los dos códigos. |

Los recuentos son exactos. Hay 3 comentarios de investigación. Hay 2 casos de comentario codificados, R1 y R2. Cada caso codificado tiene 1 código. R3 no tiene código. La clave de cuenta A tiene 2 comentarios vinculados. Esos comentarios vinculados no son 2 personas independientes. La fila siguiente no forma parte de estos recuentos.

### Una fila aparte de prueba del archivo

R-TEST es una cuarta fila inventada. Prueba comas, comillas, un salto de línea y la letra é. No es un comentario de investigación. Déjela fuera de los 3 comentarios de investigación. Déjela fuera de los 2 casos codificados. No le asigne un código.

El texto sin procesar esperado tiene dos líneas:

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

Compruebe un mapa ficticio de tres filas

Este CSV pone ese texto en una sola columna entre comillas. La coma queda dentro de las comillas. Las comillas internas están duplicadas. El salto de línea es un salto de línea real, no los dos caracteres barra y 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
```

Compruebe un mapa ficticio de tres filas

Después de abrir la vista previa, el texto debe coincidir con las dos líneas de arriba. La coma debe permanecer. Las comillas alrededor de café, tray deben permanecer. El salto de línea debe permanecer. La é debe permanecer. `isReply` false en esta fila de prueba es un false conocido. No es un valor desconocido. No se ejecutó ningún importador para este archivo. No hay un resultado de importación medido para R-TEST, R1, R2 ni R3.

## Siguiente acción

Reemplace el video de ejemplo por una publicación pública conocida en la Task [Export TikTok Comments to CSV or Excel](https://apify.com/chronometrica/tiktok-comments-scraper/examples/export-tiktok-comments-to-csv). Recopile con el Actor [TikTok Comments Scraper](https://apify.com/chronometrica/tiktok-comments-scraper). Ponga el límite de primer nivel en 3 y deje las respuestas desactivadas. Importe tres filas ficticias comprobadas, o tres filas comprobadas de esa publicación. Verifique el identificador de origen, el caso y el texto. Codifique una muestra más grande solo después de esa comprobación.

## Fuentes y lecturas adicionales

- [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)
- [Ayuda de conjuntos de datos de NVivo 15 para Windows](https://help-nv.qsrinternational.com/15/win/Content/files/datasets.htm)
- [Pregunta pública sobre comentarios y NVivo](https://www.reddit.com/r/CompSocial/comments/1fez5z8/comment/m1vd20x/)