Magentoで製品をインポートする方法 2 の 2026: の作業ガイド 2.4.8 - JA

Adobe が Magento を出荷 2.4.8 4月に 8, 2025, そして、大規模なカタログがプラットフォーム内を移動する方法がついに追いつきました 2026. ネイティブ REST インポート エンドポイント (/V1/インポート/CSV と /V1/インポート/json) Base64 でエンコードされたペイロードと gzip 圧縮を受け入れるようになりました. それは老人を殺す “CSV を次のように分割します 500 列を作って祈る” ルーティーン. ほとんどの店舗が依然として頼りにしている管理 CSV インポーター? 同じツール, たいてい. でも壊れ方は変わった, 修正も同様です. このガイドでは両方のパスをカバーしています, そしてそれを逃すと週末を食べてしまうような間違い.

簡単な回答: 以下のカタログについては、 5,000 SKU, システムの下の管理CSVインポーターを使用します。 > データ転送 > 輸入. より大きなものや自動化されたものについては、, を打つ REST /V1/import/csv エンドポイント に追加されました 2.4.8. BOM なしでファイルを UTF-8 のままにする, 画像をドロップする var/import/images, そしていつも走る “データを確認する” コミットする前に.

最終レビュー済み: 4月 2026. エンドポイント, バージョン番号, Adobe Commerce に対して検証されたインポート動作 2.4.8 リリースノートとExperience Leagueドキュメント.

始める前に: 何が変わったか 2.4.8

Magento で製品をインポートした場合 2.4.5 それ以前の, いくつかのデフォルトが現実に追いついた. 新しい 2.4.8 インストールにはインデクサーが同梱されます スケジュールによる更新 モード, そのため、一括インポートによってインデックスの再作成中にフロントエンドが停止することがなくなりました。. リリースは終了しました 497 コアバグ (インポーター自体にいくつかあります) 2MB の管理アップロード上限を回避する REST インポート エンドポイントを追加しました.

インポーターに触れる前に必要なものは次のとおりです:

• Magento 2.4.8 以降. ランニング 2.4.5 またはそれ以上の? 最初にアップグレードしてください. 古いインポーターはまだ機能しています, しかしバグ修正はバックポートされていない.
• PHP 8.3 最小, 8.4 おすすめされた. 2.4.8 ネイティブ PHP が同梱されています 8.4 サポート. PHP にストア 8.1 輸入します, しかし、エラー処理はノイズが多くなります.
• MySQL 8.0 またはMariaDB 10.6/11.4. 2.4.9-ベータ 1 では MySQL が削除されます 8.0 およびMariaDB 10.6, 新しくセットアップする場合, 行く 11.4.
• 書き込み可能な var/import/images ディレクトリ. 権限: 775 ディレクトリ用, 664 ファイル用, Web ユーザーが所有する.
• 十分な PHP 制限. 以上のカタログについては、 10,000 SKU, メモリ制限 2G と 最大実行時間 1800 php.ini内. 値を低くすると、インポートが途中で静かに強制終了されます。.

素早い注意喚起: アドビコマース (有料層) と Magento オープンソースはインポーター コードを共有します. スタックは事前に調整されているため、クラウドの顧客は php.ini に触れる必要がありません。, ただし、以下の CSV ルールと動作は同様に適用されます。.

実際に輸入できるもの

Magento 2 6つの製品タイプがあります, CSV ルールは、どれを移動するかによって変わります。. ショートバージョン:

• シンプルな製品. 1 つの SKU, 1つのバリエーション. すべてのチュートリアルで使用されるテンプレート. 学習している場合は、最初にこれらをインポートしてください.
• 構成可能な製品. 子シンプルが接続された親 SKU 構成可能なバリエーション. Tシャツのサイズと色は教科書の例です. 子は親インポート行の前に存在する必要があります, またはリンクが失敗します.
• 仮想製品. サービス, サブスクリプション, 保証範囲. 送料計算なし, 重量列は必要ありません.
• グループ化された製品. 1 ページに複数のシンプルを表示するラッパー (考える “包丁セット, 個別に購入する”). 用途 関連する_skus CSV内で.
• 同梱商品. 顧客がオプションを選択して独自のコンボを構築. 形式が面倒で使用する バンドル値 パイプで区切られたフィールドの場合.
• ダウンロード可能な製品. ファイル, ソフトウェアライセンス, 電子書籍. ニーズ ダウンロード可能なリンク 設定済み.

