Shopify から移行

Shopify ストアの商品、顧客、在庫、配送、割引を、1 回の読み取り専用インポートで Runner ストアにコピーします。

このガイドの内容：Shopify ストアのデータを既存の Runner ストアにコピーし、結果を確認し、修正が必要なときは再度インポートします。

ストア移行は、1 回限りの読み取り専用のコピーです。Runner は Shopify ストアを読み取り、見つけたデータを Runner ストアに書き込みます。Shopify 側は何も変更されず、インポート中も Shopify ストアでの販売は続きます。

移行する理由と時期

ストアを Runner に移し、既存のカタログ、顧客、設定を入力し直さずにそのまま使いたい場合に移行を使用します。

移行は Shopify ストアを接続 とは異なります。接続では Shopify がストアのシステムのまま残るため、チェックアウトも Shopify で行われます。移行ではデータを 1 回だけ Runner ストアにコピーし、その後 Runner ストアは単独で動作します。インポート後、Runner は 2 つのストアを同期しません。

利用可能性と前提条件

• ワークスペースで 移行 が利用可能である必要があります。
• ワークスペースで オーナー または 管理者 のロールが必要です。他のメンバーには入口が表示されず、Runner は 移行を変更または開始できるのは、ストア所有者または管理者だけです。 と表示してインポートを拒否します。
• Shopify に接続されたプロジェクトではなく、Runner ストアにインポートします。Runner ストアがない場合は、先に Runner ストアを作成 してください。
• ストアのセットアップが完了するまで待ちます。完了するまで、Runner は ストアはまだ準備中です。設定が完了すると、アップロードが自動的に利用可能になります。 と表示し、続行 を使用できない状態にします。
• Shopify を接続 を使う場合は、ストアを所有する組織の Shopify アカウントが必要です。このアカウントには、アプリを開発してそのストアにインストールする権限が必要です。
• CSV エクスポートをアップロード を使う場合は、Shopify 管理画面から商品、顧客、割引をエクスポートできるアクセス権が必要です。
• 1 つのストアで同時に実行できるインポートは 1 つだけです。

移行を開く

エントリパス：プロジェクトを開く → トップバー → 移行

スマートフォンでは、トップバーの 2 本の矢印のアイコンを選択するか、空のチャットで Shopify から移行 を選択します。

インポートの実行中は、ボタンに Shopify からインポート中 と進捗率が表示されます。インポートの終了後 24 時間は、インポート完了・レポートを見る または インポートに対応が必要です と表示されます。ボタンを選択すると、中断したところからインポートを再び開きます。実行中のインポートは進行状況が、完了したインポートはレポートが開きます。

Runner がストアを読み取る方法を選ぶ

英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。

可能であれば Shopify を接続 を選んでください。エクスポートよりも多くのストアデータを読み取れ、後で繰り返すときもファイルを再度エクスポートする必要がありません。

移行されるものと Shopify に残るもの

インポートは次の順序で段階的に実行されます。

商品の写真は Shopify の画像アドレスのまま残ります。Runner はそれらにリンクし、ファイル自体はコピーしません。商品の段階の後、Runner はリンクを確認し、開けない写真を一覧にします。商品の写真を引き続き表示できるように、Shopify ストアを閉じる前に Runner サポートに連絡してください。

Shopify に残るもの には、インポートで移行されない各項目と、代わりに行うことが一覧表示されます。

Runner は、近似した割引や配送ルールを有効にすることはありません。Runner で同じように動作しないルールはスキップされ、レポートに記載されます。インポート後に割引と配送料を比較してください。

Shopify を接続

Shopify ストアを接続 には 4 つのステップがあります。Shopify で各ステップを終えたら、完了としてマークしてください。後続のステップが順に開放されます。Shopify で作業している間も、Runner のタブは開いたままにしてください。

ステップ 1：ストアを見つける

1. ストアを見つける (1) に、ストア名、.myshopify.com のアドレス、または Shopify 管理画面のリンクを貼り付けます。Runner は使用するアドレスを、Runner は meridian-goods.myshopify.com を使います のように表示します。
2. 続行 (2) を選択します。

