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

このページで学べること

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

始める前に

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

• CSV ファイル（他の形式は不可）
• ファイルサイズは 50 MB 以下です。
• 最初の行には、各列に固有で空ではないヘッダーが含まれている必要があります。
• 各行には、メールアドレス、電話番号、外部IDなどの有効な一意の識別子が必要です。
• 重複するメールアドレスや電話番号はありません

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

目次

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

インポートの遅延

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

インポートが開始されると、最初にステータスバーが表示されます。別のページに移動した場合は、リストを開き、インポートタブを選択して進捗と結果を確認してください。リストのインポートが完了次第、メールをお送りします。

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

ファイルのアップロードに失敗した場合や、一部の行がスキップされる場合は、以下の一般的なエラーをご確認ください。インポートが完了した後にスキップされた行を見つけて修正するには、次の手順に従ってください：

1. リストを開き、インポートタブを選択してください。
2. エラーありで完了とマークされたインポートの場合、ボタンが利用可能であればエラーファイルをダウンロードをクリックしてください。
3. ダウンロードしたCSVのエラー列を使用して、影響を受けた行を特定し、修正してください。修正後のファイルからエラー列と警告列を削除し、プロファイルプロパティとしてインポートされないようにしてください。
4. 新しいファイルをアップロードをクリックし、修正したCSVをアップロードしてください。列をマッピングし、同意設定を確認してから、インポートをクリックしてインポートを開始してください。

エラーファイルをダウンロードを利用できない場合は、元のCSVを以下のトラブルシューティングガイダンスに照らして確認し、修正してから再度アップロードしてください。

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

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

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

また、CSVがKlaviyoのフォーマット要件に沿っていることを確認してください。まだの場合は、データのフォーマットに関するドキュメントをご覧ください。各行には有効な一意の識別子が必要です；別の許可された識別子が指定されている場合、メールアドレスは必須ではありません。

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

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

以下のデータ型、同意プロパティの形式、例をご確認ください。

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

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

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

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

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

同意タイムスタンプが無効というエラーが発生した場合は、タイムスタンプが同意が付与された日時を反映しており、1990年1月1日以降になっていることを確認してください。タイムゾーンも確認してください：オフセットのないタイムスタンプはUTCとして読み取られるため、ローカル時刻が未来の日時のように見える可能性があります。

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

識別子の重複

重複識別子エラーは、メールアドレスや電話番号などの同じプロファイル識別子が複数の行で使用されていることを意味します。Klaviyoでは重複行をスキップできるため、ファイル内の最初の行がインポートされることを前提にしないでください。再度インポートする前に、各連絡先の詳細を1行にまとめてください。

利用可能な場合はエラーファイルをダウンロードをクリックして、重複した識別子によりスキップされた行を確認してください。インポートした値によって既存のプロファイルが更新される場合があるため、再アップロードする前に、保持したい詳細を確認してください。

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

一意の識別子が見つからないエラーは、スキップされた行にメールアドレス、電話番号、またはその他の受け入れられる一意の識別子が含まれていなかったことを意味します。

利用可能な場合は、エラーファイルをダウンロードをクリックして、識別子が不足しているためにスキップされた行を確認してください。再アップロードする前に、各連絡先に有効な識別子を追加し、その列が一致するKlaviyoプロパティにマッピングされていることを確認してください。

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

インポートする情報に必要なフィールドを確認してください。たとえば、メールの同意がある行にはメールアドレスが必要で、SMSの同意がある行には電話番号が必要です。不足している値を入力するか、その連絡先に該当しない同意情報を削除してから、再度アップロードしてください。

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

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

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

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

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

電話番号の形式の問題

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

その他のリソース