輸入順序に関する事項. まずはシンプルなものから, 次に、それらを参照する構成可能ファイル, 最後にグループ化してバンドルします. 子 SKU がまだ存在しない構成可能ファイルをインポートすることは、最も一般的な自己責任によるエラーです, バリデーターはインポートが実行される前にそれを常にキャッチするとは限りません.

CSVインポート: 管理者のチュートリアル

管理 CSV インポーターは、最大約 5,000 不満のないSKU. 後で API に移行する予定がある場合でも知っておく価値があります, これは、次の列ルールが両方のパスに適用されるためです。.

ステップ 1: サンプルファイルをエクスポートする (これをスキップしないでください)

に移動 システム > データ転送 > 輸入. セット エンティティタイプ に 製品, 次にクリックします サンプルファイルをダウンロード. サンプルは、Magento インストールに正確に一致します, ストアが追加したカスタム属性を含む. ブログ投稿の汎用 CSV テンプレートを使用すると、列の不一致エラーが発生します.

サンプルを保存する, Notepad++ または VS Code で開きます. Microsoft Excelを使用しないでください. Excel が UTF-8 ファイルにバイト オーダー マークを追加する, インポーターは明確なエラー メッセージを表示せずに BOM プレフィックス付きファイルを拒否します。. Excel が唯一の選択肢である場合, としてエクスポート “CSV UTF-8” そしてBOMリムーバーを通してファイルを実行します, または Google スプレッドシートに切り替える (ファイル > ダウンロード > CSV, これによりクリーンな UTF-8 が保存されます。).

ステップ 2: 製品行を入力します

単純な製品の必須列: スク, ストアビューコード, 属性セットコード, 製品タイプ, カテゴリ, 製品ウェブサイト, 名前, 説明, 価格, 数量, 重さ, 製品オンライン, 税クラス名, 視認性.

説明を以下に残します ~255 文字 管理インポーターを使用している場合は行ごと. 長い HTML 記述も機能します, しかし、ファイルサイズが急速に膨張し、デフォルトの制限である 2MB に近づくことになります。. カテゴリはスラッシュを使用して階層を構築します: デフォルト カテゴリ/アパレル/T シャツ. 区切り文字はスラッシュです, バックスラッシュではありません. ひと安心: Magento はまだ存在しないカテゴリーパスを自動作成します, そのため、インポート前にすべてのカテゴリを事前に構築する必要はありません.

構成可能なものについて, the 構成可能なバリエーション 列には次のようなパイプ区切りの文字列が含まれます。:
sku=シャツ-レッド-S,サイズ=S,色=赤|sku=シャツ-レッド-M,サイズ=M,色=赤

面倒な, はい. 最初に手動で構築した構成可能ファイルを 1 つエクスポートすることで、手間を省きます。, 次に、その行を次のテンプレートとして使用します 5,000.

ステップ 3: インポート動作を構成する

CSV 内の SKU がすでにカタログに存在する場合はどうなりますか? 3 つの行動オプションが決定します, 間違ったものを選択するとデータが消去される可能性があります:

• 追加/更新. デフォルトと安全な選択. 新しい SKU を追加します, 一致するものを更新します, 未掲載商品は放置しておきます.
• 交換. 一致する SKU を最初に削除します, 次に、CSV からそれらを再作成します. URLをワイプします, レビュー, それらの製品の在庫移動履歴. めったに使用しない.
• エンティティの削除. 一致する SKU をカタログから削除します. データベースを復元しないと元に戻せない.

こちらもセット フィールド区切り文字 カンマまで, 複数の値の区切り文字 カンマまで, そしてチェックしてください 許可されたエラー数. デフォルトは 10. 一部の行が失敗することが予想され、インポーターを中止せずに続行させたい場合は、より大きな数値に調整します。.

ステップ 4: インポートする前に検証する

