CSV で用語集の用語を一括でインポートする方法
この機能を使用するには、有料の Klaviyo アカウントとスマート翻訳が有効になっている必要があります。
既存の用語集をインポート
Klaviyo のスマート翻訳機能では、用語集を使用して特定の用語の翻訳方法を制御します。ブランド名、製品名、スローガン、またはすべてのキャンペーンで一貫した翻訳が必要な技術用語などが対象です。
すでに別の翻訳システム(DeepL、Lokalise、Phrase、社内スプレッドシート)で用語集を管理している場合は、各エントリを手作業で作り直す代わりに、CSV として Klaviyo に直接インポートできます。
CSV インポートを使用するタイミング
CSV のインポートは、次の場合に便利です:
- DeepL、Lokalise、Phrase、memoQ などの TMS(翻訳管理システム)から、既存の用語集を Klaviyo に取り込みます。
- UI で各用語を入力するのではなく、一度に(数十~数百の)多数の用語を追加します。
- 共有スプレッドシートで管理されている用語集を、Klaviyo の信頼できる唯一の情報源 (SSOT) に移行します。
用語がほんの一握りであれば、通常は用語集パネルで 1 つずつ手動で追加する方が速いです。
インポートは一方向です。用語は Klaviyo にアップロードできますが、現時点では CSV エクスポートはありません。バックアップが必要な場合に備えて、ソースファイルのコピーを保持してください。
CSV ファイルを準備する
ファイル形式
- エンコード: UTF-8
- ファイルタイプ: .csv
- 区切り文字: カンマ(,)
- ヘッダー行: 必須(下記参照)
サンプルファイル
原文用語 | ターゲット用語 | ソース ロケール | ターゲット ロケール |
|---|---|---|---|
こんにちは | bonjour | EN | fr |
こんにちは | hallo | EN | de |
tschüß | さようなら | de | EN |
必須の列
各行には 4 つの列を含める必要があります。
source term— ソース言語の用語target term— 用語の翻訳方法source locale— ソース言語の BCP-47 ロケール タグtarget locale— ターゲット言語の BCP-47 ロケール タグ
4 つのヘッダーはすべて、ファイルの 1 行目に含まれている必要があります。列の順序は問いません。
ロケールコード(BCP-47)
ロケールコードはBCP-47標準に従います。最も一般的な形式は、2 文字の言語コードで、必要に応じて地域が後に続きます:
en— 英語en-US— 英語(米国)en-GB— 英語(英国)fr— フランス語fr-CA— フランス語(カナダ)de— ドイツ語ja— 日本語pt-BR— ポルトガル語(ブラジル)
Klaviyo で設定したロケールに一致する、最も具体的なタグを使用してください。
1 つのファイル内の複数の言語ペア
単一の CSV には、多数の言語ペアのエントリを含めることができます。各行は個別に処理されるため、ペアを自由に組み合わせられます:
原文用語 | ターゲット用語 | ソース ロケール | ターゲット ロケール |
|---|---|---|---|
こんにちは | bonjour | EN | fr |
こんにちは | hola | EN | es |
こんにちは | hallo | EN | de |
bonjour | buenos días | fr | es |
これは、複数のロケールでの翻訳を支える 1 つのマスターグロッサリーを維持している場合に役立ちます。
用語集の用語は対称です
各用語集エントリは、用語間の双方向の等価性を定義します。インポートする場合:
原文用語 | ターゲット用語 | ソース ロケール | ターゲット ロケール |
|---|---|---|---|
こんにちは | bonjour | EN | fr |
Klaviyo は次を実行します:
- 英語→フランス語を翻訳する際は、
helloをbonjourとして翻訳します。 - フランス語→英語の翻訳では、
bonjourをhelloとして翻訳します。
これは、次のような非対称マッピングを定義できないことを意味します:
原文用語 | ターゲット用語 | ソース ロケール | ターゲット ロケール |
|---|---|---|---|
こんにちは | bonjour | EN | fr |
bonjour | こんにちは | fr | EN |
どちらの行も bonjour を別の英語の用語にマッピングしており、これは競合です。ロケール・ペア・用語の組み合わせごとに許可されるマッピングは 1 つのみです。インポーターは競合している行をスキップし、エラーを報告します(インポートエラーのトラブルシューティングを参照)。
コンテキストに応じて bonjour に異なる英語訳が必要な場合、用語集の用語は適切なツールではありません。用語集は、毎回同じように翻訳される用語を対象としています。
インポートモード
インポート時に、2 つのモードのいずれかを選択します。
- 追加 — 既存の用語集エントリは保持されます。CSV からの新しいエントリが追加されます。既存のエントリと競合する行はスキップされます。
- すべて置換 — 現在の用語集全体が削除され、CSV の内容に置き換えられます。
[すべて置換] を選択すると、現在の用語集全体が削除されます。
CSV が新しい信頼できる唯一の情報源であると確信できる場合にのみ、[すべて置換] を使用してください。元に戻すことはできません。
ファイルをインポート
1. [アカウント] → [設定] → [翻訳] → [用語集]に移動します。
2. [CSV 形式でインポート] をクリックします。

