アプリ埋め込みを有効にして、有効化の状態を確認する

読了時間： 5 分。 最終更新： 2026年6月20日 対象： 見積を依頼するボタンがまだ表示されないマーチャント、そして初めてQuotWayを設定していて、すべてのストアフロントの画面が動作していることを確認したい方。

QuotWayのボタンがストアフロントに現れる前に、二つのことが成り立っている必要があります。テーマでアプリ埋め込みが有効であることと、必要なブロックが配置されていることです。アプリ埋め込みは実行の土台です。QuotWayのストアフロントのスクリプトを読み込み、ボタン、見積の入力欄、価格の非表示が機能できるようにします。この記事では、埋め込みを有効にする方法、有効化の状態の画面の読み方、そして各画面についての「配置済み」と「有効」の意味を説明します。ボタンが表示されない場合は、ここから始めてください。最もよくある解決策です。

何が達成できるか

最後には、アプリ埋め込みが有効になり、利用している画面について有効化の状態が緑になり、変更のたびに再確認する方法が分かるようになります。

始める前に

• QuotWayがShopifyの管理画面にインストールされていること。
• Online Store 2.0のテーマを使っていること（Dawn、Horizon、そして最近のテーマの多くが該当します）。アプリ埋め込みはテーマエディターから有効にします。テーマのコードの編集は不要です。

手順1 - アプリ埋め込みを有効にする

1. QuotWayの管理画面から設定 → 有効化を開き、アプリ埋め込みを有効にするを選びます。（または Shopifyの管理画面 → オンラインストア → テーマ → カスタマイズ → アプリ埋め込みへ行きます。）
2. テーマエディターのアプリ埋め込みの欄で QuotWay を見つけ、切り替えを有効にします。
3. 保存を選びます。

アプリ埋め込みは、ストアフロントのページごとに一度読み込まれます。これが無効だと、ブロックをどう配置していても、QuotWayのボタンも入力欄もどこにも描画されません。ですから、常に最初に確認すべきところです。

手順2 - 有効化の状態の画面を読み取る

QuotWayの管理画面で設定 → 有効化を開きます。画面の表に、QuotWayが現れ得るすべての場所が、その時点の状態の表示とともに列挙され、まだ作業が必要な場合は設定の操作が示されます。QuotWayは公開中のテーマをその場で調べるため、表示は意図ではなく実際に動作しているものを反映します。

画面	状態の意味
アプリ埋め込み	有効（緑）は、実行の土台が公開中のテーマに読み込まれていることを意味します。無効（黄）は有効にする必要があることを意味します。そうするまで他は何も機能しません。
見積ボタンのブロック（商品ページ）	配置済み（緑）は、QuotWay Quote Button のブロックが商品のテンプレートに追加されていることを意味します。未配置（黄）では見積ボタンを追加の操作が表示されます。
カートの見積ブロック（カートページ）	配置済み（緑）は、QuotWay Cart Quote Button がカートのテンプレートにあることを意味します。未配置（任意）（中立）- カートページのブロックは任意なので、警告ではなく中立のままです。
顧客アカウントのUI拡張	新しい顧客アカウントに マイ見積 のブロックが配置されると有効（緑）になります。ストアが新しい顧客アカウントを使っていてブロックがまだ配置されていない場合は、設定を完了する操作が表示されます。従来のアカウントでは、バイヤーはホスト型ポータルへ振り分けられます。
ホスト型ポータル	設定済み（緑）- 常に利用できます。バイヤーは設定なしに、安全なリンクから自分の見積に到達します。
バイヤーの経路の準備状況	まとめの表示です。アプリ埋め込みが有効でかつ商品の見積ボタンのブロックが配置されると準備完了（緑）になります。バイヤーがストアフロントから見積を依頼するための最低限です。

「配置済み」と「有効」の意味

• 有効はアプリ埋め込みについての表現です。実行の土台が有効になり、テーマに読み込まれています。
• 配置済みはブロックについての表現です。テーマエディターでテンプレートに追加し、保存したという意味です。
• 画面が完全に緑になるのは、その両方が当てはまるときだけです。商品のボタンでは、埋め込みが有効で、かつブロックが配置済みである必要があります。

ミニカート（引き出し）のボタンと商品カードのボタンは、この表に別の「配置済み」の行としては現れません。アプリ埋め込みによって自動的に挿入されるからです（引き出しとカードはテーマのブロックを持てません）。ですから配置するものがありません。カートとミニカートの見積ボタンをご覧ください。

手順3 - 変更の後に再確認する

QuotWayのタブやウィンドウに戻るたびに、この画面はテーマを自動的に調べ直します。ですから通常の流れはこうです。テーマエディターを新しいタブで開き、変更を加え、戻ってきて、表示が緑に変わるのを見ます。

ストアの構成を変えた後で表示が古いままに見える場合（たとえばQuotWayのインストールの後にShopify BtoBを有効にした場合）は、設定 → 有効化 → 再確認を使い、QuotWayにストアを検出し直させ、すべての画面を更新させてください。

よくある落とし穴

• すべてが黄色で、ボタンが表示されない。 アプリ埋め込みが無効です。有効にしてください（手順1）。これが他のすべての画面の前提です。
• 埋め込みは有効なのに、商品のボタンが「未配置」。 QuotWay Quote Button のブロックを商品のテンプレートに追加してください。見積ボタンの配置をご覧ください。
• 画面は緑なのに、バイヤーにボタンが見えない。 ボタンは、有効な対象の指定ルールに合致する商品とバイヤーにのみ表示されます。ルールを確認してください。対象の指定ルールをご覧ください。
• テーマを変えたのに表示が更新されない。 この画面はタブに戻ったときに更新されます。それでも古いままなら、再確認をお使いください。

関連記事

• 見積ボタンの配置 - テーマエディターで商品とカートのブロックを追加します。
• カートとミニカートの見積ボタン - カートページのブロックと、自動的に挿入される引き出しのボタンです。
• 対象の指定ルール - すべてが有効になった後、どの商品とどのバイヤーにボタンを見せるかを決めます。