Shopify スクリプトからShopify Functionsに移行する

Shopify FunctionsはShopify スクリプトと類似しており、開発者はカスタムコマースエクスペリエンスを作成できます。

Shopify Functions

Shopify Functionsは、アプリの一部としてインストールされます。Shopify Functionsは、他の機能と一緒に管理画面に直接設定されています。つまり、マーチャントはカスタマイズを作成または変更する際にコードを使用する必要はありません。Shopify Functionsを実行するWebAssemblyプラットフォームは、Shopify スクリプトよりもパフォーマンスが高く、5分未満でコードを実行します。そのため、フラッシュセールなどの大規模な販売イベントにも、パフォーマンスを低下させることなく対応できます。

Shopify Functionsを使用すると、開発者は自分のローカル環境でコーディングおよび単体テストを実行できます。開発者は、Shopify Functionsのカスタマイズをアプリの一部として配布できます。Rubyのコードを各ストアにコピー&ペーストする必要はありません。また、Shopify Functionsを使用すると、タイムアウトとCPUメモリ制限の問題を軽減できます。

Shopify スクリプトのカスタマイズレポートを使用して Shopify Functionsに移行する

Shopify スクリプトのカスタマイズレポートは、管理画面のパーソナライズされたページで、ストアでアクティブな既存のスクリプトのカスタマイズが表示され、カスタマイズを再作成するのに役立つShopify Functionsドキュメントや関連するアプリリンクが提供されます。

Shopify スクリプトのカスタマイズレポートは自動的に生成されます。レポートをエクスポートしてCSVファイルとして表示することもできます。2025年8月28日までに、Shopify Functionsを使用してカスタマイズを再作成する必要があります。

カスタマイズを確認する

ご使用のスクリプトによっては、レポートページに決済ゲートウェイサービス、配送、商品ディスカウントカスタマイズのセクションが含まれる場合があります。

各セクションには、Shopify スクリプトカスタマイズの名前、説明、ソースファイルのリンク、Shopify Functionsで構築され、カスタマイズに特化した推奨アプリへのリンク、そしてShopify Functionsチュートリアルへのリンクが含まれる場合があります。

レポートの情報を確認し、次のオプションを使用してカスタマイズを再作成するかどうかを決定します。

Shopify Functionsを使用して独自のソリューションを構築する
Shopify Functionsで構築されたアプリをインストールする

カスタマイズを再作成する

管理画面で、[設定] > [アプリと販売チャネル] の順に移動します。
[Script Editor] をクリックします。
[Shopify スクリプトの置き換え] バナーで、[Shopify スクリプトの置き換え] をクリックします。
カスタマイズレポートの各セクションで、次のいずれかの操作を実行します。
- 既存のShopify スクリプトのカスタマイズを表示するには、自動検出されたカスタマイズの数の下にあるスクリプトの名前をクリックします。
- スクリプトに一致する互換性のあるアプリを表示またはインストールするには、[推奨アプリ] セクションで、使用するアプリの [インストール] をクリックするか、[これに類似するその他のアプリ] をクリックして他の互換性のあるアプリを見つけます。
- Shopify Functionsチュートリアルを表示するには、[Shopify Functionsを使用して再作成する方法] セクションで、関連する関数APIリンクをクリックします。

アプリまたはShopify Functionsのカスタマイズでテストが正常に完了したら、置き換えるスクリプトを非アクティブ化できます。

Shopify スクリプトとShopify Functionsを併用する

Shopifyスクリプトでは、checkout.liquidでカスタマイズされたチェックアウトおよびアップグレードされたチェックアウト機能は2025年8月28日まで引き続き動作します。

Shopify スクリプトとShopify Functionsは、1つのストアで併用できます。現在、Shopify Functionsでスクリプトを置き換えられない場合は、Shopify Functions APIがニーズを満たすまで、Shopify スクリプトを引き続きご使用ください。Shopify スクリプトとShopify Functionsの相互作用については、以下を参照してください。

項目スクリプト

項目スクリプトは、Shopify Functions (アプリで作成されたディスカウントを含む) よりも前に実行されます。項目スクリプトは、機能とアプリによってディスカウントされた金額にはアクセスできません。

スクリプトは、チェックアウトに適用された最初のクーポンコードにのみアクセスできます。使用された可能性がある他のクーポンコードにはアクセスできません。たとえば、rejectを使用すると、チェックアウトに適用された最初のディスカウントには機能しますが、他のディスカウントは影響を受けません。

配送スクリプト

配送スクリプトは、Shopify Functionsによる配達のカスタマイズ後に実行されます。スクリプトは、配達のカスタマイズによって名前が変更された場合は動作しませんが、カスタマイズの影響が移動または非表示に限定される場合は機能します。

決済スクリプト

決済スクリプトは、Shopify Functionsによる決済のカスタマイズ後に実行されます。スクリプトは、決済のカスタマイズによって名前が変更された場合は動作しませんが、カスタマイズの影響が移動または非表示に限定される場合は機能します。