CSV をアップロードする, クリック データを確認する, そして待ってください. これにより、実際のインポートと同じ検証が実行されます。, ただしデータベースに書き込むことはありません. 出力には、失敗した特定の列を含むすべての行エラーが番号順にリストされます。. CSVを修正する, 再アップロード, 再確認. 緑色になるまで洗い流します.

検証で次のようになった場合 “ファイルは有効です” ただし、いくつかの警告が表示されます, とにかく読んでください. 多くの場合、Magento が黙ってスキップするカテゴリ パスやストア ビューが欠落しているという警告が表示されます, 不完全なカテゴリツリーを含む製品の作成.

ステップ 5: インポートを実行する

クリック 輸入. 進行状況バーは、ファイルが小さい場合は正直に表示され、ファイルが大きい場合は楽観的に表示されます. ブラウザのタブを閉じないでください. リフレッシュしないでください. インポーターは単一の長い PHP プロセスを実行します。, そして遅いホスティングでは, 書き込み中にタブを閉じるとプロセスが孤立し、部分的なデータが残ります。. 時計 var/log/import.log ライブ進行状況が必要な場合は SSH 経由, またはチェックしてください システム > インポート履歴 それが終わったら.

画像とメディア

画像は他のどのフィールドよりもインポートを混乱させます. 一度見ればルールは簡単.

画像ファイルを FTP または SFTP で送信します <マジェントルート>/var/import/images. サブフォルダーは許可されます: var/import/images/2026-spring 作品. CSV内, 各画像を相対パスで参照します。 var/import/images:

• ベースイメージ 桁: メイン商品画像 (商品ページに表示されている)
• small_image 桁: カテゴリページのサムネイル
• サムネイル画像 桁: カートと注文のサムネイル
• 追加画像 桁: ギャラリー画像, カンマ区切り

4 つのギャラリー ショットを含む 1 つの製品をインポートする行は次のようになります。: /2026-春/Tシャツ-レッド-メイン.jpg の ベースイメージ, それから /2026-春/Tシャツ-レッドバック.jpg,/2026-春/Tシャツ-レッド-ディテール.jpg,/2026-春/Tシャツ-赤い生地.jpg の 追加画像.

ファイル名に注意してください. マジェントのおやつ シャツ.jpg と シャツ.jpg Linux ホスト上の別のファイルとして, インポーターは大文字小文字を自動修正しません. 可能であればアップロード前に WebP に圧縮してください; 300 ～ 400KB JPEG のヒーロー ショットは、実際のトラフィックが発生した瞬間に Core Web Vitals を圧迫します。. 私たちの Magento スピード プレイブック 既存のカタログの WebP および AVIF 変換をカバーします。.

REST APIのインポート: The 2.4.8 大規模なカタログのパス

管理インポーターはすぐに上限に達します. 過ぎてしまったら 10,000 SKU または ERP からの自動同期が必要な場合, Adobe が出荷した REST エンドポイント 2.4.8 正しいツールです. 2 つのエンドポイントが重要:

• 投稿/休憩/<ストアコード>/V1/インポート/CSV CSV ペイロードの場合
• 投稿/休憩/<ストアコード>/V1/インポート/json JSONペイロードの場合

どちらもリクエスト本文でbase64でエンコードされた文字列を受け入れます. CSVの場合, ルールは: ファイルをUTF-8でエンコードします, gzip圧縮してみます (オプションですが、1MB を超えるものには賢明です), 結果をbase64にします. 応答はインポートされたエンティティの数を返します. 非同期一括経由 /V1/バルク/ ファイアアンドフォーゲットしたい場合にも機能します.

流れ, 順番に:

• 管理者トークンで認証する (投稿先 /V1/統合/管理/トークン)
• products.csv を Gzip 圧縮します, それをbase64エンコードする, それをJSONペイロードに詰め込みます ソース, 実在物: “カタログ製品”, と 行動: “追加する”
• Authorization ヘッダーのトークンを使用してインポート エンドポイントに POST します。
• 投票 /V1/バルク/{バルクUuid}/状態 非同期になった場合

Adobe の開発者向けドキュメントには、正確なペイロードの形状が記載されており、リリースごとに更新されます, したがって、古い StackOverflow スレッドをコピーするのではなく、そこからプルします. The 2.4.8 精算: 非同期パスでは、PHP リクエストは最長でオープン状態に保持されません。 30 管理インポーターが行う方法と同様に数分. 50,000 行のロードはバックグラウンドで実行されます, 店頭は実際の買い物客に常に反応します.