3. ダイアログで [追加] または [すべて置換] を選択します。

4. ファイル領域をクリックして .csv ファイルを選択します(またはファイルを領域にドラッグします)。
5. [次へ] をクリックします。Klaviyo はファイルを検証しますが、まだ何も保存しません。プレビュー画面が表示されます。
6. プレビューを確認します:
- 合計行数 — ファイル内の行数。
- 有効なエントリ — インポートされる件数。
- スキップされた行数—検証の問題により除外された数。
7. 警告が表示された場合でも続行できます。または、前に戻って先にファイルを修正することもできます。
8. 変更を保存するには、[インポート] をクリックします。

ファイルに問題がある場合は、プレビューではなく インポートに失敗しました 画面が表示されます。

インポート エラーのトラブルシューティング
インポートが失敗すると、Klaviyo は何が問題だったのかを説明する 1 つ以上のエラーメッセージを表示します。ファイル全体に適用されるエラーもあれば、特定の行を指すエラーもあります。
ファイル レベルのエラー
これらはインポートを完全に停止します。修正のうえ、もう一度お試しください。
"アップロードされたファイルは空です。"
意味: ファイルにコンテンツが含まれていません。
対処方法: ファイルが 0 バイトではなく、ヘッダーに加えて少なくとも 1 行あることを確認してください。
"必須ヘッダーが不足しています。"
意味:ヘッダー行に、必要な 4 つの必須列がすべて含まれていません。
対応内容: 最初の行に source term、target term、source locale、target locale が含まれていることを確認します。ヘッダーの順序は関係ありませんが、スペルは重要です。
"有効な用語集エントリがありません。"
意味: 検証後、インポートできる行がありませんでした。
対応方法:ファイルを開き、データ行が想定される形式と一致していることを確認します。
"エンコード エラー。"
意味: ファイルは UTF-8 でエンコードされていません
対応方法:スプレッドシート ツールから、UTF-8 エンコードでファイルを再保存してください。Excel では、[名前を付けて保存] → CSV UTF-8 を使用してください。
"用語が最大長を超えています。"
意味:1 つ以上の用語が長すぎます。
対応内容:用語集の用語は短いフレーズにしてください。非常に長いエントリは短くするか、分割します。
行レベルのエラー
これらは特定の行にフラグを付けます。ファイルの残りの部分は引き続きインポートできます — 不正な行はスキップされます。
"行 N:列数が想定と異なります"
意味: この行のカンマ区切りの値が少なすぎるか、多すぎます。
対応方法:CSV の行を確認してください。用語内に余分なカンマがある場合は、引用符("hello, world")で囲む必要があります。
"行 N:用語の値が空です"
意味:ソースまたはターゲットの用語セルが空白です。
対応方法:不足している用語を入力するか、行を削除してください。
「行 N:ロケールコードが空です」
意味:ソースまたはターゲットのロケール セルが空白です。
対応方法:不足しているロケール(例:en, fr-CA)。
"行 N:認識されないロケールコード"
意味: ロケール文字列が有効な BCP-47 タグではありません。
対応内容: en、fr、de、pt-BR のような標準ロケールコードを使用してください。ロケール コードをご覧ください。
"行 N:重複するロケール列が検出されました"
意味:同じロケールが、1つのエントリ コンテキスト内に複数回表示されています。
対応方法: 各行には、異なるソース ロケールとターゲット ロケールが必要です。en → en は翻訳できません。
"行 N:同じ用語とロケールに対して翻訳が競合しています"
意味:この行は、ファイル内の別の行とは異なるターゲットに同じソース用語をマッピングしようとしています。
対応方法:どの翻訳が正しいかを判断し、重複しているものを削除してください。
"行 N:用語が既存のエントリと競合しています"
意味:行は、用語集にすでに存在する用語と矛盾する翻訳を定義しようとしています([追加] モードのみ)。
対応方法:UI 内の既存のエントリを更新するか、新しいファイルが正しい場合は [すべて置換] モードを使用してください。
[行 N:安全のため、先頭の数式文字が削除されました]
意味:用語が =、+、-、または @ で始まっており、スプレッドシート アプリが数式として解釈するものです。
対応方法: これは失敗ではなく警告です。用語は先頭文字が削除された状態でインポートされます。文字が必要な場合は、用語を引用符で囲みます。
一般的な検証エラー
「検証エラーが発生しました。ファイルを確認して、もう一度お試しください。」と表示される場合、インポーターで分類できない問題が発生しました。ファイルが想定される形式と一致していることを再確認し、問題が解決しない場合はサポートにご連絡ください。
その他のリソース
- スマート翻訳を有効にする方法
メッセージのスマート翻訳を有効にして、オーディエンスの言語設定に基づき複数の言語でキャンペーンやフローを送信する方法をご確認ください。Klaviyo では、メールのコンテンツを 60 以上の言語に翻訳できます。