Exporter les commentaires TikTok de premier niveau pour le codage NVivo

Collecter les bonnes lignes publiques

Utilisez le build public 0.1.17. L'entrée `startUrls` accepte de 1 à 100 éléments. Chaque élément doit être une URL complète connue qui contient `/video/` ou `/photo/`, ou un identifiant numérique de publication. Un lien court ne suffit pas. Ouvrez le lien court et copiez d'abord l'URL complète connue.

La Task enregistrée contient une vidéo d'exemple. Remplacez cet exemple par une publication publique connue que vous voulez étudier. L'entrée enregistrée est :

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

`maxCommentsPerVideo` est la limite de lignes de premier niveau pour une publication. Les valeurs permises vont de 1 à 1 000. La Task enregistrée utilise 250. Pour le premier test, changez 250 en 3.

`includeReplies` à false signifie que les lignes de réponse ne sont pas collectées. Laissez cette valeur à false pour ce test. `maxRepliesPerComment` est la limite de réponses sous un commentaire parent enregistré. Les valeurs permises vont de 1 à 100. La Task enregistrée utilise 10. Cette limite de réponses ne collecte rien tant que `includeReplies` est false.

Un contrôle actuel a utilisé une limite de premier niveau de 3. Il a enregistré 3 commentaires distincts. Chaque commentaire correspondait à la publication demandée. Chacun avait un texte non vide, un `authorId` et un `createdAt`. Sur chaque ligne, `isReply` était false, `replyDepth` était 0 et `status` était ok. La valeur ok signifie qu'un vrai commentaire a été enregistré. `replyDepth` à 0 signifie que la ligne est de premier niveau.

Ce contrôle ne couvre qu'une collecte de premier niveau. Il n'a pas testé la collecte des réponses. Il n'a pas collecté tous les commentaires publics. Une limite de lignes, ou un échantillon de fil public, n'est pas l'ensemble complet des commentaires.

Lire la ligne et le résumé OUTPUT

Conservez le fichier source JSON ou JSONL sans le modifier. JSON est le fichier structuré qui vient de l'Actor. Conservez aussi OUTPUT. OUTPUT est le résumé de la collecte, pas une ligne de commentaire.

Conservez ces noms OUTPUT :

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

Conservez aussi le détail d'arrêt, de statut et de limite pour chaque entrée. Cette leçon n'invente pas ces nombres OUTPUT pour le contrôle. Le nombre connu de commentaires enregistrés est 3. Lisez les valeurs OUTPUT nommées sur votre propre fichier. Ne remplacez pas un nombre inconnu par 0.

`repliesWritten` demande une lecture attentive. Une valeur enregistrée de 0 signifie qu'aucune ligne de réponse n'a été écrite. Elle ne signifie pas que les personnes n'ont écrit aucune réponse. Les réponses ont été laissées hors du périmètre. L'absence du texte des réponses ne montre pas qu'aucune conversation n'a eu lieu.

Chaque commentaire réellement enregistré a le `status` ok. Une entrée indisponible reste dans OUTPUT. Ne créez pas une fausse ligne de commentaire vide pour elle.

Une valeur publique peut être null. Null signifie que la valeur n'a pas été fournie. La valeur false est différente. False signifie que la source a dit non. Ne traitez pas false comme une valeur inconnue.

`commentIndex` est la position enregistrée d'une ligne. Ce n'est pas un score de pertinence de TikTok. `replyCount` est un nombre de réponses. Ce nombre ne fournit pas le texte des réponses.

L'Actor peut renvoyer ces colonnes de source :

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

Vous créez trois colonnes de plus. Ce ne sont pas des colonnes de source.

• `local_record_key` est l'identifiant que vous donnerez à NVivo.
• `author_key` est l'identifiant d'auteur copié comme texte, afin de pouvoir regrouper les lignes.
• `collection_time` est l'heure que vous notez sur le fichier de travail.

Si `collection_time` est une copie de `scrapedAt`, écrivez-le. `selection_note` est aussi votre note. Ce n'est pas une colonne de source. Un `local_record_key` inventé n'est pas un identifiant de commentaire vérifié. Stockez chaque identifiant comme du texte. Un tableur peut modifier un nombre long quand une colonne est numérique.

L'Actor fournit seulement le texte public. Il ne fournit pas de codes qualitatifs, d'import NVivo, de cas, de lecture médicale ni de théorie automatique.

Faites ces huit actions

1. Écrivez d'abord les règles de l'étude.

Nommez les publications publiques connues avant de collecter. Écrivez la date de début et la date de fin des commentaires que vous garderez. Écrivez la règle de langue. Choisissez les commentaires de premier niveau pour cette méthode. Une étude des réponses demande son propre test et un choix explicite plus tard. Si `createdAt` est en dehors de vos dates, laissez cette ligne hors du codage et dites pourquoi dans `selection_note`. Les phrases sur le jardin, plus loin dans cette leçon, sont une fiction de jardinage ordinaire. Un échantillon de commentaires publics ne peut pas appuyer une affirmation médicale.