一般的なインポート エラーと実際の修正方法

これらは最も時間を費やす失敗です. それぞれに特定の根本原因があり、エラー テキストからは必ずしも明らかではありません.

“許可されたメモリ サイズ X バイトが使い果たされました”

PHP がインポート中にメモリ不足になりました. 上げる メモリ制限 php.ini から 2G へ, PHP-FPMを再起動します, リトライ. php.iniにアクセスできない場合 (共有ホスティング), CSV を次のファイルに分割します 1,000-5,000 行ごとに順次インポートします. Firebear や Amasty などのサードパーティの拡張機能により、 “メモリ制限なしでインポート” トグル, でもそれは拡張機能です, ネイティブのMagentoではない.

“最大実行時間 30 秒を超えました”

あなたのPHP 最大実行時間 低すぎる. にぶつかる 1800 秒. Nginx について, 上げる必要もあります fastcgi_read_timeout 合わせる, そうしないと、PHP が終了する前に Nginx がアップストリームを強制終了します。.

“間違った列の順序” また “ヘッダーに無効な列があります”

バイトオーダーマーク. CSV は Excel から保存されました, これは、インポーターが文字化けした最初の列として読み取る UTF-8 ファイルの先頭に BOM を追加します。. Google スプレッドシートから再エクスポートするか、Notepad++ を介して BOM なしの UTF-8 として再保存します。. インポートを押す前に 1 つだけ確認する場合, これをチェックしてください.

“無効な属性セット” また “X の属性値が無効です”

CSV は、この Magento インストールに存在しない属性セットまたはドロップダウン値を参照しています. チェック 店舗 > 属性. ドロップダウン値では大文字と小文字と空白が区別されます. “赤 ” 末尾にスペースがある場合はそうではありません “赤”.

輸入 “完了する” しかし、商品がフロントエンドに表示されない

再インデックスが実行されませんでした, またはキャッシュが古い. SSH接続して実行 bin/magento インデクサー:再インデックス に続く ビン/マジェントキャッシュ:フラッシュ. の上 2.4.8 スケジュールによる更新インデクサーでは、これはまれです, ただし、product-URL と株価インデクサーでは引き続き発生します.

“指定されたストアの URL キーはすでに存在します”

あなたが輸入している製品は、 URL_キー 既存のものと衝突します. CSV 内の URL キーを変更するか、動作を次のように設定します。 “追加/更新” 新鮮というよりは “複雑なデータの追加” 走る.

大規模なインポートのホスティング要件

共有ホスティングは、悪質な CSV よりも多くの Magento インポートを停止します. プロダクションを運営している場合 2.4.8 お店, 正直なフロアは 4 GB RAM と 2-4 vCPU; 本物のカタログ (10k+ SKU, 頻繁な逆輸入) 必要 8-16 GB. ディスクはNVMe SSDである必要があります, ドライブや古い SATA SSD が回転していない, インデックスの再作成と画像サイズ変更の操作によりランダムな I/O が発生するため.

Magento 対応ホストで実行できるようにする具体的なこと:

• php.iniを編集する (またはドメインごとの同等のもの) Memory_limit と実行時間を増やす
• cronをインストールして実行する (Magento の非同期一括インポートはコンシューマー キューを使用します)
• SSHアクセス ビン/マゼント CLIコマンド
• 十分なディスクヘッドルーム var/import/images 最大のバッチを 2 回保持できる (Magento のコピー, 動かない)

現在のホストがそれらを配信できない場合, 輸入業者はあなたの本当の問題ではありません. 私たちの Magento VPS ホスティングのまとめ 追加料金なしで 2.4.8 対応スタックを出荷しているプロバイダを分類します。, そしてその ホスティング検索ツール PHPバージョンによるフィルター, 羊, プランを並べて比較する場合は、コントロール パネルを使用します。. Magento と並行して WooCommerce を運営している販売者向け (それはあなたが思っている以上に起こります), the WordPress eコマースホスティングガイド クロスオーバースタックをカバーします.