meridian-goods.com のような独自ドメインを入力することもできます。続行すると、Runner がその .myshopify.com のアドレスを調べます。Runner がストアを見つけると、見出しが 接続 とストア名に変わります。別のストアを使うには、アドレスの横の 変更 を選択します。Runner は下書きを破棄し、Shopify 側は何も変更されません。

ステップ 2：Dev Dashboard でアプリを作成

1. Dev Dashboard を開く を選択します。ストアを所有する同じ Shopify 組織の販売者アカウントでサインインします。
2. Apps を開き、Create app から Create app manually を選択します。アプリには任意の名前を付けます。Shopify CLI は必要ありません。
3. Runner に戻り、アプリを作成しました を選択します。

別の Shopify 組織が所有するアプリは使用できません。Shopify セットアップガイド、必要なユーザーアクセス、同一組織であること のリンクから、Shopify 自身の手順が開きます。

ステップ 3：読み取り専用のスコープを追加し、リリースしてインストールする

1. スコープをコピー (1) を選択します。Runner は 15 個のスコープすべてを、カンマ区切りの 1 つのリストとしてコピーします。
2. Shopify の Create an app ページで、Scopes にリスト全体を貼り付け、Create app、続いて Release を選択します。アプリがすでにある場合は、Versions を開いて Create version を選び、リストを Scopes に貼り付けて Release を選択します。
3. アプリの Overview に Distribution カードが表示されている場合は、開いて Custom distribution を選択します。これを行わないと、Shopify は顧客レコードをアプリに共有しません。ストア自身の組織で作成したアプリには Distribution カードがなく、この手順は不要です。Shopify の配布ガイド (2) から Shopify の手順が開きます。
4. アプリの概要ページで、インストール カードの アプリをインストール を使用します。ストアを選択し、読み取り専用の権限を確認して インストール を選択します。Shopify から未審査のアプリであるという警告が表示されますが、自分で作成したアプリでは想定どおりです。
5. Runner に戻り、追加してインストールしました (3) を選択します。

スコープは読み取り専用です。Runner が求めるのは、次のスコープだけです。

read_customers,read_discounts,read_files,read_inventory,read_locales,read_locations,read_markets,read_metaobject_definitions,read_metaobjects,read_price_rules,read_product_feeds,read_product_listings,read_products,read_publications,read_shipping

後でスコープを変更した場合は、Runner に戻る前に新しいバージョンをリリースし、アプリを再インストールしてください。

ステップ 4：Client ID とシークレットを貼り付ける

1. Dev Dashboard で Apps を開き、Runner 用に作成したアプリを開きます。
2. 設定 を選択し、認証情報 を開きます。Client ID をコピーし、シークレットの横の 表示 を選択してそれもコピーします。
3. Runner で、それぞれを Client ID (1) と Client Secret (2) に貼り付けます。
4. 認証情報を確認 (3) を選択します。確認には数秒かかります。

シークレットは shpss_ で始まります。shpat_ で始まる値はアクセストークンで、シークレットではありません。2 つの値を逆のフィールドに貼り付けた場合、Runner は 入れ替える を表示します。どこで確認できますか？ (4) を選択すると、フォームの横にこれらの手順が表示されます。

Runner は確認済みの認証情報を暗号化し、同じストアからの以降のインポートで再利用するため、貼り付けるのは 1 回だけです。別の認証情報を使うには、認証情報を置き換える を選択します。

インポートを開始する

認証情報が受け付けられると (1)、左側のパネルに、Runner がストアから読み取った内容の概要が表示されます。商品の写真と、商品、顧客、コレクション、割引の数です。この時点ではまだ何もインポートされません。

インポートを開始 (2) を選択します。フッターには、インポートを開始: 商品 148 件、顧客 1,240 件、ディスカウント 27 件 のように、取り込まれる内容の概要が表示されます。

Shopify が認証情報を受け付けても、アプリに配送または割引のスコープがない場合、Runner は 不足: と足りないスコープを表示します。スコープを追加して もう一度確認 を選択するか、それらなしでインポート を選択して該当する段階だけをスキップします。それ以外のスコープが不足している場合は、追加するまでインポートできません。

CSV エクスポートをアップロード

Shopify でアプリを作成できない場合に、この方法を使用します。CSV エクスポートで取り込めるデータは Shopify を接続 より少なくなります。コレクションは取り込まれず、インポートできるのはファイルに含まれる内容だけです。