1. Testez une publication prévue avec une limite de 3.

Utilisez une vraie publication que vous connaissez déjà. Réglez `maxCommentsPerVideo` sur 3. Réglez `includeReplies` sur false. Examinez ensuite les identifiants de source, le texte, `status` et OUTPUT. Une limite de 3 est assez grande pour voir les vraies colonnes. Elle est assez petite pour vérifier avant un gros fichier. Le contrôle vérifié ne couvre que ce chemin de premier niveau. Conservez les réponses non enregistrées comme un périmètre exclu.

1. Conservez la source, puis faites un tableau de travail à plat.

Laissez le fichier source JSON ou JSONL inchangé. Laissez OUTPUT inchangé. Le tableau de travail est une copie ultérieure. Utilisez ces colonnes : `local_record_key`, `postId`, `postUrl`, `commentId`, `author_key`, `text`, `createdAt`, `language`, `isReply`, `parentCommentId`, `collection_time` et `selection_note`. Conservez les identifiants comme du texte. Utilisez le `commentId` de la source comme `local_record_key` quand il est présent. Si l'identifiant de source manque, créez `local_record_key` et signalez le manque dans `selection_note`. Cette clé locale ne désigne que votre ligne. Elle ne prouve pas un identifiant de commentaire TikTok. Le fichier source non modifié vous permet de vérifier cette copie.

1. Choisissez le cas avant l'import.

Un cas est une unité que vous allez coder. Dans cette méthode, un cas est une observation de commentaire. Ce n'est pas une personne. Utilisez `local_record_key` comme identifiant unique du cas. Conservez `author_key` et `postId` comme colonnes de regroupement. Vous pouvez alors lire ensemble les commentaires d'un compte. Vous ne devez toujours pas appeler ce compte une personne confirmée. Ce choix commande le décompte. Deux commentaires d'un même `author_key` sont deux cas et un groupe de compte. Ce ne sont pas deux personnes.

1. Préparez une feuille de calcul avec des colonnes stables.

Utilisez une seule ligne d'en-tête. Conservez un seul type de valeur dans chaque colonne. Copiez le `text` de la source dans `raw_text` sans changement. Placez toute copie modifiée dans `analysis_text`. Si vous masquez un mot privé ou si vous corrigez seulement votre copie, écrivez chaque changement dans un journal des modifications. Si vous ne changez rien, écrivez "none" dans ce journal. Enregistrez un fichier CSV UTF-8 avec champs entre guillemets, ou un fichier Excel. UTF-8 est un encodage de texte qui conserve des lettres comme é. Un champ entre guillemets peut contenir une virgule, un guillemet ou un saut de ligne. Testez une ligne qui contient tout cela, plus une lettre qui n'est pas de l'ASCII simple. Dans Excel, importez les colonnes d'identifiants comme du texte. Ne retirez pas les symboles significatifs des commentaires bruts pour qu'un fichier s'ouvre. Un document Word est facultatif. Vous n'en avez pas besoin quand la feuille de calcul convient à l'étude.

1. Importez la feuille de calcul dans NVivo 15 pour Windows.

L'aide de NVivo 15 pour Windows appelle cet import un jeu de données d'enquête. Le chemin est Import, puis Survey, puis Excel ou Text File. La page d'aide est Datasets. Sélectionnez le fichier. Confirmez la ligne d'en-tête, l'encodage et le séparateur de colonnes. Un séparateur est le caractère qui divise les colonnes, souvent une virgule. Vérifiez l'aperçu. Choisissez `local_record_key` comme identifiant unique d'enregistrement. Marquez `analysis_text` comme texte ouvert, c'est-à-dire un texte que vous pouvez coder. Marquez `postId`, `commentId`, `author_key`, `isReply` et les colonnes de temps comme fermés. Fermé signifie que la colonne ne fait que classer la ligne. Laissez une colonne hors de NVivo si la feuille de calcul la stocke déjà. NVivo peut étiqueter une ligne comme un répondant. Dans cette étude, cette étiquette signifie encore un commentaire. Vérifiez les menus sur votre copie installée. Ces noms appartiennent à l'aide documentée de NVivo 15 pour Windows. Ne les imposez pas à chaque version ni à macOS. Le cas du commentaire, les règles de code et l'audit sont des choix d'étude. Ce ne sont pas des règles prises sur cette page du fournisseur.

1. Vérifiez l'import, et réimportez si la correspondance est fausse.

