Comment gérer les traductions en masse avec un CSV

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 :

1. Ouvrez le message que vous souhaitez mettre à jour (e-mail de campagne, e-mail de flux, SMS, message WhatsApp, etc.).
2. Cliquez sur l’icône ou le bouton Traduire du message, ou sur le bouton affichant le nombre de traductions, pour ouvrir l’éditeur de traduction. Si le message n’a pas encore été traduit, terminez d’abord la configuration de la langue.
3. Dans l’éditeur de traduction, ouvrez le menu d’actions à 3 points et cliquez sur Exporter.

4. Sous Sélectionner le format d’exportation, choisissez CSV. Conservez Compatible avec Smartling sélectionné si vous envoyez le fichier à Smartling, ou désélectionnez-le pour modifier un CSV standard dans une feuille de calcul.

5. Sous Langues à exporter, choisissez Tout sélectionner pour inclure toutes les langues de traduction existantes, ou Sélection personnalisée pour choisir des langues spécifiques. Pour exporter uniquement le texte source pour un traducteur, choisissez l’option de langue source uniquement. La langue source est incluse dans chaque exportation.
6. Cliquez sur Exporter pour télécharger le fichier CSV.

CSV Smartling

Un CSV compatible avec Smartling inclut :

Directives Smartling en haut du fichier, notamment :

# 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.
• Colonnes de langue pour les langues de traduction que vous avez sélectionnées, le cas échéant.

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 traduit. Avant de l’importer dans Klaviyo, supprimez toutes les lignes de directive # smartling. initiales afin que la première ligne contienne les en-têtes de colonne. Conservez la colonne block_id, la colonne de la langue source, et au moins 1 colonne de langue de traduction prise en charge. Ensuite, suivez la section Importer le CSV ci-dessous.

CSV Standard

Un fichier CSV standard 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 : 1 colonne par langue de traduction que vous avez sélectionnée, nommée avec son code langue (par exemple, en, fr, es-MX). Une exportation avec source uniquement ne comporte aucune colonne de langue de traduction.

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, les langues prises en charge avec de nouvelles valeurs de traduction sont ajoutées à l’éditeur de traduction pour ce message.

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.
• Conservez les en-têtes de colonne block_id et source inchangés. Dans un CSV Smartling, conservez l’en-tête de colonne de la langue source au lieu de source. Conservez chaque colonne de langue de traduction libellée avec son code de langue pris en charge.
• Ne modifiez pas le format du fichier:
  • Conservez le fichier au format .csv .p8.
  • Enregistrez avec l’encodage UTF‐8.

Conservez les balises de modèle et les balises de modèle, telles que {{ first_name }} et {% if ... %}, inchangées dans chaque traduction. Si ces espaces réservés diffèrent du message source, la validation bloque l’importation.

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 l’effacement d’une cellule supprime également des espaces réservés présents dans la source, la validation bloque l’importation. Restaurez les espaces réservés ou supprimez cette colonne de langue avant d’importer.

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 :

1. Revenez à l’éditeur de traduction pour le même message.
2. Ouvrez le menu d’actions à 3 points, puis cliquez sur Importer un CSV.
3. 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.

4. Cliquez sur Suivant pour valider le fichier et prévisualiser les modifications.

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

1. Examinez attentivement le récapitulatif et les avertissements.
2. Si tout semble correct, cliquez sur Importer pour appliquer les modifications.

Lorsque l’importation réussit, la fenêtre modale se ferme et vos traductions sont mises à jour dans l’éditeur de traduction. Examinez les traductions importées.

Lors de la validation, Klaviyo vérifie également :

• Type de fichier et encodage : utilisez un fichier CSV encodé en UTF-8.
• Colonnes CSV : conservez block_id, la colonne source (ou la colonne en langue source pour Smartling), et au moins 1 colonne de langue de traduction prise en charge.
• 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.
• Les balises de modèle et les balises de modèle Personalization qui diffèrent du message source.

Si la validation échoue, vous voyez un message d’erreur. Cliquez sur Sélectionner un nouveau fichier après avoir corrigé le CSV pour réessayer ; la validation ne modifie pas 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 1 valeur de traduction va changer.
• Ignorées (inchangées) : lignes du CSV pour lesquelles toutes les valeurs de traduction incluses correspondent à ce qui est déjà enregistré.
• Ignorées : les lignes qui ne seront pas importées, telles que les lignes en double après la première occurrence ou les lignes dont le block_id n’existe pas dans ce message.

Bonnes pratiques

Pour que vos données de traduction restent exactes et faciles à gérer :

1. 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.
2. 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.
3. 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).
4. 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.
5. Utilisez des codes de langue pris en charge. Lors de l’ajout de nouvelles colonnes de langue, utilisez des codes BCP-47 pris en charge provenant de l’article Traductions intelligentes afin d’éviter les langues « impossibles à traiter ».

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.

Ressources supplémentaires