Shopify からファイルをエクスポートする

各ファイルの入手場所 にエクスポートの一覧が表示されます。1 つを選択すると手順が表示されます (2)。Shopify 管理画面を開く (3) でエクスポートし、ファイルを選択 (4) で追加します。ドロップゾーン (1) にファイルをドロップすることもできます。

ファイルは任意の順序、任意のファイル名で追加できます。Runner が受け付けるのは CSV のみで、1 ファイルあたり 25 MB、500,000 行までです。それより大きいエクスポートは、Shopify で絞り込んで分割し、すべてのファイルを追加してください。

ファイルを確認してからインポートする

Runner は、インポートを始める前に各ファイルを読み取り、見つけた内容を表示します。

インポート (4) を選択します。ボタンには、2 件のファイルをインポート のように準備完了のファイル数が表示されます。除外されるファイルがある場合、Runner は開始前に確認を求めます。除外したファイルは後から追加できます。

インポートせずに離れるには、キャンセル を選択し、インポートせずに終了しますか？ で 終了する を選択します。追加したファイルは、戻ってきたときのために下書きに残ります。下書きを破棄 を選択するとアップロードしたファイルが削除されます。Shopify 側は何も変更されません。

インポートを追跡する

進行状況ビューのタイトルにはストア名が入り（例：Meridian Goods を引っ越し中）、各段階が件数とともに表示されます。実行中の段階 (1) には、512 / 1,240 のように完了したレコード数が表示されます。インポートは通常数分で終わります。

CSV インポート中は、ファイルを追加 でまだ不足しているエクスポートを追加できます。追加したファイルは、すでに実行中の段階の後にインポートされ、同じレポートに含まれます。

結果を確認する

インポートが完了すると、Runner はストア名を含む完了メッセージ（例：Meridian Goods の引っ越しが完了しました。）を表示し、取り込まれた商品、顧客、割引の数、修正が必要なレコードの数、Shopify に残ったものの数を示します。

• ストアフロントを構築 (1) を選択すると、現在のサイトの見た目を再現するよう Runner に依頼する新しいチャットが開きます。
• レポートを見る、または修正が必要なレコードがある場合は {count} 件を確認 (2) を選択すると、インポートレポートが開きます。

インポートレポートには、取り込まれたレコードの数と、各 Shopify レコードの移行先が表示されます。

レポートの各レコードには、追加済み、更新済み、変更なし、Runner のバージョンを維持、スキップ、要確認、インポートできませんでした のいずれかの結果が付きます。ハンドルがすでに使用されている商品など、Runner がインポートできなかったレコードには理由が表示されます。Shopify で修正してから、再度インポートしてください。

レポートには Shopify に残ったもの も一覧表示され、Runner で作り直すものには チャットでコレクションを作成し直す などのチャットアクションが用意されています。

再度インポートする

Shopify でレコードを修正したり商品を追加したりした後など、同じストアはいつでも再度インポートできます。Shopify を接続 の場合、Runner は保存済みの認証情報を再利用し、ボタンは ストアを更新 と表示されます。

• 重複しません。 Runner はインポートした各レコードを記憶しています。新しいインポートでは、新たにレコードを作成せず、対応する Runner のレコードを更新します。
• 変更のないレコードはそのままです。 Shopify のレコードも Runner のコピーも変更されていない場合、レポートには 変更なし と表示されます。
• Runner での編集は保持されます。 Runner でレコードを編集し、Shopify 側では変更されていない場合、レポートには Runner のバージョンを維持 と表示されます。両方が変更されている場合は、新しい方が優先されます。
• 何も削除されません。 Shopify で削除したレコードも Runner には残ります。
• CSV と Shopify の接続では、互いのレコードは照合されません。 CSV エクスポートでインポートした後に Shopify を接続 でインポートすると、一部のレコードが重複して取り込まれることがあります。インポート後に重複がないか確認してください。

トラブルシューティング

メッセージと復旧手順の一覧については、Shopify migration and import errors を参照してください。問題が解決しない場合は、ストア名、停止した段階、Runner に表示されるインポート ID を添えて Runner サポートに連絡してください。

関連ガイド

• Shopify ストアを接続
• CSV テンプレートから商品をインポート
• 商品
• プロモーション
• 配送
• ストア運営の概要