よくある質問

Magento にインポートできる CSV ファイルの最大サイズはどれくらいですか? 2.4.8?

管理インポーターはアップロードの上限を次のとおりに設定します。 2デフォルトでは MB, PHP によって制御される アップロード_最大ファイルサイズ と post_max_size. より大きなファイルの場合は、php.ini で両方を 64M に上げます. 圧縮された 50MB を超えるものについては、, RESTに切り替える /V1/インポート/CSV 終点, gzip で圧縮されたペイロードを処理し、ブラウザのアップロードのボトルネックになりません.

Magento に製品をインポートできますか 2 CSVを使わずに?

はい. Magento 2.4.8 の REST API は、CSV と JSON の両方を次のように受け入れます。 /V1/インポート/json. サードパーティの拡張機能 (ファイアベア, アマスティ, 古いインストール用の Magmi) XMLをサポート, Google スプレッドシートの同期, および直接ERPコネクタ. ネイティブ管理者には引き続き CSV が必要です, 自動化のニーズに基づいてパスを選択してください.

10,000 個の製品のインポートにはどのくらい時間がかかりますか?

調子に乗って 2.4.8 スタック (8 GB RAM, NVMe, PHP 8.4, MariaDB 11.4), 期待する 15-25 分 画像を含む 10,000 行のインポートの場合. 共有ホスティングはこれを後押しします 60+ 完了する場合は数分. 非同期 REST バルク パスはバックグラウンドで実行されます, インポート中も買い物客向けページの応答性を維持できるようにする.

インポートは成功したのに、間違った価格や在庫が表示されるのはなぜですか?

よくある 2 つの原因. 初め, CSV の末尾に空白またはヨーロッパのカンマ 10 進数形式が含まれています (1,99 の代わりに 1.99) 価格欄に; Magento はこれらを無効として解析し、古い値を保持します. 2番, マルチソースインベントリ (MSI) の 2.4.8 ソースごとに数量を保管します, 世界中の製品ごとではありません, だからあなたは必要があります ソースコード 列またはインポートではデフォルトのソースのみが更新されます.

インポートする前に Magento フラット カタログを無効にする必要がありますか??

フラット カタログは で非推奨になりました 2.3 によってデフォルトのワークフローから削除されました 2.4.5. ストアで何らかの理由でまだ有効になっている場合, 以下で無効にします 店舗 > 構成 > カタログ > 店先 大量輸入の前に. それは常にパフォーマンス責任であり、 2.4.8 これを管理者に明示します.

ERP または PIM からの製品インポートを自動化できますか?

まさにそれが、 2.4.8 REST エンドポイントの目的は、. Akeneoのようなツール, ピムコア, Salsify と Salsify はネイティブ Magento を持っています 2 コネクタ. カスタムビルドの場合, cron ERP フィードを取得するスクリプト, CSVに変換します, gzip, そしてPOST /V1/インポート/CSV. インポートが多い場合はオフピーク時間にスケジュールを設定する.

最後のメモ

次回のインポートが機能するかどうかを決定する 2 つのルール. 1つ: CSV を BOM なしの UTF-8 として保存します. いつも. 二: PHPを上げる メモリ制限 と 最大実行時間 始める前に, 最初のクラッシュの後ではない. それ以外は詳細です.

経路的に, 電話は簡単です. 下 5,000 SKU と時々インポートを実行する? 管理CSVツールを使用する. 過去 10,000 SKU または ERP からの毎晩の同期? RESTを使用する /V1/インポート/CSV エンドポイントが追加されました 2.4.8 プロセスの子守をやめてください. 置換または削除を実行する前にデータベースをバックアップします。. インポート中はブラウザのタブを決して閉じないでください. そして、その下にあるスタックが耐えられない場合は、, それを救う輸入業者の戦術はない. まずホストを修正してください.

関連する読書用: the Magentoテーマのまとめ カタログがロードされた後のフロントエンドのパフォーマンスをカバーします, 上にリンクされている Speed Playbook はキャッシュ スタックを処理します, ホスティング ガイドには、すべてを実行する対象が記載されています. 退屈なインフラストラクチャの選択は、単一の機能フラグよりも速く複合化します.