Comptez les enregistrements importés. Le nombre doit correspondre à la feuille de calcul que vous vouliez importer. Ouvrez quelques enregistrements. Faites correspondre exactement l'identifiant de source et le texte. L'aide actuelle de NVivo 15 pour Windows dit que vous ne pouvez pas modifier le contenu source du jeu de données d'enquête après l'import. Vous ne pouvez pas non plus changer le type d'analyse ou le type de données d'une colonne après l'import. Si la correspondance est fausse, corrigez la feuille de calcul. Importez ce fichier corrigé comme une nouvelle copie vérifiée. Aucun test réel de l'application NVivo n'a été fait. Ces étapes sont une vérification documentée pour le lecteur. Elles ne sont pas un résultat mesuré de l'import.

1. Codez un petit ensemble à la main avant l'ensemble plus grand.

Écrivez chaque étiquette de code. Écrivez ce que le code inclut et ce qu'il exclut. Conservez un mémo et une version de codage. Quand vous lisez un court extrait, gardez sa source et son cas en vue. Un cas automatique par commentaire n'est pas un participant indépendant. Exportez la correspondance entre les codes et les enregistrements. Vérifiez-la avec la feuille de calcul. Seulement ensuite, codez l'ensemble plus grand.

Des personnes demandent comment des lignes de commentaires peuvent entrer dans NVivo. Une question publique est ce commentaire r/CompSocial. Cette question montre un besoin. Elle ne montre pas que cette correspondance de cas convient à chaque étude.

Vérifiez une correspondance fictive de trois lignes

Les lignes ci-dessous sont une fiction originale. Elles sont un exemple pédagogique, pas un résultat de l'Actor. Aucun mot réel de commentaire n'a été conservé à partir du contrôle. Ne lisez pas ces phrases sur le jardin comme du texte TikTok collecté.

La fiction utilise deux publications sur un plateau de jardin ordinaire. La publication P1 a deux commentaires de premier niveau. La publication P2 a un commentaire de premier niveau. La clé de compte A a écrit le commentaire C1 sur P1. Le texte est « Le plateau est difficile à porter ». La clé de compte A a aussi écrit le commentaire C2 sur P1. Le texte est « J'ai ajouté une poignée ». La clé de compte B a écrit le commentaire C3 sur P2. Le texte est « Les instructions ont aidé. » Les trois lignes sont de premier niveau et liées à une publication connue. Le journal des modifications de R1, R2 et R3 indique none. `analysis_text` correspond à ces mots de source.

R1, R2 et R3 sont trois cas de commentaire. A et B sont deux clés de compte. Les clés sont des faits de regroupement. Elles ne sont pas trois personnes.

La correspondance entre la source, le cas et les colonnes

Utilisez `local_record_key` comme identifiant de cas NVivo. `analysis_text` est la seule colonne ouverte dans cette correspondance. `postId`, `commentId`, `author_key` et `isReply` sont fermés. R1 et R2 partagent la clé de compte A. Ils restent deux cas, car l'unité est le commentaire. La clé partagée permet de les lire ensemble.

Le résultat de codage pour ces trois cas

Utilisez deux codes. `handling_problem` signifie que l'auteur dit que l'objet est difficile à tenir ou à déplacer. `workaround` signifie que l'auteur dit ce qu'il a changé pour rendre la tâche plus facile. Un commentaire qui dit seulement que les instructions ont aidé ne reçoit aucun des deux codes.

Les décomptes sont exacts. Il y a 3 commentaires de recherche. Il y a 2 cas de commentaire codés, R1 et R2. Chaque cas codé a 1 code. R3 n'a aucun code. La clé de compte A a 2 commentaires liés. Ces commentaires liés ne sont pas 2 personnes indépendantes. La ligne suivante ne fait pas partie de ces décomptes.

Une ligne distincte de test de fichier

R-TEST est une quatrième ligne inventée. Elle teste les virgules, les guillemets, un saut de ligne et la lettre é. Ce n'est pas un commentaire de recherche. Laissez-la en dehors des 3 commentaires de recherche. Laissez-la en dehors des 2 cas codés. Ne lui donnez pas de code.

Le texte brut attendu a deux lignes :

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

Ce CSV place ce texte dans une seule colonne entre guillemets. La virgule reste à l'intérieur des guillemets. Les guillemets intérieurs sont doublés. Le saut de ligne est un vrai saut de ligne, pas les deux caractères barre oblique et n.

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

Après l'ouverture de l'aperçu, le texte doit correspondre aux deux lignes ci-dessus. La virgule doit rester. Les guillemets autour de café, tray doivent rester. Le saut de ligne doit rester. Le é doit rester. `isReply` à false sur cette ligne de test est un false connu. Ce n'est pas une valeur inconnue. Aucun import n'a été exécuté pour ce fichier. Il n'y a pas de résultat d'import mesuré pour R-TEST, R1, R2 ou R3.