CSV を使用して翻訳を一括管理する方法
この機能を使用するには、有料の Klaviyo アカウントとスマート翻訳が有効になっている必要があります。
Klaviyo の外部で、CSV ファイルをエクスポートして編集し、再度インポートして翻訳を一括更新したり、他のユーザーと共同作業したりできます。
翻訳の CSV をエクスポート
単一メッセージの現在の翻訳をエクスポートするには、次の手順に従ってください：
- 更新したいメッセージ（キャンペーン メール、フロー メール、SMS、WhatsApp メッセージなど）を開きます。
- [翻訳] をクリックして、翻訳エディターを開きます。
- 翻訳エディターで、アクション メニューを開き、[CSV をエクスポート] をクリックします。
- エクスポート モーダルでは、Smarting CSV または CSV を選択できます。
Smartling CSV をエクスポート
- ブラウザによって、次の内容を含む CSV ファイルがダウンロードされます：
- 以下はデフォルトの Smartling ディレクティブです：
- # smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE - block_id：このメッセージ内の各翻訳可能文字列の一意の識別子です。
- ソース言語コード（例：en）– その文字列の元のソーステキスト。
このファイルをそのまま使用して、文字列を Smartling にインポートできます。Smartling は CSV を自動的に解析し、文字列を抽出して、翻訳ジョブをトリガーできるようにします。
ジョブが完了したら、生成された CSV をダウンロードし、[インポート] ボタンを使用して再度インポートします。
シンプルな CS をエクスポートする
- ブラウザによって、次の内容を含む CSV ファイルがダウンロードされます：
- block_id：このメッセージ内の各翻訳可能文字列の一意の識別子です。
- source – その文字列の元のソーステキスト。
- 言語列：言語ごとに 1 列で、言語コード（例：en、fr、es-MX）を列名にします。
このファイルは、Excel、Google Sheets、または別のスプレッドシート エディタで開けます。
CSV を更新する
CSV を編集する際は、言語の列のみを作業すれば十分です。
block_id 列の値は編集、追加、削除しないでください。行に無効または欠落している block_id がある場合、その行はインポート時に無視され、翻訳は更新されません。
安全に変更できる内容
CSV 内：
- 適切な言語列を編集して、既存の翻訳を更新します。
- 言語列の空のセルに入力して、不足している翻訳を追加します。
- その言語を更新したくない場合は、言語の値を変更しないでください。
- 1 つ以上の 新しい言語列 を追加します：
- 有効な BCP-47 言語コード（例：fr-CA、de、ca）を使用してください。
- インポート時に、サポートされている場合、これらの言語がこのメッセージの翻訳エディターに追加されます。
変更してはいけない内容
次の操作は避けてください:
- block_id の値は編集または削除しないでください。
- 行を追加しないでください。各行は、メッセージ内の既存の翻訳可能な文字列に引き続き対応している必要があります。
- CSV 内のソース値は変更しないでください：
- ソースコンテンツを変更するには、Klaviyo エディタでメッセージを直接編集してから、新しい CSV をエクスポートしてください。
- 必須の列（block_id、source、および言語の列）の名前を変更しないでください。
- ファイル形式を変更しないでください：
- ファイルは .csv のままにしておきます。保存します。
- UTF‐8 エンコーディングで保存してください。
空のセルの処理
CSV の翻訳セルをクリアして空のままにすると、次のようになります。
- インポートでは、その空の文字列が値として扱われます。
- そのセルの既存の翻訳は、空の値で上書きされます。これにより、翻訳を実質的に削除できます。
翻訳を変更しない場合は、CSV の既存の値をそのままにするか、インポート前にその言語列を完全に削除してください。
編集が完了したら、ファイルを UTF‐8 エンコードの .csv として保存してください。
CSV をインポートする
CSV を更新して保存した後：
- 同じメッセージの翻訳エディタに戻ります。
- CSV 形式でインポートをクリックします。
- インポートモーダルで、次のいずれかを行います：
- ファイルを選択 をクリックして CSV を選択するか、
- CSV をアップロード エリアにドラッグ＆ドロップしてください。
- Klaviyo は validation “dry run” を実行し、次の内容を表示します：
- 更新、変更なし、または無視される行数の サマリー
- 検出された 警告またはエラー
- 概要と警告を慎重に確認してください。
- すべて正しければ、[インポート] をクリックして変更を適用してください。
検証中に、Klaviyo は次も確認します。
- ファイルサイズと行数の上限（例: 10MB を超えるファイルは拒否されます）。
- 必須列（block_id、source、および少なくとも 1 つの言語列など）。
- チャネルで認識されない、またはサポートされていない言語コード。
- 空の翻訳値とその他の潜在的な問題。
検証に失敗すると、エラー メッセージが表示され、翻訳に変更を加えずに新しいファイルを選択できます。
インポート結果を理解する
検証後、インポートの概要に、続行した場合に起こることが表示されます。
要約数
サマリーには次のようなカウントを含めることができます：
- 更新済み – 少なくとも 1 つの翻訳値が変更される行の数。
- 変更なし – CSV に行が存在するものの、すべての値がすでに保存されている内容と一致している状態です。
- 無視/スキップ – インポートされない行（たとえば、このメッセージに block_id が存在しない、または必須データが欠落しているため）。
カウントは言語ごとではなく、行ごとに計算されます。たとえば、CSV に 2 行と 2 つの言語列がある場合：
- 1 つの言語で 1 行が更新された場合、更新済み の数は 1 です。
- 1 行が両方の言語で更新される場合でも、[更新済み]カウントは 1 のままです。
- 1 つ以上の言語ですべての行が更新された場合、更新済みカウントは 2 になります。
ベストプラクティス
翻訳データを正確で管理しやすい状態に保つには、次の点に注意してください。
- 最新のエクスポートから開始します。特に、メッセージ内のコンテンツや言語を変更した後は、古い CSV を再利用しないでください。
- 各エクスポートのバックアップを保持してください。変更を行う前に CSV のコピーを保存しておくと、必要に応じてロールバックできます。
- 翻訳者と調整します。どの列を編集できるか（言語列のみ）と、どの列を変更してはいけないか（block_id、source）を説明します。
- 必要に応じて、小さなバッチに分けて作業します。ファイルが非常に大きい場合は、作業を複数のメッセージに分割するか、複数回に分けて小規模なインポートを実行することを検討してください。
- サポートされている言語コードを使用してください。新しい言語列を追加する際は、「処理不能」な言語を避けるため、スマート翻訳の記事に記載されているサポート対象の BCP-47 コードを使用してください。
検証警告とインポートエラーを解決する
インポートの検証中に警告またはエラーが表示された場合は、以下のセクションを確認して、その意味と修正方法を理解してください。
"必須の列がありません。"
意味：必須列が 1 つ以上（block_id または source）欠落しているか、名前が変更されています。
対応方法：CSV に block_id 列と source 列が含まれていることを確認してください。新しいシートにデータをコピーした場合は、ヘッダー行が元のエクスポートと一致していることを確認してください。
"翻訳値が空です。空の文字列も値として扱われます。"
意味：CSV に空の翻訳値があり、空の文字列も値として扱われます。
対処方法： 続行すると、それらの空のセルによって、そのキーと言語の既存の翻訳が上書きされます。それらの翻訳を変更しない場合は、以前の値を復元するか、その言語列を削除してファイルを再インポートしてください。
"<count> キーがプロジェクトに存在しないため、インポートに含まれません。"
意味： CSV 内の一部の block_id 値がこのテンプレートに存在しません（例えば、block_id 値が手動で編集された場合）。
対応方法：これらの行は無視され、それらのキーの翻訳は変更されません。これを解決するには、それらの行を CSV から削除するか、必要に応じて新しいファイルをエクスポートしてください。
"ファイルに、競合する値を持つ重複したキーが含まれています。最初の値が使用されます。"
意味： CSV 内の 2 行以上で同じ block_id 値が使用されています（例：誤って行が重複している場合）。
対処方法： 1 行目の値が使用され、重複している残りの行は無視されます。これを解決するには、CSV から重複行を削除するか、必要に応じて新しいファイルをエクスポートしてください。
"複数の列が同じ言語として解釈されています。最後の列のみが使用され、他の列は無視されます。"
意味：CSV 内の 2 つ以上の列に同じ言語コードがある、または同じ言語に解決されます（たとえば、言語列が誤って重複していた場合など）。
実施内容：最後の重複列の値が使用され、残りの重複列は無視されます。これを解決するには、CSV から重複列を削除するか、必要に応じて新しいファイルをエクスポートしてください。
"ファイルには、このチャネルでサポートされていない言語コードの列が含まれています: <invalid language code>。これらは無視されますが、有効なロケールはインポートされます。"
意味: CSV の列ヘッダーで、サポートされていない、または認識されない言語コードが使用されています。
対応方法：新しい言語を追加するには、スマート翻訳のドキュメントに記載されているサポート対象の BCP-47 コードのいずれかを使用します。サポートされていないコードの列は無視されます。
"プロジェクトにない言語がファイルに含まれています。次の言語が翻訳エディターに追加されます：<language detected>."
意味：CSV には、このテンプレートの現在の一部ではない言語列が含まれています。
行うべきこと：
- これらの言語を追加する場合は、リストを確認し、[インポート] をクリックして翻訳エディターに追加してください。
- 追加したくない場合は、それらの列を削除してファイルを再インポートしてください。
[ロケール列が見つかりません。]
意味： CSV には block_id と source の列が含まれていますが、他の列ヘッダーは検出されませんでした。
対処方法： 少なくとも 1 つのサポートされている言語列を追加して、もう一度お試しください。
"有効なロケール列が見つかりません。"
意味：CSV には block_id 列と source 列がありますが、有効な言語列がありません。
対処方法： 少なくとも 1 つのサポートされている言語列を追加して、もう一度お試しください。
警告のみが表示され、その影響を理解している場合は、インポートを続行できます。エラーが表示された場合は、続行する前に CSV を修正して再アップロードする必要があります。エラーが引き続き表示される場合は、翻訳エディターから新しい CSV をエクスポートし、最小限の変更を加えてから、別のインポートを試して問題を切り分けてください。
これらの項目を確認した後も引き続きエラーが表示される場合は、翻訳エディタから新しい CSV をエクスポートし、最小限の変更を加えて、別のインポートを試し、どの変更が問題の原因になっているかを切り分けてください。
その他のリソース
- スマート翻訳を有効にする方法
メッセージのスマート翻訳を有効にして、オーディエンスの言語設定に基づき複数の言語でキャンペーンやフローを送信する方法をご確認ください。Klaviyo では、メールのコンテンツを 60 以上の言語に翻訳できます。
- スマート翻訳を使用して多言語のメールキャンペーンを作成する方法
オーディエンスの言語設定に応じて、複数の言語でメールキャンペーンを作成して送信する方法をご覧ください。Klaviyo はキャンペーンのコンテンツを 60 以上の言語に翻訳できます。
- スマート翻訳を使用して多言語 SMS キャンペーンを作成する方法
オーディエンスの言語設定に応じて、複数の言語で SMS キャンペーンを作成して送信する方法をご確認ください。Klaviyo はキャンペーンのコンテンツを 60 以上の言語に翻訳できます。
- 言語に基づいてコンテンツをカスタマイズする方法
相手の希望言語を収集する方法と、その言語でターゲットにする方法を確認します。