リストのインポートに関するトラブルシューティング

このページで学べること

Klaviyo で連絡先の CSV を新規または既存のリストにアップロードする際に発生するエラーのトラブルシューティング方法を確認します。レビューをアップロードしますか？詳しくはレビューをインポートする方法をご覧ください。

始める前に

ファイルがインポートされることを確認しますか？リストをインポートする前に、以下の要件一覧を確認してください。

• CSV ファイル（他の形式は不可）
• ファイルサイズは 50 MB 以下です。
• 最初の行はヘッダーです
• 各行には、メールアドレスまたは電話番号のいずれかが紐付いています
• 重複するメールアドレスや電話番号はありません

サポートチームでは、お客様に代わって CSV を Klaviyo にインポートすることはできません。インポートについてサポートが必要な場合は、以下のトラブルシューティング セクションで、リストのインポート問題を正常にトラブルシューティングするためのヒントをご確認ください。

目次

• インポートの遅延
• インポートのトラブルシューティング
• 単一のフィールドとしてインポートされたすべての列
• 無効な形式のエラー メッセージ
• 日付またはタイムスタンプの形式が正しくありません
• 一意の識別子の重複または欠落に関するエラー メッセージ
• 必須フィールドに値がありません
• 電話番号の形式の問題

インポートの遅延

大量のデータを含む大きなファイルをインポートする場合、インポート処理の完了までに数時間かかることがあります。申し訳ありませんが、この処理が始まった後に速度を上げる方法はありません。ただし、インポート前に CSV から重複するメールをすべて削除すると、インポート処理を事前に短縮できる場合があります。リスト内の連絡先にメールを送信する予定日の少なくとも 1 日前までに、新しいリストをインポートする計画を立てることを強くおすすめします。

インポートが開始されると、最初にステータスバーが表示されます。別の場所をクリックしても、時間の経過とともにリスト数が増加するのを確認することで、インポートの進捗を引き続き追跡できます。リストのインポートが完了次第、メールを送信します。

インポートのトラブルシューティング

リストのアップロードに失敗する場合は、CSV ファイルに次の一般的なエラーがないか確認してください。これらが障害の原因となっている可能性があります：

単一のフィールドとしてインポートされたすべての列

英語を既定の言語として使用しないバージョンの Excel を使用している場合、ソフトウェアがファイル内の区切り文字としてコンマではなくセミコロンを使用することがあります。この場合、インポート時にファイルが次のように表示されることがあります：

これを解決するには、使用中のコンピュータの 数値形式 または リスト（または数値）区切り の設定に移動します。この設定は通常、言語と地域 の設定内にあり、詳細設定 セクションにある場合があります。セミコロンをカンマに置き換えて保存します。これで、CSV としてファイルをエクスポートすると、カンマ形式が使用されます。この設定の正確な場所は、オペレーティングシステムによって異なる場合がありますのでご注意ください。

また、CSV が Klaviyo の書式要件に一致していることも確認してください。まだの場合は、データの書式設定に関するドキュメントをご覧ください。例えば、必須フィールドの 1 つはメールアドレス用です。

無効な形式のエラーメッセージのトラブルシューティング

リストを Klaviyo にインポートすると、フィールドのマッピングページで任意のプロパティを Klaviyo の対応するデータタイプに一致させることができます。たとえば、メール のデータタイプは常に テキスト です。一方、誕生日 のカスタムプロパティをアップロードする場合は、データタイプを 日付 に設定します。

以下のデータ型、使用可能な形式、例をご確認ください。

• テキスト
  テキスト、またはテキストと数字の任意の組み合わせ。データがどの形式かわからない場合は、このオプションを選択してください。
  • 例：
    email@example.com
    こんにちは、世界
    $ 5.00
• 数値
  すべての数字。数値フィールドには通貨記号を含めないでください。
  • 例：
    2
    5.0031
    130.0
• ブール値
  True または false の値。
  • 例：
    true
    false
• 日付
  プロファイルとイベントプロパティで使用可能な日付とタイムスタンプの形式 のガイドを参照して、使用可能な日付形式をご確認ください。
  • 例:
    2014-09-01 13:34:08
• リスト
  データは JSON 配列としてフォーマットする必要があります。
  • 例：
    ["りんご","バナナ","オレンジ"]
    ["りんご"]
• 同意
  同意はチャネル（メール、SMS など）と同意の種類（Klaviyo で複数の種類を利用できる場合）として形式化されます。メールの唯一のオプションは メールマーケティングの同意 です。SMS の場合は、SMS マーケティングの同意 または SMS トランザクションの同意 のいずれかになります。など。このフィールドの値は "購読," "Never Subscribed," または "購読解除." でなければなりません。 

さまざまなデータタイプの内容と、リストをインポートするときにどれを選択すべきかの詳細については、データタイプについてのガイドをご覧ください。

「無効な [データ型] の形式」エラーメッセージ（例：「無効なリスト形式」）の詳細については、無効な形式エラーメッセージのトラブルシューティングガイドをご覧ください。

日付またはタイムスタンプの形式が正しくありません

日付またはタイムスタンプの形式が誤っている可能性があります。いずれかを含めていて、Klaviyo で受け付けられる形式が不明な場合は、プロファイルとイベント プロパティで使用可能な日付とタイムスタンプの形式に関するガイドをご覧ください。

重複または欠落している一意の識別子に関するエラーメッセージのトラブルシューティング

識別子の重複

"[重複する一意の ID]" が原因でスキップされたレコードは、ファイル内でメールアドレスまたは電話番号が重複していたことを意味します。このような場合、Klaviyo は重複した識別子を含む最初の行のデータを処理し、未処理のレコードはダウンロード可能なファイルで提供します。

重複した識別子によりスキップされた連絡先を確認するには [スキップされたレコードをダウンロード] をクリックし、必要に応じてこれらのスキップされたレコードを再アップロードします。

一意の識別子がありません

「Missing Unique ID」によりスキップされたレコードは、スキップされた行にメールアドレス、電話番号、またはその他の受け入れ可能な一意の識別子が含まれていなかったことを意味します。

識別子の不足によりスキップされた連絡先を確認するには、[スキップされたレコードをダウンロード] をクリックし、それぞれにメールアドレスまたは電話番号を追加してから、新しいファイルを再アップロードしてください。

必須フィールドに値がありません

必須フィールドのすべてに、関連付けられた値があることを確認してください。たとえば、一覧にある連絡先の 1 件でメール列の下にメールアドレスがない場合、アップロード時にエラーが表示されます。アップロードしたい各連絡先について、必須フィールドのすべてに値があることを確認してください。空欄の場合は、次回アップロードを試す前に入力してください。

無効なメールアドレス、または認識できない文字

このエラーメッセージが表示された場合は、ファイル内のメールアドレスに無効な文字が含まれていないか確認してください。無効な文字には ( ) , : ; [ / ] のほか、スペースも含まれます。

アカウント間でプロファイルを転送する

あるアカウントから別のアカウントへプロファイルを転送する際、別のアカウントにアップロードできないプロパティがいくつかあります。

たとえば、「プロファイル作成日」は、アカウントでプロファイルが作成された日付に設定されているため、転送できません。別の例として「最初にアクティブ」と「最後にアクティブ」があります。これらは、アカウント上のプロファイル アクティビティに基づいて自動的に設定されるためです。

電話番号の形式の問題

電話番号には国コードを含めるか、国を示す別の列を用意する必要があります。また、承認された電話番号形式に従う必要があります。電話番号を適切に形式設定してアップロードする方法をご覧ください。

その他のリソース