Comment gérer les traductions en masse avec un CSV
Vous devez disposer d’un compte Klaviyo payant et avoir activé les Traductions intelligentes pour utiliser cette fonctionnalité.
Gérez les traductions en dehors de Klaviyo en exportant et en modifiant un fichier CSV, puis en le réimportant pour mettre à jour les traductions en masse ou collaborer avec d’autres personnes.
Exporter un fichier CSV de vos traductions
Suivez les étapes ci-dessous pour exporter les traductions actuelles d’un seul message :
- Ouvrez le message que vous souhaitez mettre à jour (e-mail de campagne, e-mail de flux, SMS, message WhatsApp, etc.).
- Cliquez sur Traduire pour ouvrir l’éditeur de traduction.
- Dans l’éditeur de traduction, ouvrez le menu des actions et cliquez sur Exporter au format CSV.
- Dans la fenêtre modale d’exportation, vous avez la possibilité de choisir entre un Smarting CSV ou un CSV
Exportation d’un CSV Smartling
- Votre navigateur télécharge un fichier CSV qui inclut :
- Les directives Smartling par défaut suivantes :
- # smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE - block_id – l’identifiant unique de chaque chaîne traduisible dans ce message.
- Code de langue source (par exemple, en) – le texte source d’origine de cette chaîne.
Vous pouvez utiliser ce fichier tel quel pour importer vos chaînes dans Smartling. Smartling analyse automatiquement le CSV, extrait les chaînes et vous permet de déclencher des tâches de traduction.
Une fois la tâche terminée, téléchargez le CSV obtenu et importez-le à nouveau à l’aide du bouton Importer.
Exporter un CS simple
- Votre navigateur télécharge un fichier CSV qui inclut :
- block_id – l’identifiant unique de chaque chaîne traduisible dans ce message.
- source - texte source d’origine de cette chaîne.
- Colonnes de langue – une colonne par langue, nommée avec son code de langue (par exemple, en, fr, es-MX).
Vous pouvez désormais ouvrir ce fichier dans Excel, Google Sheets ou un autre éditeur de feuilles de calcul.
Mettre à jour le CSV
Lorsque vous modifiez le CSV, vous devez uniquement travailler dans les colonnes de langue.
Ne modifiez, n’ajoutez ni ne supprimez aucune valeur dans la colonne block_id. Si une ligne comporte un block_id non valide ou manquant, cette ligne est ignorée lors de l’importation et ses traductions ne sont pas mises à jour.
Ce que vous pouvez modifier en toute sécurité
Dans le fichier CSV :
- Mettez à jour les traductions existantes en modifiant la colonne de langue appropriée.
- Ajoutez les traductions manquantes en remplissant les cellules vides d’une colonne de langue.
- Laissez les valeurs d’une langue inchangées si vous ne souhaitez pas mettre à jour cette langue.
- Ajoutez une ou plusieurs nouvelles colonnes de langue:
- Utilisez un code de langue BCP-47 valide (par exemple, fr-CA, de, ca).
- Lors de l’importation, ces langues sont ajoutées à l’éditeur de traduction pour ce message si elles sont prises en charge.
Ce que vous ne devez pas modifier
Évitez ce qui suit :
- Ne modifiez ni ne supprimez les valeurs block_id.
- N’ajoutez pas de lignes. Chaque ligne doit continuer à correspondre à une chaîne traduisible existante dans le message.
- Ne modifiez pas les valeurs source dans le CSV :
- Pour modifier le contenu source, modifiez le message directement dans l’éditeur Klaviyo, puis exportez un nouveau fichier CSV.
- Ne renommez pas les colonnes requises (block_id, source et les colonnes de langue).
- Ne modifiez pas le format du fichier:
- Conservez le fichier au format .csv .p8.
- Enregistrez avec l’encodage UTF‐8.
Gestion des cellules vides
Si vous effacez une cellule de traduction dans le CSV et que vous la laissez vide :
- L’importation traite cette chaîne vide comme une valeur.
- La traduction existante pour cette cellule est remplacée par une valeur vide. Cela peut supprimer une traduction.
Si vous souhaitez éviter de modifier une traduction, conservez sa valeur existante dans le CSV ou supprimez entièrement cette colonne de langue avant l’importation.
Lorsque vous avez terminé les modifications, enregistrez le fichier en tant que fichier .csv encodé en UTF-8.
Importer le fichier CSV
Après avoir mis à jour et enregistré votre CSV :
- Revenez à l’éditeur de traduction pour le même message.
- Cliquez sur Importer un fichier CSV.
- Dans la fenêtre modale d’importation, soit :
- Cliquez sur Sélectionner un fichier et choisissez votre CSV, ou
- Faites un glisser-déposer de votre CSV dans la zone de téléchargement.
- Klaviyo exécute un « dry run » de validation et affiche :
- Un récapitulatif du nombre de lignes qui seront mises à jour, inchangées ou ignorées
- Tous les avertissements ou erreurs qu’il a détectés
- Examinez attentivement le récapitulatif et les avertissements.
- Si tout semble correct, cliquez sur Importer pour appliquer les modifications.
Lors de la validation, Klaviyo vérifie également :
- Limites de taille de fichier et de nombre de lignes (par exemple, les fichiers de plus de 10 Mo seront rejetés).
- Colonnes obligatoires (telles que block_id, source et au moins une colonne de langue).
- Codes de langue qui ne sont pas reconnus ou qui ne sont pas pris en charge par le canal.
- Valeurs de traduction vides et autres problèmes potentiels.
Si la validation échoue, vous voyez un message d’erreur et pouvez sélectionner un nouveau fichier sans apporter de modifications à vos traductions.
Comprendre les résultats d’importation
Après la validation, le récapitulatif d’importation indique ce qui se passera si vous continuez.
Totaux récapitulatifs
Le résumé peut inclure des décomptes tels que :
- Mis à jour – le nombre de lignes pour lesquelles au moins une valeur de traduction changera.
- Inchangées lignes qui sont présentes dans le fichier CSV, mais où toutes les valeurs correspondent à ce qui est déjà stocké.
- Ignorées/ignorées – lignes qui ne seront pas importées (par exemple, parce que le block_id n’existe pas dans ce message ou que des données requises sont manquantes).
Les nombres sont calculés par ligne, et non par langue. Par exemple, si un CSV comporte deux lignes et deux colonnes de langue :
- Si une ligne est mise à jour dans une langue, le nombre Mis à jour est de 1.
- Si une ligne est mise à jour dans les deux langues, le décompte Mis à jour reste de 1.
- Si les deux lignes sont mises à jour dans une ou plusieurs langues, le nombre Mis à jour est de 2.
Bonnes pratiques
Pour que vos données de traduction restent exactes et faciles à gérer :
- Commencez à partir de la dernière exportation. Évitez de réutiliser d’anciens fichiers CSV, en particulier après avoir modifié le contenu ou les langues du message.
- Conservez une sauvegarde de chaque exportation. Enregistrez une copie du CSV avant de faire des modifications afin de pouvoir revenir en arrière si nécessaire.
- Coordonnez-vous avec les traducteurs. Expliquez quelles colonnes ils peuvent modifier (uniquement les colonnes de langue) et quelles colonnes ils ne doivent pas changer (block_id, source).
- Travaillez par lots plus petits si nécessaire. Si votre fichier est très volumineux, envisagez de répartir le travail sur plusieurs messages ou d’exécuter plusieurs importations plus petites.
- Utilisez des codes de langue pris en charge. Lorsque vous ajoutez de nouvelles colonnes de langue, utilisez des codes BCP-47 pris en charge provenant de l’article Traductions intelligentes afin d’éviter les langues « non traitables ».
Résoudre les avertissements de validation et les erreurs d’importation
Si vous voyez des avertissements ou des erreurs pendant la validation de l’importation, consultez les sections ci-dessous pour comprendre ce qu’ils signifient et comment les corriger.
"Des colonnes obligatoires sont manquantes."
Ce que cela signifie : une ou plusieurs colonnes obligatoires (block_id ou source) sont manquantes ou ont été renommées.
Que faire : Assurez-vous que le fichier CSV inclut les colonnes block_id et source. Si vous avez copié des données dans une nouvelle feuille, confirmez que la ligne d’en-tête correspond à l’exportation d’origine.
"Vous avez des valeurs de traduction vides. Les chaînes vides seront traitées comme des valeurs."
Ce que cela signifie : Votre CSV contient des valeurs de traduction vides, et les chaînes vides seront traitées comme des valeurs.
Que faire : si vous continuez, ces cellules vides écraseront toutes les traductions existantes pour cette clé et cette langue. Si vous souhaitez laisser ces traductions inchangées, restaurez les valeurs précédentes ou supprimez cette colonne de langue et réimportez le fichier.
"<count> clé(s) n’existe(nt) pas dans votre projet et ne sera(ont) pas incluse(s) dans l’importation."
Ce que cela signifie : Certaines valeurs de block_id dans votre CSV n’existent pas pour ce modèle (par exemple, si des valeurs de block_id ont été modifiées manuellement).
Que faire : Ces lignes sont ignorées et les traductions de ces clés ne changent pas. Pour résoudre ce problème, supprimez ces lignes du fichier CSV ou exportez un nouveau fichier si nécessaire.
« Votre fichier contient des clés en double avec des valeurs contradictoires. La première valeur sera utilisée. »
Ce que cela signifie : Deux lignes ou plus de votre CSV ont les mêmes valeurs block_id (par exemple, si des lignes ont été dupliquées par erreur).
Que faire : Les valeurs de la première ligne sont utilisées et les autres lignes dupliquées sont ignorées. Pour résoudre ce problème, supprimez les lignes dupliquées du fichier CSV ou exportez un nouveau fichier si nécessaire.
"Plusieurs colonnes correspondent à la même langue. Seule la dernière colonne sera utilisée et les autres seront ignorées."
Ce que cela signifie : deux colonnes ou plus de votre CSV ont le même code de langue ou aboutissent à la même langue (par exemple, si une colonne de langue a été dupliquée par erreur).
Que faire : les valeurs de la dernière colonne dupliquée sont utilisées et les autres colonnes dupliquées sont ignorées. Pour résoudre ce problème, supprimez les colonnes dupliquées du fichier CSV ou exportez un nouveau fichier si nécessaire.
"Votre fichier contient des colonnes avec des codes de langue qui ne sont pas pris en charge par ce<invalid language code> canal :. Ces paramètres seront ignorés, mais des paramètres régionaux valides seront importés."
Ce que cela signifie : Un en-tête de colonne dans votre CSV utilise un code de langue qui n’est pas pris en charge ou reconnu.
Que faire : Pour ajouter une nouvelle langue, utilisez l’un des codes BCP-47 pris en charge dans la documentation Traductions intelligentes. Les colonnes avec des codes non pris en charge sont ignorées.
« Vous avez des langues dans votre fichier qui ne figurent pas dans votre projet. Les langues suivantes seront ajoutées à votre éditeur de traduction : <language detected>. »
Ce que cela signifie : votre CSV inclut des colonnes de langue qui ne font pas actuellement partie de ce modèle.
À faire :
- Si vous souhaitez ajouter ces langues, consultez la liste et cliquez sur Importer pour les ajouter à l’éditeur de traduction.
- Si vous ne souhaitez pas les ajouter, supprimez ces colonnes et réimportez le fichier.
« Aucune colonne de paramètres régionaux trouvée. »
Ce que cela signifie : le CSV inclut des colonnes block_id et source, mais aucun autre en-tête de colonne n’a été détecté.
Que faire : Ajoutez au moins une colonne de langue prise en charge et réessayez.
"Aucune colonne de paramètres régionaux valide trouvée."
Ce que cela signifie : Le CSV inclut les colonnes block_id et source, mais aucune colonne de langue valide.
Que faire : Ajoutez au moins une colonne de langue prise en charge et réessayez.
Si vous ne voyez que des avertissements et que vous comprenez leur impact, vous pouvez poursuivre l’importation. Si vous voyez une erreur, vous devez corriger le CSV et le téléverser à nouveau avant de continuer. Si vous continuez à voir des erreurs, exportez un nouveau CSV depuis l’éditeur de traduction, apportez des modifications minimales et essayez une autre importation pour isoler le problème.
Si vous continuez à voir des erreurs après avoir vérifié ces éléments, exportez un nouveau CSV depuis l’éditeur de traduction, apportez des modifications minimales et essayez un autre import pour isoler la modification à l’origine du problème.