Transporterアプリのトラブルシューティング

Transporterアプリでは、レコードを処理してオブジェクトとしてインポートする際にエラーが発生することがあります。

プラス: Transporterアプリは、Shopify PlusのマーチャントだけがShopify アプリストアで利用できます。

インポートプロセスの仕組み

アプリがデータをどのようにアップロードおよびインポートしているか、またこれらの処理中に起こりうる一般的なエラーについて、さらにはいくつかの一般的なエラーが発生する理由について理解しておくと、Transporterアプリのトラブルシューティングを行いやすくなるかもしれません。インポートのステータスは、Shopify Adminで [アプリ] >[Transporter]にアクセスします。

Shopifyストアにオブジェクトをインポートするとき、Transporterアプリは以下のアクションを実行します。

  1. Shopifyがホストしている、安全なステージングロケーションにファイルをアップロードします。Shopifyがアップロードされた情報を保護する方法については、Shopifyのプライバシーポリシーを参照してください。

  2. 構造的なエラー、またコンテンツのフォーマットエラーをチェックしてファイルを準備します。Transporterアプリでエラーが検出された場合、インポートは失敗し、ステータスは失敗となります。

  3. オブジェクトをインポートします。インポート完了に要する時間は、処理されるオブジェクト数によって左右します (平均処理速度は40オブジェクト/秒)。インポートが完了すると、そのステータスは[完了]に変更されます。Transporterアプリがインポートできなかったレコードがある場合はエクスポートエラーのリンクが表に表示されます。

[インポートを停止する]をクリックすると、いつでもそれ以上のオブジェクトのインポートを停止できます。インポートを停止する前にインポートされたオブジェクトは、Shopifyストアに残ります。インポートを停止すると、ステータスは停止に変更されます。

エラーをエクスポートおよび修正する

インポートに問題がある場合は、[エクスポートエラー]をクリックして、問題を修正する方法を確認できます。これらのエラーコードの詳細については、以下の一般的なエラーコードリストを参照してください。

エクスポートエラーリンクを表示するTransporterテーブル

エラーを修正するプロセスは、インポートのステータスが失敗完了かによって多少異なります。

失敗

インポートのステータスが失敗の場合、ファイルの内容ではなく、CSVファイル自体に問題があることになります。エラーのテキストファイルを確認したら、元のアップロードファイルのエラーを修正してから、再度ファイルをアップロードしてください。

完了

完了したインポートにエラーがある場合は、CSVファイルの構造ではなく、個々のレコードにエラーがあることになります。この場合、Shopifyではエラーのないレコードのみが作成されます。エラーが発生したレコードは作成されない代わりに、エクスポートエラーのCSVファイルに追加されます。インポートが完了し、ステータスが完了になるまで、エクスポートエラーのCSVファイルは表示されません。インポートが完了すると、テーブルにエクスポートエラーのリンクが表示されます。

エラーCSVファイルの各行の最後の列では、レコードのエラーについて説明が記載されます。ファイルをダウンロードしてからこのファイルのエラーを修正し、アップロードしてください。このファイルをアップロードする前にエラー列を削除する必要はありません。

次の例では、3人のお客様がストアにすでに存在していたため、インポートされませんでした

First Name,Last Name,Email,Error(s) Jane,Doe,jane.doe01520022060@example.com,...,Email has already been taken Jane,Doe,jane.doe11520022060@example.com,...,Email has already been taken Jane,Doe,jane.doe21520022060@example.com,...,Email has already been taken

Shopifyのお客様は固有のメールアドレスで識別されます。Shopifyでは、これらのお客様のメールアドレスがすでに記録されているため、これらのお客様をインポートできませんでした。

一般的なエラーコード

一般的なファイルエラーには以下が含まれます。

  • Shopify APIにバグがあり、保存できませんでした

  • 失敗回答コード = 400。回答メッセージ = Bad Request

  • 値タイプはリストに含まれていません

  • Column-nameis invalid

  • 無効な注文状況-発送済とキャンセル済が重複しています

ここに記載されていないエラーコードが発生した場合は、Shopifyサポートにお問い合わせください。

関連リンク

Shopifyで販売を開始する準備はできていますか?

無料体験を試す